Application Real-Time Monitoring Service：整合Zabbix

前提條件

本文檔只支援Zabbix 5.x版本。

步驟一：建立Zabbix整合

1. 登入ARMS控制台，在左側導覽列選擇警示管理 > 整合。

2. 在告警集成頁簽，單擊Zabbix。

3. 在建立Zabbix整合設定精靈頁面輸入Zabbix整合的名稱、描述和警示事件自動回復時間，然後單擊保存。

   說明

   逾時自動回復時間：當警示事件在設定的時間內都沒有再觸發，警示事件將會自動回復。

4. 在告警集成頁簽，通過搜尋方塊查詢已建立的Zabbix整合，並複製整合地址。

步驟二：配置Zabbix

1. 登入到Zabbix所在的伺服器，執行以下命令尋找Zabbix指令碼路徑。

   cat /etc/zabbix/zabbix_server.conf | grep alert

   返回樣本：

   [root@localhost ~]# cat /etc/zabbix/zabbix_server.conf | grep alert
   #       Number of pre-forked instances of alerters.
   #       Full path to location of custom alert scripts.
   # AlertScriptsPath=${datadir}/zabbix/alertscripts
   AlertScriptsPath=/usr/lib/zabbix/alertscripts
   [root@localhost ~]#

2. 使用cd命令進入Zabbix指令碼路徑。

3. 執行以下命令下載ARMS警示管理安裝包。

   wget http://arms-public.oss-cn-shanghai.aliyuncs.com/alerts/aliyunalertmanager.tgz

4. 執行以下命令解壓ARMS警示管理安裝包。

   tar -xzvf aliyunalertmanager.tgz

5. 進入安裝包的bin目錄。

   cd aliyunalertmanager/bin

6. 執行以下命令安裝ARMS警示管理。

   sh install.sh {整合地址}

   將命令中的{整合地址}替換為步驟一中擷取的整合地址。

7. 在安裝過程中根據命令提示輸入Zabbix管理地址、管理員帳號和密碼。

（可選）步驟三：編輯整合

ARMS警示管理預設了Zabbix警示源與ARMS警示管理之間欄位的映射，您也可以根據需要在编辑集成頁面新增或修改欄位的映射關係。

樣本警示源：

{
    "startat":"2021.09.09 20:13:57",
    "eventId":"16874-9756",
    "eventType":"trigger",
    "message":"/: Used space in Zabbix server value is 81 GB, triggered an alarm disk usage trigger",
    "hostname":"Zabbix server",
    "ip":"127.0.0.1",
    "severity":"Warning",
    "value":"81 GB",
    "metric":"vfs.fs.size[/,used]",
    "itemName":"/: Used space",
    "alertname":"disk usage trigger",
    "eventUrl":"http://127.0.0.1/zabbix/tr_events.php?triggerid=16874&eventid=9756"
}

1. 在警示整合頁簽單擊目的地組成右側操作列的編輯。

2. 在事件映射地區左側單擊發送測試資料。

3. 在發送測試資料對話方塊，輸入第三方警示源的JSON格式的警示內容，然後單擊發送。

   說明

   • 如果顯示上傳成功，但未建置事件，請根據未經處理資料配置事件映射規則!，表示警示源與ARMS警示事件的欄位沒有映射，實際發送資料會被儲存在左側記錄框中，以便配置映射時可以直接選取對應警示源欄位。

   • 如果顯示上傳成功！，則表明對應的警示內容已上報至警示事件歷史頁面。更多資訊，請參見查看警示事件歷史。

4. 在發送測試資料對話方塊單擊關閉。

5. 在事件映射地區左側單擊並展開需要建立映射的警示資料。

6. 在事件映射地區右側配置警示源欄位與ARMS警示的映射。

   1. 可選：在選擇根節點地區選取項目是否使用批處理。

      當警示資料存在數組節點時，可以指定目標數組節點作為根節點，將對應根節點下的資料進行批處理。

      選擇使用批處理後，選擇需要批處理的數組節點作為根節點。

      說明

      當警示資料存在多個數組節點時，ARMS警示管理僅支援選擇其中一個數組節點進行批處理。

   2. 在將源欄位對應到目標欄位地區將警示源欄位對應到ARMS警示欄位上。

      單擊映射表徵圖，可以修改欄位對應方式。

      • 直接：警示源指定欄位直接映射為ARMS中對應的警示欄位。

      • 串聯：將多個警示源欄位通過指定分隔字元串聯為一個欄位，然後將這一個欄位對應為ARMS中對應的警示欄位。分隔字元僅支援特殊字元。

      • 條件：當警示欄位值滿足指定條件後，設定的欄位才會映射到ARMS目標欄位上。

      • 映射表：設定警示源的警示等級與ARMS中的警示等級的映射，僅警示等級（severity）欄位需要設定映射表。

      ARMS警示欄位說明：

      ARMS警示欄位	說明
      警示名稱（alertname）	自訂警示的名稱。
      警示等級（severity）	設定警示等級的映射欄位。該欄位需要設定警示等級映射表，且映射方式必須設定為直接映射。
      警示描述（message）	警示事件的詳細資料，用於警示通知。最多支援15000字元。
      警示樣本值（value）	監控指標的樣本值。
      警示圖片（imageUrl）	指標折線圖URL，用於映射Grafana指標折線圖。
      檢查項（check）	警示檢查項。例如：CPU、JVM、Application Crash、Deployment。
      來源（source）	警示事件的來源。
      分類（class）	警示事件的物件類型，例如：主機。
      服務（service）	與業務相關的來源服務，例如：Login Service。
      開始時間（startat）	事件開始時間的時間戳記。
      結束時間（endat）	事件結束時間的時間戳記。
      事件位址（generatorUrl）	事件詳細資料地址。

7. 設定事件去重。

   為了減少重複資料，系統使用相關欄位作為去重依據。ARMS警示管理支援預覽事件映射地區中的歷史事件數目據的去重分組結果，您可根據需要調整去重欄位。

   說明

   事件去重僅針對未恢複狀態下的事件。

   1. 在編輯整合頁面的事件去重地區選取項目需要去重的欄位。

      當選擇的欄位的值相同時，對應的多個事件將會合并為一個警示通知。

   2. 單擊去重測試，可以預覽去重後的警示分組。

      說明

      去重測試針對的是事件映射左側地區中上傳的最近10條測試資料。

8. 配置完成後，單擊儲存。

結果驗證

執行以下步驟確認ARMS警示管理是否安裝成功。

1. 登入Zabbix控制台。

2. 在頂部功能表列選擇管理 > 用户。

   在用户頁面查看是否存在名稱為Aliyun Alert User的使用者。在使用者列表中可以看到 Aliyun Alert User 使用者已建立成功，使用者類型為超級管理員，所屬群組為 Aliyun Alert Group，狀態為已啟用。

3. 在頂部功能表列選擇管理 > 使用者群組。

   在使用者群組頁面查看是否存在名稱為Aliyun Alert Group的群組，且群組成員為Aliyun Alert User。頁面中顯示名稱為 Aliyun Alert Group 的使用者群組，成員為 Aliyun Alert User，狀態為 已啟用，表示使用者群組建立成功。

4. 在頂部功能表列選擇管理 > 警示媒介類型。

   在警示媒介類型頁面查看是否存在名稱為Aliyun Alert Media的警示媒介。在警示媒介類型列表中，確認存在名為 Aliyun Alert Media 的記錄，類型為 指令碼，狀態為 已啟用，指令碼名稱為 aliyunalertmanager/bin/alert.sh，表示警示媒介配置成功。

5. 在頂部功能表列選擇配置 > 动作。

   在动作頁面查看是否存在名稱為Aliyun Alert Action的動作。在動作列表中，確認 Aliyun Alert Action 已建立且狀態為已啟用，其操作為發送訊息給使用者 Aliyun Alert User 通過所有介質。

   說明

   您可以根據需求在Aliyun Alert Action動作中自訂警示上報內容。

查看警示事件

1. 在控制台左側導覽列選擇警示管理 > 警示事件歷史。

2. 在警示事件歷史頁面單擊目標事件，可以查看警示事件的詳細資料。更多資訊，請參見查看警示事件歷史。

管理整合

在警示管理 > 整合頁面的警示整合頁簽，對於已經建立的整合，您可以進行以下操作：

• 查看整合：如果您需要查看整合的詳細資料，單擊目的地組成所在行，在整合詳情頁面查看整合的詳細資料。

• 更新密鑰：如果您需要修改整合的密鑰，在目的地組成右側操作列選擇更多 > 更新密钥，在彈出的對話方塊中單擊确认。

  重要

  更新密鑰後，請參考步驟二重新安裝ARMS警示管理。

• 編輯：如果您需要修改整合資訊，在目的地組成右側操作列單擊編輯，在整合詳情頁面修改整合資訊，然後單擊儲存。

• 啟用或禁用：如果您需要啟用或禁用目的地組成，在目的地組成右側操作列單擊禁用或啟用。

• 刪除：如果您需要刪除整合，在目的地組成右側操作列單擊刪除，在彈出的對話方塊中單擊確認。

• 添加事件流：如果您需要為指定整合添加對應的事件處理流，在目的地組成右側操作列單擊添加事件流。具體操作，請參見事件處理流。

• 建立通知策略：如果您需要為指定整合添加對應的通知策略，在目的地組成右側操作列單擊建立通知策略。具體操作，請參見通知策略。