> For the complete documentation index, see [llms.txt](https://feiyu563.gitbook.io/prometheusalert/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://feiyu563.gitbook.io/prometheusalert/system/system-go-template.md).

# ★ 进阶用法--go模版语法

***

PrometheusAlert的自定义模板基于go template而来，go template主要将json数据渲染成用户需要的文本

比如下面例子：

```
{
  "name": "张三",
  "age": 18,
  "teacher": ["TC1","TC2","TC3"],
  "like": {
    "balls": "football",
    "other": ["swim","climb"]
  }
}
```

比如我们现在需要在输出的文本（或者发送的消息文本）中要获取到json消息内的`name`、`age`、`teacher`，那么我们可以在模版内通过

```
用户名：{{.name}}
年龄：{{.age}}
老师：{{.teacher}}
```

模版中`{{}}`是模版取值的固定标记，`.`表示当前变量，渲染后输出的文本效果：

```
用户名：张三 年龄：18 老师：[TC1 TC2 TC3]
```

输出的结果似乎并不太美观，我们试着增加下换行，以及把各个老师的名字单独输出：

```
用户名：{{.name}}

年龄：{{.age}}

{{ range $k,$v:=.teacher }}
老师_{{$k}}：{{$v}}
{{end}}
```

渲染后的效果：

```
用户名：张三

年龄：18

老师_0：TC1

老师_1：TC2

老师_2：TC3
```

这里我们用到了比较简单的循环`{{range}}`(range可以遍历map`{}`、slice`[]`)

继续我们在试试只输出一位老师，比如仅输出TC2:

```
用户名：{{.name}}

年龄：{{.age}}

{{ range $k,$v:=.teacher }}
{{if eq $v "TC2"}}
老师_{{$k}}：{{$v}}
{{end}}
{{end}}
```

渲染后的效果：

```
用户名：张三

年龄：18

老师_1：TC2
```

这里我们使用了简单的判断，判断老师的名字是否是TC2，只有TC2的情况下，才会输出（一般可用于判断告警的状态）。

接着我们尝试把`like`做下处理：

```
用户名：{{.name}}

年龄：{{.age}}

{{ range $k,$v:=.teacher }}
{{if eq $v "TC2"}}
老师_{{$k}}：{{$v}}
{{end}}{{end}}
爱好：{{.like.balls}}
```

输出结果：

```
用户名：张三

年龄：18

老师_1：TC2

爱好：football
```

`{{.like.balls}}`这样的用法是取`like`下面的`balls`的值

如果要取`other`里面的`swim`，我们可以使用`{{index}}`函数，比如：

```
用户名：{{.name}}

年龄：{{.age}}

{{ range $k,$v:=.teacher }}
{{if eq $v "TC2"}}
老师_{{$k}}：{{$v}}
{{end}}{{end}}
爱好：{{index .like.other 0}}
```

输出结果：

```
用户名：张三

年龄：18

老师_1：TC2

爱好：swim
```

备注：原始的json通常都是各种告警系统或者WebHook系统主动发送给PrometheusAlert自定义模板接口，提取json可以去PrometheusAlert的日志中查看


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://feiyu563.gitbook.io/prometheusalert/system/system-go-template.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.