ARMS アラート管理に Open-Falcon をアラートソースとして統合 - Application Real-Time Monitoring Service - Alibaba Cloud - Application Real-Time Monitoring Service

このトピックでは、Open-Falcon をアラート管理に統合する方法について説明します。

ステップ 1： Open-Falcon 統合の作成

ARMS コンソールにログインします。左側のナビゲーションウィンドウで、[アラート管理] > [統合] を選択します。
アラート統合 タブで [OpenFalcon] をクリックします。
[New OpenFalcon Integration] ページで、統合名、説明、自動復旧時間を入力し、保存をクリックします。

説明
指定された期間内にアラートイベントが再度トリガーされない場合、アラートイベントは自動的にクリアされます。
アラート統合 タブで、検索ボックスで作成した Open-Falcon 統合を検索し、統合アドレスをコピーします。

ステップ 2： Open-Falcon アラートテンプレートの設定

Open-Falcon をインストールして開きます。プラグインは Open-Falcon の公式サイトからダウンロードしてインストールできます。
上部メニューで [Templates] をクリックします。
[Templates] ページの右上隅で、新しいアラートテンプレートの名前を入力し、[+] アイコンをクリックします。
[Configure Template] ページで、[Policies in the Template] セクションにアラートルールを作成します。詳細については、「Open-Falcon のドキュメント」をご参照ください。
テンプレート設定ページで、コールバックアドレスをステップ 1 で取得した統合アドレスに設定し、[Save] をクリックします。

(オプション) ステップ 3：統合の変更

アラート管理には、Open-Falcon のアラートソースと ARMS 間のフィールドマッピングが事前設定されています。必要に応じて、統合の編集 ページでフィールドマッピングを追加または変更することもできます。

アラートソースのサンプル：

{
    "name":"cpu alert",
    "endpoint":"test-host",
    "metric":"cpu.user",
    "status":"PROBLEM",
    "step":"1",
    "priority":2,
    "time":"2021-09-08 09:25:00",
    "tpl_id":1,
    "exp_id":2,
    "stra_id":1,
    "tags":""
}

[アラートの統合] タブで、管理する統合を見つけて、[編集] を [アクション] 列でクリックします。
[イベントマッピング] セクションで、[テストデータを送信] をクリックします。
[テストデータを送信] ダイアログボックスで、JSON 形式でサードパーティアラートソースのアラートコンテンツを入力し、[送信] をクリックします。
説明
- [アップロードされました。イベントは生成されません。元のデータに基づいてマッピングを設定してください。] というメッセージが表示された場合、アラートソースのフィールドは ARMS アラートイベントのフィールドにマッピングされていません。送信されたデータは左側のボックスに表示されます。これにより、マッピングを設定するときにソースフィールドを選択できます。
- [アップロードされました。] というメッセージが表示された場合、アラート内容はアラートイベント履歴ページに報告されます。詳細については、「履歴アラートイベントを表示する」をご参照ください。
[テストデータの送信] ダイアログボックスで、[無効化] をクリックします。
[イベントマッピング] セクションの左側で、マッピングを設定するデータレコードをクリックして詳細を表示します。

イベントマッピング セクションの右側で、アラートソースのフィールドを ARMS のアラートフィールドにマッピングします。

オプション:[ルートノードを選択] セクションで、バッチ処理を有効にするかどうかを指定します。
アラートデータに配列ノードが存在する場合、配列ノードをルートノードとして指定できます。ルートノードに属するデータはバッチで処理されます。
バッチ処理を使用を選択した後、バッチ処理する配列ノードをルートノードとして選択します。
説明
アラートデータに複数の配列ノードが存在する場合、バッチ処理用に配列ノードを 1 つだけ選択できます。

[ソースフィールドをターゲットフィールドにマップ] セクションで、アラートソースのフィールドを ARMS のアラートフィールドにマップします。

マッピングアイコンをクリックして、フィールドマッピングの方法を変更します。

直接: アラートソースの指定されたフィールドは、ARMS の指定されたアラートフィールドに直接マッピングされます。
シリーズ: デリミタを使用してアラートソースの複数のフィールドを 1 つのフィールドに連結し、このフィールドを ARMS の指定されたアラートフィールドにマッピングできます。特殊文字のみをデリミタとして使用できます。
条件付き: 指定されたアラートソースフィールドは、フィールド値が指定された条件を満たす場合にのみ、ARMS アラートフィールドにマッピングされます。
マッピングテーブル: アラートソースの重大度は ARMS アラートの重大度にマッピングされます。マッピングテーブルには、重大度フィールドのみが含まれています。

次の表に、ARMS のアラートフィールドを示します。

アラートフィールド	説明
alertname	カスタムアラートの名前。
severity	アラートの重大度レベル。このフィールドのマッピングを設定する必要があります。マッピング方法は「直接」に設定する必要があります。
message	アラートの説明。説明は、アラートメッセージの内容として使用されます。説明は 15,000 文字を超えることはできません。
value	メトリックのサンプル値。
imageUrl	Grafana メトリックを含む折れ線グラフの URL。URL は、折れ線グラフをマッピングするために使用されます。
check	アラートのチェック項目。例: CPU、JVM、アプリケーションクラッシュ、デプロイメント。
source	アラートのソース。
class	アラートイベントをトリガーするオブジェクトのタイプ。例: ホスト。
service	アラートのソースサービス。例: ログインサービス。
startat	イベントの開始日時を表すタイムスタンプ。
endat	イベントの終了日時を表すタイムスタンプ。
generatorUrl	イベント詳細の URL。

アラートイベントのフィールド重複排除を設定します。
重複データを削減するために、システムは関連フィールドを重複排除の基準として使用します。ARMS アラート管理では、[イベントマッピング] セクションに表示される履歴イベントデータの重複排除グループ化結果をプレビューできます。重複排除されるフィールドを変更できます。
説明
クリアされていないイベントに対してのみ重複排除を設定できます。
1. [イベントの重複排除] ページの [連携の詳細] セクションで、重複排除に使用するフィールドを選択します。
  複数のイベントが指定されたフィールドで同じ値を持つ場合、イベントは 1 つのアラート通知にマージされます。
2. [重複排除テスト] をクリックして、重複排除後のアラートグループをプレビューします。
  説明
  重複排除テストは、[イベントマッピング] セクションの左側にアップロードされた最新の 10 件のデータレコードに対してのみ有効です。
設定が完了したら、[保存] をクリックします。

アラートイベントの詳細を表示する

ARMS コンソールの左側のナビゲーションウィンドウで、[アラート管理] > [アラートイベント履歴] を選択します。
[アラートイベント履歴] ページで、アラートイベントの名前をクリックしてイベント詳細を表示します。詳細については、「履歴アラートイベントを表示する」をご参照ください。

統合の管理

左側のナビゲーションウィンドウで、[アラート管理] > [統合] を選択します。[アラート統合] タブで、作成した統合に対して次の操作を実行できます。

統合の詳細を表示する: 統合を見つけて、行をクリックします。[統合の詳細] ページで、統合の詳細を表示します。
キーの更新：対象の統合を検索し、操作列で詳細 > キーの更新 を選択します。確認ダイアログボックスで確認をクリックします。

重要
キーを更新した後、ステップ 2： Open-Falcon アラートテンプレートの設定で説明されているように、アラートテンプレートのコールバックアドレスも更新する必要があります。
統合を変更する: 統合を見つけて、[アクション] 列の [編集] をクリックします。[統合の詳細] ページで、統合情報を変更し、[保存] をクリックします。
統合を有効または無効にする: 統合を見つけて、[アクション] 列の [無効化] または [有効化] をクリックします。
統合を削除する: 統合を見つけて、[アクション] 列の [削除] をクリックします。表示されるメッセージで、[OK] をクリックします。
統合にイベント処理フローを追加する: 統合を見つけて、[アクション] 列の [イベント処理フローを追加] をクリックします。詳細については、「イベント処理フローを操作する」をご参照ください。
通知ポリシーを作成する: 通知ポリシーを作成する統合を見つけて、[アクション] 列の [詳細] をクリックします。表示されるリストで、[通知ポリシーを作成] をクリックします。詳細については、「通知ポリシーを作成および管理する」をご参照ください。

次のステップ

通知ポリシーを作成した後、システムは、作成した通知ポリシーに基づいて、報告されたアラートイベントのアラートを生成し、アラート通知を送信します。詳細については、「通知ポリシーを作成および管理する」をご参照ください。[アラート送信履歴] ページで、設定された通知ポリシーに基づいて生成されたアラートを表示できます。詳細については、「アラート履歴を表示する」をご参照ください。