promoter

Promotor

Promoter es una implementación de Webhooks para notificaciones de alarma de AlertManager. Actualmente es compatible con钉钉y企业微信, y admite la visualización de gráficos de alarmas en tiempo real en notificaciones de mensajes.

Instalar

El proyecto está escrito en lenguaje Go y hay muchas formas de instalar Promoter.

compilar binario

Clona directamente el proyecto y constrúyelo manualmente:

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

imagen acoplable

La imagen del Promotor se carga en Docker Hub. Puede intentar usar el siguiente comando para iniciar el servicio:

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

Configuración

La siguiente configuración cubre básicamente la configuración utilizada por 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

En global, puede configurar atributos globales, como claves empresariales WeChat o DingTalk. En S3, hay una configuración de almacenamiento de objetos (también se puede usar Alibaba Cloud OSS) para guardar las imágenes generadas por el ícono de monitoreo.

Los siguientes receivers son los receptores configurados para varios mensajes. Puede configurar Enterprise WeChat y DingTalk al mismo tiempo en un receptor. Admite dos formatos: text y markdown . Por ejemplo, name nombre aquí es rcv1 . La dirección del Webhook del receptor es: http://<promoter-url>/rcv1/send , que debe configurarse en el Webhook de AlertManager.

Cabe señalar que el formato Markdown de Enterprise WeChat no admite la visualización directa de imágenes.

plantilla

La plantilla predeterminada se encuentra en template/default.tmpl y se puede personalizar según sus propias necesidades:

 {{ 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 }}