prometheus通过webhook推送告警至钉钉

缺乏、安全感 2022-05-14 14:48 494阅读 0赞

注意 ：二当家 在安装使用过程发现使用prometheus 结合叮叮推送

遇到了一些坑 这里记录一下 大家可以规避一下

1 所在的linux 服务器要安装golang环境 老铁们自己要先装一下

参考 [https://blog.csdn.net/AlbertFly/article/details/83414713][https_blog.csdn.net_AlbertFly_article_details_83414713]

我是折腾了一会才发现 因为make过不去 另外还要装git

我在使用叮叮参考了[http://www.cnblogs.com/pyuh/articles/9544121.html][http_www.cnblogs.com_pyuh_articles_9544121.html] （大家仔细看看）

2 其中没有提到  并且叮叮的git文件拉下来后要放入go的环境变量

[https://blog.csdn.net/AlbertFly/article/details/83414713][https_blog.csdn.net_AlbertFly_article_details_83414713]

export GOROOT=/usr/local/go  
export PATH=$PATH:$GOROOT/bin  
\#$HOME = /usr/local/soft/go  
export GOPATH=$HOME/gopath

要放入GOROOT下面  这个目录自己创建一下

在当前目录make会生成如下图的红框的可执行文件

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FsYmVydEZseQ_size_27_color_FFFFFF_t_70][]

效果图

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FsYmVydEZseQ_size_27_color_FFFFFF_t_70 1][]

以下转载:

转载:

[http://www.cnblogs.com/pyuh/articles/9544121.html][http_www.cnblogs.com_pyuh_articles_9544121.html] **重要**

[http://theo.im/blog/2017/10/16/release-prometheus-alertmanager-webhook-for-dingtalk/][http_theo.im_blog_2017_10_16_release-prometheus-alertmanager-webhook-for-dingtalk]

# 将钉钉接入 Prometheus AlertManager WebHook #

## TL;DR ##

**Disclaimer**: Personally I dislike [DingTalk][](a.k.a DingDing) at all ?.

Project Repo: [https://github.com/timonwong/prometheus-webhook-dingtalk][https_github.com_timonwong_prometheus-webhook-dingtalk]

## Why ##

在敝人的「忽悠」下，敝厂在 2016 年中就全面使用了 [Prometheus][] 作为监控系统，这个系统现在已经比较火了，这里就不再多加口舌阐述。后来，敝厂使用了钉钉作为公司内部的指定通（dă）讯（kă）软件，取代了 [Slack][]。不得不说，比起 [Slack][] 来，显示报警通知，钉钉不美观。

按照我个人的看法，一个合格的报警通知，应该包含如下内容：

*  报警级别
 *  简短的报警名称
 *  简要说明
 *  详细说明
 *  附加上下文信息
 *  一个链接，点击后进入指标的 Graph

幸运的是，[Prometheus][Prometheus 1] 已经包含了一个做得比较好的 [Slack][] 报警模板，只需要从[这里][Link 1]开始就可以了。

## Routes ##

`prometheus-webhook-dingtalk` 默认监听在`8060`端口（可配置）上，提供了以下路由供 [AlertManager][Prometheus 1] 的 [webhook\_configs][webhook_configs] 使用：

* `/dingtalk/<profile>/send`

注意这里的 `<profile>` 需要在 `-ding.profile` 中指定相应的名称（`<profile>`）以及钉钉的自定义机器人 WebHook URL（`<dingtalk-webhook-url>`）。

## Usage ##

首先，我个人不喜欢随处都是配置文件的现象，因此 `prometheus-webhook-dingtalk` 的所有配置通过命令行参数完成:

<table> 
 <tbody> 
 <tr> 
 <td> <pre>
<code>&nbsp;</code></pre> 1 2 3 4 5 6 7 8 9 10 11 </td> 
 <td> <pre>
<code>&nbsp;</code></pre> usage: prometheus-webhook-dingtalk --ding.profile=DING.PROFILE [&lt;flags&gt;] Flags: -h, --help Show context-sensitive help (also try --help-long and --help-man). --web.listen-address=":8060" The address to listen on for web interface. --ding.profile=DING.PROFILE ... Custom DingTalk profile (can specify multiple times, &lt;profile&gt;=&lt;dingtalk-url&gt;). --ding.timeout=5s Timeout for invoking DingTalk webhook. --log.level=info Only log messages with the given severity or above. One of: [debug, info, warn, error] --version Show application version. </td> 
 </tr> 
 </tbody> 
</table>

关于这里的 `-ding.profile` 参数：为了支持同时往多个钉钉自定义机器人发送报警消息，因此 `-ding.profile` 可以在命令行中指定多次，比如:

<table> 
 <tbody> 
 <tr> 
 <td> <pre>
<code>&nbsp;</code></pre> 1 2 3 </td> 
 <td> <pre>
<code>&nbsp;</code></pre> prometheus-webhook-dingtalk \ --ding.profile="webhook1=https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxxxxxx" \ --ding.profile="webhook2=https://oapi.dingtalk.com/robot/send?access_token=yyyyyyyyyyy" </td> 
 </tr> 
 </tbody> 
</table>

这里就定义了两个 WebHook，一个 `webhook1`，一个 `webhook2`，用来往不同的钉钉组发送报警消息。

然后在 [AlertManager][Prometheus 1] 的配置里面，加入相应的 `receiver`（注意下面的 `url`）即可：

<table> 
 <tbody> 
 <tr> 
 <td> <pre>
<code>&nbsp;</code></pre> 1 2 3 4 5 6 7 8 9 </td> 
 <td> <pre>
<code>&nbsp;</code></pre> receivers: - name: send_to_dingding_webhook1 webhook_configs: - send_resolved: false url: http://localhost:8060/dingtalk/webhook1/send - name: send_to_dingding_webhook2 webhook_configs: - send_resolved: false url: http://localhost:8060/dingtalk/webhook2/send </td> 
 </tr> 
 </tbody> 
</table>

### In Action ###

参见官方文章：[https://open-doc.dingtalk.com/docs/doc.htm?treeId=257&articleId=105735&docType=1][https_open-doc.dingtalk.com_docs_doc.htm_treeId_257_articleId_105735_docType_1]，然后将 webhook 地址拷贝下来，传给 `prometheus-webhook-dingtalk`。

最后，来个截图看看效果吧：

[![2016-10-16-dingtalk-in-action.png][]][2016-10-16-dingtalk-in-action.png]

参考 : [https://blog.csdn.net/u010871982/article/details/79229953?utm\_source=blogxgwz8][https_blog.csdn.net_u010871982_article_details_79229953_utm_source_blogxgwz8]

Prometheus  
添加钉钉机器人，获取webhook  
下载插件并编译（不会编译的也可以直接下载编译好的二进制文件）  
编辑启动脚本（请替换为自己的webhook URL 及 ding.profile）  
cat dingding\_start.sh

nohup /usr/local/alertmanager-0.8.0.linux-amd64/prometheus-webhook-dingtalk --ding.profile="ops\_dingding=https://oapi.dingtalk.com/robot/send?access\_token=11111111111"  --ding.profile="dev\_dingding=https://oapi.dingtalk.com/robot/send?access\_token=222222222222" 2>&1 1>/usr/local/alertmanager-0.8.0.linux-amd64/dingding.log &   
  
编辑alertmanager.yml，增加web\_hook配置并重启alertmanager  
\- name: "ops\_dingding"   
  webhook\_configs:  
    - send\_resolved: true   
      url: "http://localhost:8060/dingtalk/ops\_dingding/send"  
\- name: "dev\_dingding"  
  webhook\_configs:  
    - send\_resolved: true  
      url: "http://localhost:8060/dingtalk/dev\_dingding/send"

这两个字符串代表发往对两个叮叮群组的推送, 对应的token也是不同的

![70][]

[https_blog.csdn.net_AlbertFly_article_details_83414713]: https://blog.csdn.net/AlbertFly/article/details/83414713
[http_www.cnblogs.com_pyuh_articles_9544121.html]: http://www.cnblogs.com/pyuh/articles/9544121.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FsYmVydEZseQ_size_27_color_FFFFFF_t_70]: /images/20220504/fdc2afcbe9114c2bb4c6f358f13ace5c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FsYmVydEZseQ_size_27_color_FFFFFF_t_70 1]: /images/20220504/51cb08d3673c46b187e6f9a2a47526bd.png
[http_theo.im_blog_2017_10_16_release-prometheus-alertmanager-webhook-for-dingtalk]: http://theo.im/blog/2017/10/16/release-prometheus-alertmanager-webhook-for-dingtalk/
[DingTalk]: https://www.dingtalk.com/
[https_github.com_timonwong_prometheus-webhook-dingtalk]: https://github.com/timonwong/prometheus-webhook-dingtalk
[Prometheus]: https://prometheus.io/
[Slack]: https://slack.com/
[Prometheus 1]: https://github.com/prometheus/alertmanager
[Link 1]: https://github.com/prometheus/docs/blob/db2a09a8a7e193d6e474f37055908a6d432b88b5/content/docs/alerting/configuration.md#webhook_config
[webhook_configs]: https://prometheus.io/docs/alerting/configuration/#%3Cwebhook_config
[https_open-doc.dingtalk.com_docs_doc.htm_treeId_257_articleId_105735_docType_1]: https://open-doc.dingtalk.com/docs/doc.htm?treeId=257&articleId=105735&docType=1
[2016-10-16-dingtalk-in-action.png]: https://theo-im-1255089908.cos.ap-chengdu.myqcloud.com/images/2016-10-16-dingtalk-in-action.png
[https_blog.csdn.net_u010871982_article_details_79229953_utm_source_blogxgwz8]: https://blog.csdn.net/u010871982/article/details/79229953?utm_source=blogxgwz8
[70]: /images/20220504/8132d94b88a340869a539050c42b7846.png