簡介
本文檔介紹如何使用REST API在AppDynamics中配置自定義事件並將其連線到運行狀況規則以進行自動警報。
必要條件
- 訪問AppDynamics SaaS或本地控制器例項
- 建立和管理事件、運行狀況規則和策略的許可權
- 控制器版本21.x或更高版本
- 已配置通知管道(電子郵件、SMS或第三方整合)
- 基本瞭解REST API和AppDynamics使用者介面
需求
開始之前,請確保符合以下要求:
- AppDynamics Controller版本21.x或更高版本(用於最新的事件和警報功能)
- 為控制器啟用REST API訪問
- 為警報傳遞配置的通知管道(電子郵件、簡訊或整合)
採用元件
- AppDynamics控制器
- AppDynamics代理
- 通知管道
本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除(預設)的組態來啟動。如果您的網路運作中,請確保您瞭解任何指令可能造成的影響。
背景資訊
在雲原生架構日益動態化的世界中,主動監控對於確保系統恢復能力和減少平均解決時間(MTTR)至關重要。 AppDynamics提供了強大的可觀察功能,包括能夠建立自定義事件和警報,以幫助運營團隊更快地檢測異常並精確響應。
開箱即用的衡量標準至關重要,但現代系統通常需要特定情境的可觀測性。無論您是整合CI/CD管道、自定義自動化工具還是外部系統,向AppDynamics中注入自定義事件都可以確保:
- 跨系統和業務指標的統一可視性
- 應用特定異常的即時檢測
- 通過自動化操作減少手動干預
有時,建立自定義事件來監控應用程式的特定方面是很有意義的。本文旨在指導您如何通過AppDynamics控制器中的REST API建立自定義事件,以及如何根據自定義事件設定警報。
設定
本節介紹在AppDynamics Controller中建立自定義事件和配置警報的逐步過程。
組態
步驟 1:通過REST API建立自定義事件
可以使用AppDynamics REST API生成自定義事件。這對於整合外部系統、自定義指令碼、自動化框架或第三方工具非常有用:
API呼叫示例:
POST https:///controller/rest/applications//events?severity=ERROR&summary=Application+Stopped&eventtype=CUSTOM&customeventtype=App_Stop&comment=Please_start_application
關鍵引數:
- 將<controller-url>和<application_id>替換為控制器詳細資訊。
- 所需引數:
- 嚴重性(資訊、警告、錯誤)
- summary(簡短說明)
- 事件型別(必須為CUSTOM)
- customeventtype(您的自定義事件型別標籤)
- 註釋(可選詳細消息)
成功的請求會返回確認建立的事件ID
範例:"已成功建立事件ID:550346816"
可視性提示:不要忘記在Events UI中啟用Custom篩選器以檢視注入的事件。

步驟 2:過濾和監控自定義事件
- 在控制器UI中,導航到Events部分。
- 使用Filter by Custom Events新增事件型別或屬性。
- 您可以指定鍵/值對以進行更精細的篩選。
- 使用All for AND邏輯(所有屬性必須匹配),或使用Any for OR邏輯(至少一個屬性匹配)
這樣,就可以針對整個應用程式中的注入事件進行跟蹤和調查。
步驟 3:配置警報:操作和策略
動作:
- 指定觸發自定義事件(例如傳送電子郵件、簡訊或呼叫Webhook)時會發生的情況:

策略:
- 建立新策略或編輯現有策略:

- 在策略中,配置自定義事件過濾器以匹配您定義的自定義事件。


- 在策略操作頁籤中,新增新操作並選擇您建立的自定義操作:

- 儲存警報:配置警報後,按一下Save建立警報:

建立警報後,只要在控制器中生成與指定條件匹配的自定義事件,就會觸發警報。
驗證
- 通過REST API發佈測試自定義事件:

- 在Events UI中確認可見性(檢查過濾器):

- 驗證是否為自定義事件觸發了操作:



疑難排解
問題 |
疑難排解步驟 |
事件不可見
|
- 確保Custom篩選器在Events UI中啟用了Eventtype
- 按兩下API呼叫中的eventtype和customeventtype引數。
|
API錯誤
|
- 常見錯誤:"未指定事件摘要。" 始終在請求中提供摘要
- 驗證API呼叫中的身份驗證和應用程式ID。
|
未觸發警報
|
- 確認運行狀況規則和策略配置正確。
- 檢查通知通道設定(電子郵件/簡訊伺服器配置)。
|
自定義事件限制
|
- 控制器對自定義事件架構計數和事件大小具有限制。
- 如果發佈大卷或複雜的架構,請檢視文檔
|
結論
AppDynamics中的自定義事件和警報提供了豐富可觀察性策略的強大方式。無論您是與CI/CD工具、外部服務整合,還是只是將可視性擴展到關鍵工作流程,這些功能都可以確保更快地檢測和解決問題,以免問題影響使用者。開始利用自定義的可觀察性智慧將您的監控從被動提升為預測性。
需要進一步協助
如果您遇到問題或遇到問題,請聯絡AppDynamics支援並包括錯誤消息、配置資訊或相關日誌等詳細資訊,以幫助加快故障排除速度。
相關資訊