通知對象 - Cloud Monitor

通知對象，包括連絡人支援通過電話、簡訊和郵件方式接收警示通知，通知不同類型機器人，或者由自訂webhook處理，並且有效合理安排警示通知值班人員。

功能入口

登入CloudMonitor2.0控制台。
在左側導覽列選擇警示中心或者所有功能 - 警示中心。
在警示中心頁面，選擇通知管理 - 通知對象。

如何通過電話、簡訊、郵件接收警示通知

連絡人

在連絡人頁簽，單擊建立連絡人。
在建立連絡人對話方塊中，根據需求設定以下參數，單擊確定。
- 名稱：自訂連絡人名稱，可以設定重複的名稱。
- 標識符：自訂標識符，不可以與已新增連絡人...標識符重複。
- 語言：選擇警示通知的訊息語言中文或者英文。
- 電話：設定接收警示的手機號。
- E-mail：設定連絡人的郵箱地址接收警示通知。
驗證手機號碼和郵箱地址，在您設定的手機號和郵箱地址中，收到啟用連結後單擊即可完成。
警示通知的觸達方式與連絡人配置要求如下，未完成驗證的手機號和郵箱地址收不到警示通知：
- 電話：需要先完成手機號驗證，即單擊手機號收到的啟用連結。未完成驗證的手機號不會接到電話通知。
- 簡訊：在電話中設定手機號並完成驗證後，即可接收簡訊通知。
- E-mail：在E-mail中設定郵箱地址並完成驗證後，即可內送郵件通知。
一條警示最終通過哪幾種方式觸達，由警示中心 - 通知管理 - 通知策略中該策略選擇的通知方式決定，連絡人本身只負責提供可用的手機號和郵箱地址。如果連絡人資訊已驗證但仍未收到通知，請檢查通知策略是否選擇了對應的通知方式。
費用說明：郵件通知不收費；簡訊通知和電話通知在超出免費額度後隨用隨付。
新增連絡人...後，可在連絡人頁簽查詢、編輯或刪除連絡人：
- 搜尋連絡人：您可以在連絡人頁簽，右側搜尋方塊中輸入連絡人姓名的關鍵字，並單擊表徵圖。
- 編輯連絡人：單擊目標連絡人右側操作列中的編輯，在彈出的對話方塊中修改連絡人資訊，單擊確定。
- 刪除單個連絡人：單擊目標連絡人右側操作列中的刪除，在對話方塊中單擊確定。
- 刪除多個連絡人：選擇目標連絡人，單擊列表下方刪除，在對話方塊中單擊確定。

連絡人群組

在連絡人頁簽，單擊連絡人群組列表。
單擊建立連絡人群組。
在建立連絡人群組對話方塊中，設定以下參數，單擊確定。
- 名稱：自訂連絡人群組名稱。
- 標識符：自訂連絡人群組的唯一標識。
- 連絡人：選擇已有連絡人加入連絡人群組。
在新增連絡人...組後，可在連絡人群組列表，查詢、編輯或刪除連絡人群組：
- 搜尋：在右側搜尋方塊中輸入連絡人群組名關鍵字，並單擊表徵圖。
- 編輯或者刪除：選擇目標連絡人群組操作列，單擊編輯或者刪除，進行目標連絡人群組操作。

如果連絡人群組顯示無資料、或者綁定連絡人群組後無法擷取連絡人資訊，請按以下順序排查：

確認組內已加入連絡人：在連絡人頁簽單擊連絡人群組列表，開啟目標連絡人群組（例如系統預置的雲帳號警示連絡人），確認連絡人中已加入成員。未完成手機號或郵箱地址驗證的連絡人無法接收警示通知。
確認警示側已引用該連絡人群組：在警示中心 - 通知管理 - 通知策略中開啟目標策略，確認其通知對象中已選中該連絡人群組。連絡人群組只有被通知策略引用後才會參與警示通知下發。
通過 OpenAPI 複核組內實際成員：調用 ListContactGroups 查詢連絡人群組，調用 ListContacts 查詢連絡人，將返回結果與控制台展示的內容比對，確認是配置未生效還是組內確實沒有成員。

重要

刪除連絡人或者連絡人群組之前，請確保目標連絡人或者聯絡組沒有添加至通知策略，否則可能導致警示通知無法發送。
僅支援刪除目前使用者建立的連絡人和組。

通過機器人（DingTalk、飛書、SLACK、企業微信、TEAMS）接收警示通知

在通知對象頁面，選擇機器人頁簽，單擊建立機器人。
在建立機器人對話方塊中，根據需求設定以下參數，單擊確定。
- 名稱：自訂機器人名稱，可以設定重複的機器人名稱。
- 標識符：自訂唯一標識，不可以與已添加的機器人標識重複。
- 類型：可以支援不同類型機器人（DingTalk、飛書、SLACK、企業微信、TEAMS）接收警示通知。
- URL：根據選擇的機器人類型，設定回調地址。
- 語言：選擇警示通知的訊息語言中文或者英文。
添加機器人後，可在機器人頁簽查詢、編輯或刪除機器人：
- 搜尋：根據請選擇類型、搜尋名稱的關鍵字，查詢機器人。
- 編輯：選擇目標機器人，單擊右側操作列中的編輯，在編輯機器人對話方塊中修改資訊，單擊確認。
- 刪除：選擇目標機器人，單擊右側操作列中的刪除，如果需要大量刪除，單擊機器人列表下方按鈕刪除，單擊確定。

說明

機器人（DingTalk、飛書、企業微信、Slack、TEAMS）類型的通知無需配置防火牆白名單。
通知的重試策略為 3 次，逾時時間為 5 秒，無退避。

通過自訂webhook接收警示通知

在通知對象頁面，選擇自訂Webhook頁簽，單擊建立 Webhook。
在建立 Webhook對話方塊中，根據需求設定以下參數，單擊確認。
- 名稱：自訂Webhook名稱，可以設定重複的名稱。
- 標識符：自訂唯一標識，不可以與已添加的自訂Webhook標識重複。
- URL：設定自訂的Webhook回調地址。
- Headers：設定可以攜帶的參數Param，以<key><value>形式填寫，最多可以設定5個參數。
- Method：佈建要求方法GET或者POST。
- 資料格式：可以選擇資料格式FORM或者JSON。
- 語言：選擇通知訊息是中文或者英文。
添加自訂Webhook後，可在自訂Webhook頁簽查詢、編輯或刪除自訂Webhook：
- 搜尋：搜尋名稱的關鍵字，查詢自訂Webhook。
- 編輯：選擇目標自訂Webhook，單擊右側操作列中的編輯，在編輯 Webhook對話方塊中修改資訊，單擊確認。
- 刪除：選擇目標自訂Webhook，單擊右側操作列中的刪除，如果需要大量刪除，單擊列表下方大量刪除，單擊確認。

說明

CloudMonitor通過 HTTP 協議或 HTTPS 協議的 POST 請求推送警示通知到指定的 URL 地址，請將以下 IP 位址加入防火牆白名單：
```
47.74.206.0/26
47.74.206.64/26
47.74.206.128/26
47.74.206.192/26
8.222.159.116
```
通知的重試策略為 3 次，逾時時間為 5 秒，無退避。

如果推送狀態顯示成功但接收端未收到警示通知，請按以下順序排查：

確認通知對象的類型選擇正確：DingTalk、飛書、企業微信、SLACK、TEAMS 的群機器人應在機器人頁簽建立，自訂Webhook頁簽僅用於自行接收並處理 HTTP 要求或 HTTPS 請求的服務端地址。兩者的請求體和鑒權方式不同，把群機器人的回調地址填寫在自訂Webhook頁簽，會出現推送成功但群內沒有訊息的現象。
在接收端確認請求是否到達：查看接收端（群機器人平台或自研服務）的 incoming message 記錄或訪問日誌，確認警示時間點是否有請求到達。如果接收端沒有任何記錄，請先按本章節列出的 IP 位址完成防火牆白名單放通後重試。
如果請求已到達但接收端未展示訊息，請確認Method、資料格式和Headers與接收端的要求一致，並確認接收端在重試策略的逾時時間內返回了響應。

Webhook返回欄位說明

分類	欄位	類型	描述
CloudEvents 標準欄位	specversion	String	CloudEvents 規範版本
	id	String	事件唯一 ID
	type	String	事件類型，如 "ALERT"、“Change”
	subtype	String	事件子類型，如 "NORMAL_TRIGGER"（正常觸發）、"NORMAL_RESOLVE"（恢複）
	source	String	事件來源路徑，格式 /{userId}/rules/{ruleId}
	sourcetype	String	事件來源系統標識，如 "ALERT_ALIYUN_ALERT_CENTER"
	time	String	事件發生時間，ISO 8601 格式
	timestamp	Long	事件發生時間，Unix 毫秒時間戳記
	subject	String	警示規則名稱
	datacontenttype	String	data 欄位的內容類型，固定 "application/json"
警示核心欄位	severity	String	嚴重層級，如：CRITICAL / WARNING / INFO
	status	String	警示狀態，如 "OCCURRED"（發生）、"RESOLVED"（恢複）
	userId	String	使用者識別碼
	ruleId	String	警示規則 ID
	workspace	String	工作空間標識，如region內的預設工作空間 default-cms-{userId}-{region}
	traceId	String	鏈路追蹤識別碼，用於排查問題
	alertMessage	String	警示描述訊息，主要是警示摘要
	alertEntityId	String	警示實體唯一標識
resource 對象	resource.entity.domain	String	實體域，如 "ecs"、"rds"、“apm”
	resource.entity.entity_type	String	實體類型，如 "instance"、"disk"
	resource.entity.entity_id	String	實體 ID
	resource.entity.prop	Object	實體屬性，索引值對，如 instanceName
	resource.tags	Object	資源標籤，索引值對，包含 instanceId、regionId 等
labels 對象	labels._cms_region	String	地區 ID，如 "cn-hangzhou"
	labels._cms_workspace	String	工作空間標識
	labels._cms_rule_id	String	警示規則 ID
	labels._cms_rule_name	String	警示規則名稱
annotations 對象	annotations.current_value	String	當前監控指標值
	annotations._cms_promql	String	觸發警示的 PromQL 查詢運算式
	annotations._cms_business_url	String	業務詳情頁連結
	annotations._cms_alert_rule_url	String	警示規則配置頁連結
	annotations._cms_alert_history_url	String	警示記錄頁連結
data 對象	data.value	Number	觸發警示時的實際監控值
	data.threshold	Number	警示閾值
	data.comparisonOperator	String	比較子
alertEntityFields 對象	alertEntityFields	Object	警示實體關鍵屬性平鋪，如 instanceName、regionId
快捷連結欄位	ruleUrl	String	警示規則控制台連結
	entityUrl	String	警示實體詳情控制台連結
	alertRuleUrl	String	警示規則配置頁連結
	alertHistoryUrl	String	警示歷史頁連結

常見問題

如何取消CloudMonitor周報郵件通知？

控制台暫無關閉CloudMonitor周報郵件的入口。如需停止接收，請聯絡阿里雲客服提交申請，由研發人員在後台關閉該阿里雲帳號 UID 下的CloudMonitor周報通知。關閉後，該雲帳號下的所有連絡人都不再收到CloudMonitor周報。

能否通過手機號查詢連絡人的歷史動作記錄？

不支援。CloudMonitor不提供按手機號查詢該連絡人操作過哪些伺服器的歷史動作記錄的能力，連絡人的手機號僅用於接收警示通知。