全部產品
Search
文件中心

:管理連絡人

更新時間:Sep 12, 2025

通知策略的匹配規則被觸發時,可以向您指定的連絡人發送通知。本文介紹如何設定連絡人、連絡人群組、DingTalk機器人,以及如何擷取DingTalk機器人Webhook地址建立Webhook警示。

連絡人

建立連絡人

  1. 在左側導覽列,選擇通知警示 > 連絡人管理

  2. 通知對象頁面的連絡人頁簽,單擊建立連絡人

  3. 建立連絡人對話方塊,配置相關資訊,然後單擊確認

    配置項

    說明

    姓名

    自訂連絡人姓名。

    手機號

    設定連絡人的手機號後,可以通過電話和簡訊的方式接收警示通知。

    說明

    僅驗證過的手機號可以在通知策略中使用電話的通知方式。驗證手機號的操作,請參見驗證手機號

    郵箱

    設定連絡人的郵箱地址後,可以通過郵箱接收警示通知。

    連絡人群組

    選擇連絡人需要加入的連絡人群組。建立連絡人群組的操作,請參見連絡人群組

    電話通知失敗補發類型

    選擇電話通知失敗後,通知補發類型。您可以在連絡人頁簽設定全域預設值。具體操作,請參見設定連絡人預設配置

    使用者標識

    可以協助系統區分不同的使用者,並且在處理資料、查詢資訊或者進行其他動作時提供方便。

    說明
    • 手機號碼和郵箱至少填寫一項,每個手機號碼或郵箱只能用於一個連絡人。

    • 如果您需要建立DingTalk機器人,請在DingTalk/飛書/企微頁簽建立DingTalk機器人。具體操作,請參見DingTalk機器人

    建立連絡人後,您可以在連絡人頁簽查詢、編輯或刪除連絡人。

驗證手機號

僅驗證過的手機號可以在通知策略中使用電話的通知方式。

  1. 在左側導覽列,選擇通知警示 > 連絡人管理

  2. 通知對象頁面的連絡人頁簽,選擇為一個或多個連絡人驗證手機號。

    • 如需為單個連絡人驗證手機號:單擊未驗證手機號右側的未驗證

    • 如需為多個連絡人批量驗證手機號:在複選框選中需要驗證手機號的連絡人,然後單擊批量驗證

    系統將會給各連絡人發送驗證手機號簡訊。

  3. 使用瀏覽器開啟簡訊中的連結。

  4. 在驗證頁面確認手機號資訊,然後單擊驗證

設定連絡人預設配置

警示通過電話通知失敗後,您可以設定通知補發類型。

  1. 在左側導覽列,選擇通知警示 > 連絡人管理

  2. 通知對象頁面的連絡人頁簽,選擇更多操作 > 連絡人預設配置

  3. 在彈出的對話方塊,選擇通知補發類型,然後單擊確認

連絡人群組

建立通知策略時,您可以將連絡人群組指定為通知對象。當通知策略的匹配規則被觸發時,SAE警示管理會向該連絡人群組中的連絡人通過電話、簡訊、郵件和DingTalk等方式發送警示通知。

前提條件

建立連絡人

建立連絡人群組

  1. 在左側導覽列,選擇通知警示 > 連絡人管理

  2. 通知對象頁面的連絡人頁簽,單擊建立連絡人群組

  3. 建立聯絡組對話方塊,輸入組名,選擇警示連絡人,並單擊確認

    建立成功後,對應的連絡人群組將顯示在連絡人頁簽的左側列表中。

管理連絡人群組

建立連絡人群組後,您可以在連絡人頁簽查詢、編輯或刪除連絡人群組。

  • 編輯連絡人群組:在目標連絡人群組右側選擇更多表徵圖 > 編輯組,在彈出的對話方塊中修改連絡人群組的名稱或包含的連絡人,然後單擊確認

  • 查看連絡人群組詳情:單擊連絡人群組左側的Down arrow表徵圖展開連絡人群組。

  • 刪除連絡人群組:在目標連絡人群組右側選擇更多表徵圖 > 刪除群組,然後在彈出的提示對話方塊中單擊確認

    重要
    • 刪除連絡人群組之前,請確保目標連絡人群組沒有添加至通知策略中,否則可能導致警示通知無法發送。

    • 僅目前使用者建立的連絡人群組支援刪除。

DingTalk機器人

SAE通知警示中建立DingTalk機器人後,您可以在通知策略中指定對應的DingTalk群用於接收警示。當通知策略的規則被觸發時,系統會自動向您指定的DingTalk群發送警示通知。DingTalk群收到通知後,您可以在DingTalk群中對警示進行管理。

在SAE控制台建立警示通知DingTalk群

  1. 在DingTalk群中建立自訂機器人並擷取機器人Webhook地址。具體操作,請參見擷取DingTalk機器人Webhook地址

  2. 在左側導覽列,選擇通知警示 > 連絡人管理,在通知對象頁面的DingTalk/飛書/企微頁簽,單擊DingTalk卡片。

  3. 建立DingTalk機器人面板,設定相關資訊,然後單擊確定

    說明

    在通知策略中需要選擇通知方式DingTalk才能在DingTalk群中接收警示。具體操作,請參見通知策略

    配置項

    說明

    名稱

    自訂DingTalk機器人的名稱。

    簽名密鑰

    可選,如配置了密鑰則會通過加簽的方式進行DingTalk認證。如果沒有配置密鑰,預設使用關鍵字白名單的方式進行認證,白名單關鍵字為警示

    機器人地址

    輸入DingTalk機器人的Webhook地址。

    機器人是否發送每日統計

    選中後,需要輸入每日統計資訊發送的時間點,使用英文半形逗號(,)分隔多個發送時間點,時間點格式為HH:SS。警示管理將在設定的時間點發送今日產生警示的總數、解決數和待解決數。

    卡片內容配置

    自訂警示通知卡片樣式和內容。

在DingTalk群管理警示

在DingTalk群中收到警示通知後,您可以在DingTalk群裡查看並管理警示。更多資訊,請參見在警示通知群中處理警示

擷取DingTalk機器人Webhook地址

設定DingTalk群或在連絡人中設定DingTalk機器人時,需要先在DingTalk群中擷取自訂機器人Webhook地址。本文介紹如何擷取DingTalk機器人Webhook地址。請按照以下步驟在DingTalk群中添加自訂DingTalk機器人並擷取Webhook地址。

  1. 在PC版DingTalk上開啟您想要添加警示機器人的DingTalk群,並單擊右上方的群設定表徵圖。

  2. 群設定面板中單擊機器人,然後單擊添加機器人

  3. 智能群助手面板單擊添加機器人,繼續單擊添加機器人,然後選擇添加自訂image.png

  4. 群機器人對話方塊單擊添加機器人地區的設定表徵圖,然後選擇添加自訂

  5. 機器人詳情對話方塊單擊添加

  6. 添加機器人對話方塊中執行以下操作。

    1. 設定機器人頭像和名字。

    2. 安全設定選中自訂關鍵詞,設定關鍵詞為SAE

    3. 選中我已閱讀並同意《自訂機器人服務及免責條款》

    4. 單擊完成

    說明

    更多關於DingTalk機器人的操作,請參見自訂機器人接入

  7. 添加機器人對話方塊中複製產生的機器人Webhook地址,然後單擊完成

通過Webhook自訂警示通知連絡人

建立通知策略時,您可以將警示通知發送到自訂的Webhook地址中。通知警示支援對飛書、微信、DingTalk等群組發送Webhook警示。本文以飛書為例,介紹如何建立Webhook警示。

步驟一:擷取Webhook地址

  1. 開啟並登入飛書。

  2. 單擊+表徵圖,然後單擊建立群組,建立一個用於發送警示的群組。

  3. 單擊群組設定表徵圖,然後單擊群機器人頁簽,在群機器人頁簽,單擊添加機器人

  4. 添加機器人面板,選擇Custom Bot,然後在配置頁,輸入機器人名稱描述,單擊添加

  5. 複製Webhook地址,然後選中自訂關鍵詞並輸入關鍵詞為警示,然後單擊完成

步驟二:建立Webhook連絡人

  1. 在左側導覽列,選擇通知警示 > 連絡人管理

  2. 通知對象頁面的Webhook整合頁簽,單擊建立Webhook

  3. 建立Webhook對話方塊,配置以下資訊,然後單擊確定

    資訊配置完成後,您可以先單擊發送測試,驗證配置是否成功,然後再單擊確定

    配置項

    說明

    Webhook名稱

    自訂Webhook名稱。

    Post/Get

    佈建要求方法。URL不超過100個字元。

    此例中選擇Post,並將步驟一:擷取Webhook地址中儲存的Webhook地址粘貼至右側文字框。

    Header/Param

    佈建要求頭,不可超過200個字元。 單擊添加,可以添加其他Header資訊或Param資訊。預設要求標頭為Content-Type: text/plain; charset=UTF-8,Header和Param個數總數不能超過6個。

    此例中設定以下兩個Header

    • Arms-Content-Type : json

    • Content-Type : application/json

    通知模板

    警示觸發時發送的通知模板,在Post方法下出現,可使用$content預留位置輸出通知內容,不可超過500個字元。更多資訊,請參見配置通知模板和Webhook模板

    通知模板如下:

    {
    "警示名稱":"{{ .commonLabels.alertname }}{{if .commonLabels.clustername }}",
    "叢集名稱":"{{ .commonLabels.clustername }} {{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}",
    "應用程式名稱":"{{ .commonLabels._aliyun_arms_involvedObject_name }} {{ end }}",
    "通知策略":"{{ .dispatchRuleName }}",
    "警示時間":"{{ .startTime }}",
    "警示內容":"{{ for .alerts }} {{ .annotations.message }} {{ end }}"
    }

    此處以飛書為例,可以設定如下文字格式設定:

    {
      "msg_type": "text",
      "content": {
        "text": "警示名稱: {{ .commonLabels.alertname }}\n{{if .commonLabels.clustername }}叢集名稱: {{ .commonLabels.clustername }}\n{{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}應用程式名稱: {{ .commonLabels._aliyun_arms_involvedObject_name }}\n{{ end }}通知策略: {{ .dispatchRuleName }} \n警示時間: {{ .startTime }} \n警示內容: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
      }
    }

    恢複模板

    警示恢複時發送的通知模板,在Post方法下出現,可使用$content預留位置輸出通知內容,不超過500個字元。更多資訊,請參見配置通知模板和Webhook模板

    恢複模板如下:

    {
    "警示名稱":"{{ .commonLabels.alertname }}{{if .commonLabels.clustername }}",
    "叢集名稱":"{{ .commonLabels.clustername }} {{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}",
    "應用程式名稱":"{{ .commonLabels._aliyun_arms_involvedObject_name }} {{ end }}",
    "通知策略":"{{ .dispatchRuleName }}",
    "恢復":"{{ .endTime }}",
    "警示內容":"{{ for .alerts }} {{ .annotations.message }} {{ end }}"
    }

    此處以飛書為例,可以設定如下文字格式設定:

    {
      "msg_type": "text",
      "content": {
        "text": "警示名稱: {{ .commonLabels.alertname }}\n{{if .commonLabels.clustername }}叢集名稱: {{ .commonLabels.clustername }}\n{{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}應用程式名稱: {{ .commonLabels._aliyun_arms_involvedObject_name }}\n{{ end }}恢復: {{ .startTime }} \n通知策略: {{ .dispatchRuleName }} \n恢複警示內容: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
      }
    }

步驟三:設定通知策略

建立或編輯通知策略,選擇通知對象通用Webhook,然後選擇對應的Webhook整合。具體操作,請參見通知策略

說明

Webhook警示的逾時時間為5秒,如果發出請求後5秒內沒有返回,即沒有收到警示資訊,則表示發送失敗。