Zabbix を Application Real-Time Monitoring Service (ARMS) のアラート管理システムと統合する方法 - Application Real-Time Monitoring Service

Zabbix はインフラストラクチャのアラートを生成しますが、複数の Zabbix インスタンスおよび通知チャネルにまたがってアラートを管理すると、規模が大きくなるにつれて困難になります。Zabbix を Application Real-Time Monitoring Service (ARMS) と統合することで、Zabbix のアラートイベントを一元化されたアラート管理プラットフォームへ転送できます。このプラットフォームでは、重複排除、重要度マッピング、柔軟な通知ルーティングが可能です。

この統合では、Zabbix サーバーにインストールする軽量のコネクタを使用します。このコネクタは、Zabbix 内で専用のユーザー、ユーザーグループ、メディアタイプ、および操作を自動的に作成し、アラートを ARMS へリレーします。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

Zabbix バージョン 5.x がインストールされ、実行中であること
管理者権限を持つ SSH アクセスが Zabbix サーバーに対して可能であること
Zabbix 管理者の認証情報（ユーザー名およびパスワード）を所持していること
ARMSが有効化済みのAlibaba Cloudアカウント

説明

Zabbix バージョン 5.x のみがサポートされています。

ARMS で Zabbix 統合を作成する

この手順では、Zabbix コネクタがアラートイベントを転送するために使用する統合エンドポイント URL を生成します。

ARMS コンソールにログインします。左側のナビゲーションウィンドウで、アラート管理 > 統合を選択します。
アラート統合 タブで、Zabbix をクリックします。
Zabbix 統合の作成 ダイアログボックスで、統合の名前および説明を入力し、自動回復時間を指定してから、保存をクリックします。
説明
自動回復時間内にアラートイベントが再度トリガーされない場合、ARMS はそのイベントを自動的にクリアします。
アラート統合 タブで、Zabbix 統合を検索し、統合アドレス 列から URL をコピーします。次のセクションでこの URL を使用します。

Zabbix サーバーへの ARMS アラートコネクタのインストール

この手順では、Zabbix と ARMS を接続するコネクタをインストールします。インストーラーは、必要な Zabbix リソース（ユーザー、ユーザーグループ、メディアタイプ、および操作）を自動的に作成します。

SSH で Zabbix サーバーにログインし、アラートスクリプトディレクトリを特定します。
```
   cat /etc/zabbix/zabbix_server.conf | grep alert
```

アラートスクリプトディレクトリに移動し、ARMS アラートコネクタパッケージをダウンロードして展開します。

   cd <alert-script-directory>
   wget http://arms-public.oss-cn-shanghai.aliyuncs.com/alerts/aliyunalertmanager.tgz
   tar -xzvf aliyunalertmanager.tgz

先ほどコピーした統合 URL を指定してインストーラーを実行します。<integration-url> を、ARMS の 統合アドレス 列からコピーした URL に置き換えてください。
```
   cd aliyunalertmanager/bin
   sh install.sh <integration-url>
```
プロンプトが表示されたら、以下の情報を入力します。
- Zabbix Web インターフェイスの URL（例： http://your-server/zabbix）
- Zabbix 管理者のユーザー名
- Zabbix 管理者のパスワード

統合の検証

インストール後、コネクタが Zabbix 内に以下の 4 つのリソースを作成したことを確認します。

リソースの種類	ナビゲーションパス	予期される名前
ユーザー	管理 > ユーザー	Aliyun Alert User
ユーザーグループ	管理 > ユーザーグループ	Aliyun Alert Group（Aliyun Alert User がメンバーであることを確認）
メディアタイプ	管理 > メディアタイプ	Aliyun Alert Media
操作	設定 > 操作	Aliyun Alert Action

エンドツーエンドの配信を検証するには、Zabbix でテストアラートをトリガーし、ARMS コンソールの アラート管理 > アラートイベント履歴 にそのアラートが表示されるかを確認します。

説明

インストール後に生成されたアラートイベントのみが ARMS へ転送されます。既存のイベントは遡及的に報告されません。アラートで報告されるデータをカスタマイズするには、Zabbix の Aliyun Alert Action 操作を編集してください。

ARMS でのアラートイベントの表示

ARMS コンソールで、アラート管理 > アラートイベント履歴 を選択します。
アラートイベント名をクリックして、詳細を表示します。

詳細については、「過去のアラートイベントを表示する」をご参照ください。

フィールドマッピングのカスタマイズ

ARMS では、Zabbix アラートソースと ARMS アラートイベント間のデフォルトフィールドマッピングが提供されています。マッピングを追加または変更するには、まずテストデータを送信し、その後マッピングルールを設定します。

テストデータの送信

アラート統合 タブで、統合を検索し、操作列の編集をクリックします。
イベントマッピング セクションで、テストデータの送信 をクリックします。
テストデータの送信 ダイアログボックスで、JSON 形式のアラートコンテンツを貼り付け、送信をクリックします。サンプルの Zabbix アラートペイロード：
- メッセージ アップロード完了。イベントは生成されませんでした。元のデータに基づいてマッピングを設定してください。 が表示された場合、ソースフィールドはまだマッピングされていません。アップロードされたデータは左ペインに表示され、参考として利用できます。
- メッセージ アップロード完了。 が表示された場合、アラートは アラートイベント履歴 ページに報告されています。
```
   {
       "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 つだけ選択できます。

ソースフィールドと ARMS アラートフィールドのマッピング

ソースフィールドからターゲットフィールドへのマッピング セクションで、各フィールド横のマッピングアイコンをクリックし、マッピング方法を選択します。

方法	説明
直接	ソースフィールドを ARMS アラートフィールドに直接マッピングします。
シリーズ	複数のソースフィールドを区切り文字（特殊文字のみ）で連結し、1 つの ARMS フィールドにマッピングします。
条件付き	ソースフィールドの値が指定された条件を満たす場合にのみ、ARMS フィールドにマッピングします。
マッピングテーブル	アラートソースの重要度を ARMS の重要度にマッピングします。重要度フィールドのみで利用可能です。

以下に、利用可能な ARMS アラートフィールドを示します。

アラートフィールド	説明
`alertname`	カスタムアラート名。
`severity`	アラートの重要度レベル。直接マッピング方法のみ使用可能です。
`message`	アラートの説明。通知内容として使用されます。最大 15,000 文字。
`value`	メトリックのサンプル値。
`imageUrl`	Grafana メトリック折れ線グラフの URL。
`check`	チェック項目（例：CPU、JVM、アプリケーションクラッシュ、デプロイメント）。
`source`	アラートソース。
`class`	イベントをトリガーしたオブジェクトの種類（例：ホスト）。
`service`	ソースサービス（例：ログインサービス）。
`startat`	イベント開始タイムスタンプ。
`endat`	イベント終了タイムスタンプ。
`generatorUrl`	イベント詳細の URL。

イベント重複排除の設定

重複通知を減らすため、ARMS は指定されたフィールドでイベントをグループ化します。重複排除フィールドの値が同じイベントは、1 つのアラートにマージされます。

イベント重複排除 セクションで、重複排除対象のフィールドを選択します。
重複排除テスト をクリックして、グループ化結果をプレビューします。
説明
重複排除テストは、イベントマッピング セクションにアップロードされた直近 10 件のデータレコードに対して実行されます。重複排除は未解決のイベントにのみ適用されます。
保存をクリックします。

統合の管理

アラート統合 タブでは、以下の操作を実行できます。

操作	手順
詳細の表示	統合の行をクリックして、統合の詳細ページを開きます。
キーの更新	列のその他 > キーの更新[アクション] を選択し、OKZabbix サーバーへの ARMS アラートコネクタのインストールをクリックします。キーを更新した後は、アラートコネクタを再インストールしてください。「」をご参照ください。
編集	操作列の編集をクリックし、設定を変更してから保存をクリックします。
有効化／無効化	操作列の有効化または無効化をクリックします。
削除	操作列の削除をクリックし、OK をクリックします。
イベント処理フローの追加	[アクション] 列で、[イベント処理フローの追加] をクリックします。詳細については、「イベント処理フローの操作」をご参照ください。
通知ポリシーの作成	列のその他 > 通知ポリシーの作成[操作]通知ポリシーの作成と管理を選択します。「」をご参照ください。

次のステップ

通知ポリシーを設定して、ARMS が受信した Zabbix イベントに対してアラートを生成し、通知を送信する方法を定義します。詳細については、「通知ポリシーの作成と管理」をご参照ください。

通知ポリシーによってトリガーされたアラートを確認するには、「履歴アラートの表示」をご参照ください。