外部イベント検出¶
本ドキュメントの位置づけ
本ドキュメントは、検出ルール設定フローの第2ステップです。設定完了後、メインドキュメントに戻り第3ステップ:インシデントへの関連付けを続けてください。
外部イベント検出機能は、サードパーティシステムからの異常レコードを受信するために使用されます。これらのレコードが、検出ルールで事前設定されたWebhookアドレスを介してシステムに送信されると、システムは自動的にそれを標準のモニターイベントに変換し、さらにアラートポリシーや可視化ダッシュボードに関連付けて、統一された監視管理を実現します。
この機能は、サードパーティシステム(Prometheus、Zabbix、Nagios など)で発生した異常イベントやレコードを、指定されたURLアドレスにPOSTリクエストでGuanceに送信し、イベントデータを生成することで、クロスプラットフォームでの統一アラート管理を実現します。
ユースケース¶
- サードパーティの監視システムと連携し、分散したアラートをGuanceプラットフォームに一元集約する
- カスタム業務システムの異常イベントを受信し、業務監視アラートを実現する
- マルチクラウド、ハイブリッドクラウド環境下の監視データを統合し、一元的に表示・分析する
デフォルト設定¶
基本設定¶
| 設定項目 | 説明 |
|---|---|
| モニター名 | カスタムモニター名。この外部イベント検出器を識別するために使用します。 |
| Webhook アドレス | システムが自動的に一意のWebhookアドレスを生成します。アドレスの用途をマークするためのカスタムパラメータの追加をサポートします。 形式: http://<ドメイン>/api/v1/push-events/<ランダム文字列>サードパーティシステムは、異常イベントをPOSTリクエストでこのアドレスに送信する必要があります。 |
詳細設定¶
変更イベントとしてマーク:有効にすると、このモニターが報告するすべてのイベントが自動的に変更イベントとして処理され、対応するエンティティのタイムラインに表示されます。システムはイベント自体のソースを変更せず、イベントセンターの既存のフィルタリングおよび統計ロジックには影響しません。
イベントデータ形式¶
外部イベントデータは、サードパーティシステムからGuanceセンターに能動的に報告され、必要なイベントデータが提供されます。対応するフィールドが検出・一致した場合のみ、イベントが生成され、異常レコードが作成されます。
必須フィールド(event オブジェクト内の以下の5つのフィールドがシステム側と一致する必要があります):
| フィールド | タイプ | 説明 |
|---|---|---|
status |
string | イベントステータス。指定可能な値:fatal(致命的)、error(重大)、warning(警告)、info(情報)、ok(正常) |
title |
string | イベントタイトル。イベントの核心内容を説明するために使用します。 |
message |
string | イベント詳細。イベントの具体的な情報を説明するために使用します。 |
dimension_tags |
object | ディメンションタグ。イベントのソースを識別するために使用します。例:{"host": "server01", "service": "nginx"} |
check_value |
number | 検出値。トリガー条件の判断に使用する数値です。 |
オプションフィールド:
| フィールド | タイプ | 説明 |
|---|---|---|
extraData |
object | カスタム拡張フィールド。イベント通知テンプレート内の変数置換に使用できます。 |
リクエスト例:
{
"event": {
"status": "warning",
"title": "外部イベントモニターテスト1",
"message": "こんにちは、これは外部イベントモニターのメッセージです",
"dimension_tags": {"heros": "caiwenji"},
"check_value": 20
},
"extraData": {
"name": "xxxxxxxx"
}
}
詳細については、外部イベントモニターイベント受信を参照してください。
後続設定¶
検出ルールの設定が完了したら、以下の関連設定も行う必要があります。
-
アラート設定:アラートポリシーを選択し、通知先とミュート期間を設定します;
-
関連付け:ダッシュボードに関連付け、データを素早く参照できるようにします;
-
権限:操作権限を設定し、このモニターを編集・削除できるユーザーを制御します;
-
エンティティへの関連付け:「変更イベントとしてマーク」を有効にすると、イベントは自動的に統合カタログ内の対応する名前のエンティティに関連付けられ、エンティティ詳細ページの「イベント」タブにあるタイムラインビューで変更履歴を確認できます。