promoter

Промоутер

Promoter — это реализация Webhooks для уведомлений о тревогах AlertManager. В настоящее время она поддерживает钉钉и企业微信, а также поддерживает отображение графиков тревог в реальном времени в уведомлениях о сообщениях.

Установить

Проект написан на языке Go и существует множество способов установки Promoter.

Скомпилировать двоичный файл

Непосредственно клонируйте проект и соберите его вручную:

$ git clone https://github.com/cnych/promoter.git
$ cd promoter
$ go build -a -o promoter cmd/promoter/main.go
$ ./promoter --config.file= < your_file >

Докер-образ

Образ Promoter загружается в Docker Hub. Вы можете попробовать использовать следующую команду для запуска службы:

$ docker run --name promoter -d -p 8080:8080 cnych/promoter:main

Конфигурация

Следующая конфигурация в основном охватывает конфигурацию, используемую Promoter:

 global :
  prometheus_url : http://192.168.31.31:30104
  wechat_api_secret : <secret>
  wechat_api_corp_id : <secret>
  dingtalk_api_token : <secret>
  dingtalk_api_secret : <secret>

s3 :
  access_key : <secret>
  secret_key : <secret>
  endpoint : oss-cn-beijing.aliyuncs.com
  region : cn-beijing
  bucket : <bucket>

receivers :
  - name : rcv1
    wechat_configs :
      - agent_id : <agent_id>
        to_user : " @all "
        message_type : markdown
        message : ' {{ template "wechat.default.message" . }} '
    dingtalk_configs :
      - message_type : markdown
        markdown :
          title : ' {{ template "dingtalk.default.title" . }} '
          text : ' {{ template "dingtalk.default.content" . }} '
        at :
          atMobiles : [ "123456" ]
          isAtAll : false

В разделе «Глобальные» вы можете настроить глобальные атрибуты, такие как корпоративные ключи WeChat или DingTalk. В разделе «S3» имеется конфигурация хранилища объектов (также можно использовать Alibaba Cloud OSS) для сохранения изображений, созданных значком мониторинга.

Ниже receivers настроенные приемники для различных сообщений. Вы можете настроить Enterprise WeChat и DingTalk одновременно в одном получателе. Он поддерживает два формата: text и markdown . Например, name здесь rcv1 . получатель Адрес веб-перехватчика: http://<promoter-url>/rcv1/send , который необходимо настроить в веб-перехватчике AlertManager.

Следует отметить, что формат Markdown Enterprise WeChat не поддерживает прямое отображение изображений.

шаблон

Шаблон по умолчанию находится в template/default.tmpl и может быть настроен в соответствии с вашими потребностями:

 {{ define "__subject" }}[{{ .Status | toUpper }}{{ if eq .Status "firing" }}:{{ .Alerts.Firing | len }}{{ end }}] {{ .GroupLabels.SortedPairs.Values | join " " }} {{ if gt (len .CommonLabels) (len .GroupLabels) }}({{ with .CommonLabels.Remove .GroupLabels.Names }}{{ .Values | join " " }}{{ end }}){{ end }}{{ end }}

{{ define "default.__text_alert_list" }}{{ range . }}
**{{ .Annotations.summary }}**

{{ range .Images }}
![click there get alert image]({{ .Url }})
{{- end }}

**description:**
> {{ .Annotations.description }}

**labels:**
{{ range .Labels.SortedPairs }}{{ if and (ne (.Name) "severity") (ne (.Name) "summary") }}> - {{ .Name }}: {{ .Value | markdown | html }}
{{ end }}{{ end }}
{{ end }}{{ end }}

{{ define "dingtalk.default.title" }}{{ template "__subject" . }}{{ end }}
{{ define "dingtalk.default.content" }}
{{ if gt (len .Alerts.Firing) 0 -}}
### {{ .Alerts.Firing | len }} Alerts Firing:
{{ template "default.__text_alert_list" .Alerts.Firing }}
{{ range .AtMobiles }}@{{ . }}{{ end }}
{{- end }}
{{ if gt (len .Alerts.Resolved) 0 -}}
### **{{ .Alerts.Resolved | len }} Alerts Resolved:**
{{ template "default.__text_alert_list" .Alerts.Resolved }}
{{ range .AtMobiles }}@{{ . }}{{ end }}
{{- end }}
{{- end }}

{{ define "wechat.default.message" }}
{{ if gt (len .Alerts.Firing) 0 -}}
### {{ .Alerts.Firing | len }} Alerts Firing:
> {{ template "default.__text_alert_list" .Alerts.Firing }}
{{- end }}
{{ if gt (len .Alerts.Resolved) 0 -}}
### **{{ .Alerts.Resolved | len }} Alerts Resolved:**
{{ template "default.__text_alert_list" .Alerts.Resolved }}
{{- end }}
{{- end }}
{{ define "wechat.default.to_user" }}{{ end }}
{{ define "wechat.default.to_party" }}{{ end }}
{{ define "wechat.default.to_tag" }}{{ end }}
{{ define "wechat.default.agent_id" }}{{ end }}