grafana告警通知对接微信等其他方式方案

方案思路

分析

grafana支持修改配置文件关联Rabbitmq,并且使用grafana_event这个Exchange将grafana产生的事件消息分发给Rabbitmq中的队列,此处的grafana_evevnt是topic类型的Exchange。Rabbitmq根据routingKey负责将消息从exchange发送到对应绑定的queue中去,consumer只需从queue获取消息即可,工作流程大致如下图所示:


Rabbitmq工作流程

若能够将grafana产生的通知发送给Rabbitmq,之后就可以调用短信、微信等接口从消息队列中获取通知并发送,这就可以实现grafana告警对接其他的通知方式。由于目前grafana只支持将“组织创建、更新,用户创建、更新,用户注册开始、完成”事件消息发送给Rabbitmq,因此需要修改源码将通知发送给Rabbitmq。

方案

grafana每产生一条通知的时候会有将该条通知存入数据库的动作,此次方案选择在存入数据库后将这条通知抛给Rabbitmq。

实现

安装Rabbitmq

安装过程可参考Rabbitmq官方安装文档,因为本次是在Windows系统上操作的,所以以下介绍下Windows上的安装过程。

  1. 下载并安装Erlang:目前Rabbitmq3.6.x版本的需要19.X版本的Erlang,本次安装的Erlang是19.2版本的,下载OTP 19.2 Windows 64-bit Binary File,然后直接安装即可。

  2. 下载并安装Rabbitmq:下载rabbitmq-server-3.6.10.exe,然后直接安装即可。

  3. 添加环境变量,本次是默认安装:


    在系统变量中的Path中新增%RABBITMQ_SERVER%\sbin

  4. 启动Rabbitmq,点击“开始”,然后搜索“Rabbitmq”,双击出现的“Rabbitmq Service - start”启动服务。

  5. 开启管理插件:在Rabbitmq中的sbin目录下执行rabbitmq-plugins enable rabbitmq_management

  6. 浏览器访问http://localhost:15672/,默认用户名:guest,密码:guest。

补充

  • 安装路径不要出现中文字符、空格等。
  • 没有特殊要求最好采用默认安装。

修改grafana配置文件

在$GOPATH/src/github.com/grafana/grafana/conf/custom.ini文件中搜索“[event_publisher]”,然后改为如下图所示的样子:


修改配置

保存修改并重启grafana,然后刷新Rabbitmq管理界面就可看到有1个connection,如下图:


grafana连接Rabbitmq成功

开启Rabbitmq Trace插件

Trace是Rabbitmq用于记录每一次发送的消息,方便观察grafana抛给Rabbitmq的消息。
开启:rabbitmqctl trace_on
关闭:rabbitmqctl trace_off
具体可参考Rabbitmq Trace的使用

新建Rabbitmq队列

在Rabbitmq管理界面点击Queues,再点击Add a new queue添加队列,只需要填上必输项即可,Name可填其他字符,如下图所示:

添加队列

点击已添加的队列,进行Exchange与队列的绑定,如下如所示:

路由绑定

经过此步骤之后,Rabbitmq中的grafana_event Exchange会根据Routing key把匹配到的消息发送到该队列中。

修改grafana源码

$GOPATH\src\github.com\grafana\grafana\pkg\events\events.go文件中增加如下代码:

type Annotation struct {
    Id          int64 `json:"id"`
    OrgId       int64 `json:"orgId"`
    DashboardId int64 `json:"dashboardId"`
    PanelId     int64 `json:"panelId"`
    CategoryId  int64 `json:"categoryId"`
    RegionId    int64 `json:"regionId"`
    // Type        ItemType `json:"type"`
    Title     string `json:"title"`
    Text      string `json:"text"`
    Metric    string `json:"metric"`
    AlertId   int64  `json:"alertId"`
    UserId    int64  `json:"userId"`
    PrevState string `json:"prevState"`
    NewState  string `json:"newState"`
    Epoch     int64  `json:"epoch"`

    Data *simplejson.Json `json:"data"`
}

$GOPATH\src\github.com\grafana\grafana\pkg\services\sqlstore\annotation.go文件中做如下改动:

import (
    "bytes"
    "fmt"
    "strings"
 //导入events
    "github.com/grafana/grafana/pkg/events"
    "github.com/grafana/grafana/pkg/services/annotations"
)
func (r *SqlAnnotationRepo) Save(item *annotations.Item) error {
    return inTransaction(func(sess *DBSession) error {

        if _, err := sess.Table("annotation").Insert(item); err != nil {
            return err
        }
//将Annotation作为事件发送Rabbitmq
        sess.publishAfterCommit(&events.Annotation{
            Id:          item.Id,
            OrgId:       item.OrgId,
            DashboardId: item.DashboardId,
            PanelId:     item.PanelId,
            CategoryId:  item.CategoryId,
            RegionId:    item.RegionId,
            Title:       item.Title,
            Text:        item.Text,
            Metric:      item.Metric,
            AlertId:     item.AlertId,
            UserId:      item.UserId,
            PrevState:   item.PrevState,
            NewState:    item.NewState,
            Epoch:       item.Epoch,

            Data: item.Data,
        })
        return nil
    })
}

修改源码之后要重新编译grafana后端代码,然后重启grafana。

测试

在grafana中配置告警,当触发告警后,在Rabbitmq的队列中可看到消息概览图,如下图所示:

队列消息

由上图可知,当前已经有52条告警通知消息在队列中了,在Tace log中可看到相关的日志记录,如下面的两条:
这是一条OK状态(指标正常状态)的:

================================================================================
2017-07-12 3:38:41:010: Message published

Node:         rabbit@LAPTOP-AQ1VQEMH
Connection:   [::1]:50326 -> [::1]:5672
Virtual host: /
User:         guest
Channel:      1
Exchange:     grafana_events
Routing keys: [<<"INFO.Annotation">>]
Routed queues: [<<"Q1">>]
Properties:   [{<<"content_type">>,longstr,<<"application/json">>}]
Payload: 
{"event_type":"Annotation","priority":"INFO","timestamp":"2017-07-12T11:38:41.0089371+08:00","payload":{"id":70,"orgId":1,"dashboardId":7,"panelId":1,"categoryId":0,"regionId":0,"title":"redis_count alert","text":"OK","metric":"","alertId":4,"userId":0,"prevState":"alerting","newState":"ok","epoch":1499830720,"data":{}}}

这是一条处于alerting状态的:

================================================================================
2017-07-12 3:39:21:048: Message published

Node:         rabbit@LAPTOP-AQ1VQEMH
Connection:   [::1]:50326 -> [::1]:5672
Virtual host: /
User:         guest
Channel:      1
Exchange:     grafana_events
Routing keys: [<<"INFO.Annotation">>]
Routed queues: [<<"Q1">>]
Properties:   [{<<"content_type">>,longstr,<<"application/json">>}]
Payload: 
{"event_type":"Annotation","priority":"INFO","timestamp":"2017-07-12T11:39:21.0463949+08:00","payload":{"id":71,"orgId":1,"dashboardId":7,"panelId":1,"categoryId":0,"regionId":0,"title":"redis_count alert","text":"Alerting","metric":"","alertId":4,"userId":0,"prevState":"ok","newState":"alerting","epoch":1499830761,"data":{"evalMatches":[{"value":1578.9999999999998,"metric":"bosun.redis_count","tags":null}]}}}

队列中的消息为:

{"event_type":"Annotation","priority":"INFO","timestamp":"2017-07-12T11:38:41.0089371+08:00","payload":{"id":70,"orgId":1,"dashboardId":7,"panelId":1,"categoryId":0,"regionId":0,"title":"redis_count alert","text":"OK","metric":"","alertId":4,"userId":0,"prevState":"alerting","newState":"ok","epoch":1499830720,"data":{}}}
{"event_type":"Annotation","priority":"INFO","timestamp":"2017-07-12T11:39:21.0463949+08:00","payload":{"id":71,"orgId":1,"dashboardId":7,"panelId":1,"categoryId":0,"regionId":0,"title":"redis_count alert","text":"Alerting","metric":"","alertId":4,"userId":0,"prevState":"ok","newState":"alerting","epoch":1499830761,"data":{"evalMatches":[{"value":1578.9999999999998,"metric":"bosun.redis_count","tags":null}]}}}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,752评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,100评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,244评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,099评论 1 286
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,210评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,307评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,346评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,133评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,546评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,849评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,019评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,702评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,331评论 3 319
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,030评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,260评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,871评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,898评论 2 351

推荐阅读更多精彩内容

  • 来源 RabbitMQ是用Erlang实现的一个高并发高可靠AMQP消息队列服务器。支持消息的持久化、事务、拥塞控...
    jiangmo阅读 10,353评论 2 34
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,644评论 18 139
  • 什么叫消息队列 消息(Message)是指在应用间传送的数据。消息可以非常简单,比如只包含文本字符串,也可以更复杂...
    lijun_m阅读 1,340评论 0 1
  • rabbitMQ是一款基于AMQP协议的消息中间件,它能够在应用之间提供可靠的消息传输。在易用性,扩展性,高可用性...
    点融黑帮阅读 2,995评论 3 41
  • RabbitMQ详解 本文地址:http://www.host900.com/index.php/articles...
    嘉加家佳七阅读 2,507评论 0 9