Update customtpl.md

Author: feiyu563

doc/readme/customtpl.md

@@ -1,16 +1,20 @@
-## 自定义告警消息模版使用说明
+# 自定义告警消息模版使用说明
 
 --------------------------------------
 
-自定义告警消息模版可以支持任意带有WebHook服务的系统接入到PrometheusAlert上。钉钉机器人、企业微信机器人均已经支持@某人的功能。使用时，需要在Url中加入`&at= 1539510xxxx`；如需添加多个@目标，用,号分割即可。此处需注意：钉钉@使用的是手机号码，企业微信机器人@使用的是用户帐号，具体可参考各自说明文档。
+自定义告警消息模版可以支持任意带有WebHook服务的系统接入到PrometheusAlert上。
 
-新增功能：url参数中 `ddurl、wxurl、fsurl、phone、email、wxuser、wxparty、wxtag、groupid `等可不写，如不写这些参数，则会默认去读取配置文件中的对应参数发送消息
+#### 钉钉机器人、企业微信机器人均已经支持@某人的功能。使用时，需要在Url中加入`&at= 1539510xxxx`；如需添加多个@目标，用,号分割即可。此处需注意：钉钉@使用的是手机号码，企业微信机器人@使用的是用户帐号。
 
-使用该功能需要使用者对go语言的template模版有一些初步了解，可以参考默认模版的一些语法来进行自定义。
+#### 新增功能：url参数中 `ddurl、wxurl、fsurl、phone、email、wxuser、wxparty、wxtag、groupid `等可不写，如不写这些参数，则会默认去读取配置文件中的对应参数发送消息
 
-模版数据等信息均存储在程序目录的下的`db/PrometheusAlertDB.db`中。
+#### 使用该功能需要使用者对go语言的template模版有一些初步了解，可以参考默认模版的一些语法来进行自定义。
 
-1.下面以添加Prometheus的自定义告警消息模版为例讲解如何添加自定义模版
+#### 模版数据等信息均存储在程序目录的下的`db/PrometheusAlertDB.db`中。
+
+## 自定义模板使用
+
+### 1.下面以添加Prometheus的自定义告警消息模版为例讲解如何添加自定义模版
 
 - 开始之前，请先临时更改你的Alertmanager的配置，将所有告警信息都转发到PrometheusAlert自定义接口,参考如下：
 
@@ -28,7 +32,7 @@ route:
 receivers:
 - name: 'PrometheusAlert'
   webhook_configs:
-  - url: 'http://[YOUR-PrometheusAlert-URL]/prometheusalert' #这里的配置仅在测试时使用，只是为了方便查看接收到的json消息，正式使用请更改为PrometheusAlert模版页面中显示的Url
+  - url: 'http://[YOUR-PrometheusAlert-URL]/prometheusalert?type=dd&tpl=prometheus-dingding' #这里的配置仅在测试时使用，只是为了方便查看接收到的json消息，正式使用请更改为PrometheusAlert模版页面中显示的Url
 ```
 
 配置完成后，重启或者reload Alertmanager，是配置生效。
@@ -39,7 +43,7 @@ receivers:
 2020/05/21 10:58:17.850 [D] [value.go:460]  [1590029897850034963] {"receiver":"prometheus-alert-center","status":"firing","alerts":[{"status":"firing","labels":{"alertname":"TargetDown","index":"1","instance":"example-1","job":"example","level":"2","service":"example"},"annotations":{"description":"target was down! example dev /example-1 was down for more than 120s.","level":"2","timestamp":"2020-05-21 02:58:07.829 +0000 UTC"},"startsAt":"2020-05-21T02:58:07.830216179Z","endsAt":"0001-01-01T00:00:00Z","generatorURL":"https://prometheus-alert-center/graph?g0.expr=up%7Bjob%21%3D%22kubernetes-pods%22%2Cjob%21%3D%22kubernetes-service-endpoints%22%7D+%21%3D+1\u0026g0.tab=1","fingerprint":"e2a5025853d4da64"}],"groupLabels":{"instance":"example-1"},"commonLabels":{"alertname":"TargetDown","index":"1","instance":"example-1","job":"example","level":"2","service":"example"},"commonAnnotations":{"description":"target was down! example dev /example-1 was down for more than 120s.","level":"2","timestamp":"2020-05-21 02:58:07.829 +0000 UTC"},"externalURL":"https://prometheus-alert-center","version":"4","groupKey":"{}/{job=~\"^(?:.*)$\"}:{instance=\"example-1\"}"}
 ```
 
-- 继续截取日志中的JSON内容，通过任意json格式化工具进行格式化如下：
+- 继续截取日志中的JSON内容，通过任意[json格式化工具](https://www.bejson.com/)进行格式化如下：
 
 ```
 {
@@ -110,7 +114,7 @@ receivers:
 * 添加完自定义模板后，主要一定要点击保存。
 
 ---------------------------------------------------------------------
-2.继续对新添加的模版进行测试
+### 2.继续对新添加的模版进行测试
 
 - 打开PrometheusAlert Dashboard的模版管理页面`AlertTemplate`
 
@@ -123,7 +127,7 @@ receivers:
 - 继续点击模版测试按钮即可对新添加的模版进行测试，如模版没有错误，将会收到对应的钉钉消息，如无法收到钉钉消息，请检查模版是否有什么地方配置错误
 
 ----------------------------------------------------------------------
-3.自定义告警消息模版接口使用非常简单
+### 3.自定义告警消息模版接口使用非常简单
 
 - 打开PrometheusAlert Dashboard的模版管理页面`AlertTemplate`
 
@@ -140,9 +144,9 @@ receivers:
 ![dashboard-tpl-list](https://gitee.com/feiyu563/PrometheusAlert/raw/master/doc/dashboard-tpl-list.png)
 
 ----------------------------------------------------------------------
-4.关于自定义模版函数
+## 4.关于自定义模版函数
 
-4.1 `GetCSTtime` 函数仅支持在PrometheusAlert的自定义模版中使用，该函数主要用于强制将时间字段时区从UTC转换到CST
+### 4.1 `GetCSTtime` 函数仅支持在PrometheusAlert的自定义模版中使用，该函数主要用于强制将时间字段时区从UTC转换到CST
 
 目前支持两种使用方式：
 
@@ -198,7 +202,7 @@ receivers:
 {{ end }}
 ```
 
-4.2 `TimeFormat` 函数仅支持在PrometheusAlert的自定义模版中使用，该函数主要用于格式化时间显示
+### 4.2 `TimeFormat` 函数仅支持在PrometheusAlert的自定义模版中使用，该函数主要用于格式化时间显示
 
 如下示例将prmetheus的告警时间格式改为：2006-01-02T15:04:05
 
@@ -226,7 +230,7 @@ receivers:
 {{ end }}
 ```
 
-4.3 `GetTime` 函数仅支持在PrometheusAlert的自定义模版中使用，该函数主要用于将`毫秒或秒`级时间戳转换为时间字符
+### 4.3 `GetTime` 函数仅支持在PrometheusAlert的自定义模版中使用，该函数主要用于将`毫秒或秒`级时间戳转换为时间字符
 
 目前支持两种使用方式：
 
@@ -270,4 +274,4 @@ preTriggerLevel: {{.PreTriggerLevel}}
 ruleId: {{.RuleId}}
 dimensions: {{.Dimensions}}
 **当前值：{{.CurValue}}**
-```
+```