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 >

ภาพนักเทียบท่า

อิมเมจโปรโมเตอร์ถูกอัปโหลดไปยัง Docker Hub คุณสามารถลองใช้คำสั่งต่อไปนี้เพื่อเริ่มบริการ:

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

การกำหนดค่า

โดยทั่วไปการกำหนดค่าต่อไปนี้จะครอบคลุมการกำหนดค่าที่ใช้โดยโปรโมเตอร์:

 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 ด้านล่างคือตัวรับที่กำหนดค่า rcv1 ข้อความต่างๆ คุณสามารถกำหนดค่า Enterprise WeChat และ DingTalk ได้พร้อมกันในตัวรับสัญญาณเดียว โดยรองรับสองรูปแบบ: text และ markdown name มีขนาดกลางมาก ผู้รับ ที่อยู่ Webhook คือ: http://<promoter-url>/rcv1/send ซึ่งจำเป็นต้องกำหนดค่าใน AlertManager Webhook

ควรสังเกตว่ารูปแบบ 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 }}