1 メディアタイプ

概要

メディアタイプは、Zabbix から通知やアラートを送信するために使用される配信チャネルです。

メディアタイプは、次の配信方法をサポートしています。

メディアタイプは、アラート > メディアタイプ で管理されます。一部のメディアタイプは、デフォルトのデータセットにあらかじめ定義されています。
動作させるには、それらのパラメータを微調整するだけで済みます。

メディアタイプがアラート処理の中でどのように組み込まれているかを確認するために、Zabbix からエンドユーザーへ通知を配信するための 3 つの要件を見てみましょう。

  1. 通知を送信するアクション操作を定義する必要があります
  2. 動作するメディアタイプを定義する必要があります(SMTP を使用してアラートを送信する Email など)
  3. ユーザーメディアで、ユーザーレベルの配信先情報(メールアドレス、電話番号など)を定義する必要があります
メディアタイプのテスト

設定済みのメディアタイプが機能するかどうかをテストするには、メディアタイプ一覧で テスト をクリックします。

テスト要求はZabbixサーバーに送信されます。Zabbixサーバーは、指定されたメディアタイプを使用してアラートの送信を試み、その結果をWebインターフェースに返します。Webインターフェースは、サーバーから結果が返されるのを待機します。メディアタイプのテストのタイムアウトはデフォルトで65秒です(管理 > 一般 > タイムアウト で設定可能)。

以下のテストの詳細も参照してください。

設定

Zabbix Webインターフェースでメディアタイプを作成するには、次の手順を実行します。

  • アラート > メディアタイプ に移動します
  • メディアタイプの作成 をクリックします
  • フォームにメディアタイプのパラメータを入力します

一部のパラメータは、すべての配信方法で共通です。

パラメータ 説明
Name メディアタイプの名前。
Type メディアタイプの配信方法を選択します。
Description メディアタイプの説明を入力します。
Enabled チェックボックスをオンにしてメディアタイプを有効にします。

方法固有のパラメータについては、emailSMSカスタムアラートスクリプト、または webhook のページを参照してください。

メッセージテンプレート

メッセージテンプレートタブには、イベントタイプごと(障害、障害復旧、ディスカバリなど)のデフォルトメッセージが含まれています。

追加をクリックしてデフォルトメッセージを定義します(既存のメッセージを更新する場合は編集):

Parameter Description
Message type デフォルトメッセージを使用するイベントのタイプ。
各イベントタイプにつき定義できるデフォルトメッセージは1つだけです。
Subject デフォルトメッセージの件名。件名にはマクロを含めることができます。255文字までに制限されています。
SMSメディアタイプでは件名は使用できません。
Message デフォルトメッセージ。データベースの種類に応じて文字数の上限があります(詳細はメッセージの送信を参照)。
メッセージには、サポートされているマクロを含めることができます。
障害メッセージおよび障害更新メッセージでは、式マクロがサポートされています(例: {?avg(/host/key,1h)})。

action operations で定義されている場合、デフォルトメッセージはカスタムメッセージによって上書きされることに注意してください。

メッセージテンプレートの定義は、通知にデフォルトメッセージを使用しない webhook やカスタムアラートスクリプトを含む、すべての配信方法で必須です。
たとえば、Pushover webhook へのメッセージ送信アクションでは、Pushover webhook 用の障害メッセージが定義されていない場合、障害通知の送信に失敗します。

オプション

オプションタブには、アラート処理の設定が含まれています。
同じ一連のオプションを各メディアタイプごとに設定できます。

すべてのメディアタイプは並列に処理されます。
同時セッションの最大数はメディアタイプごとに設定できますが、
サーバー上のアラート送信プロセスの総数は、StartAlerters parameter によってのみ制限できます。
1つのトリガーによって生成されたアラートは順次処理されます。
そのため、複数の通知が同時に処理されるのは、それらが複数のトリガーによって生成された場合に限られます。

Parameter Description
Concurrent sessions メディアタイプの並列アラート送信セッション数を選択します:
One - 1セッション
Unlimited - セッション数無制限
Custom - カスタムのセッション数を選択
Unlimited/高い値は、より多くの並列セッションと、通知送信容量の増加を意味します。Unlimited/高い値は、多数の通知を同時に送信する必要がある大規模環境で使用してください。
同時セッション数を超える通知を送信する必要がある場合、残りの通知はキューに入れられます。通知が失われることはありません。
Attempts 通知送信を試行する回数です。最大100回まで指定でき、デフォルト値は「3」です。「1」を指定した場合、Zabbix は通知を1回だけ送信し、送信に失敗しても再試行しません。
Attempt interval 送信に失敗した場合に通知の再送信を試みる間隔を秒単位で指定します (0-3600)。「0」を指定した場合、Zabbix は即座に再試行します。
時間のサフィックスを使用できます。例: 5s、3m、1h。

ユーザーメディア

メディアタイプは通知をどのように送信するかを定義するのに対し、ユーザーメディアは通知をどこに送信するかを定義します。

ユーザーメディア(例: メールアドレス、webhookユーザーID など)は、配信方法に関係なく、ユーザープロファイルで定義する必要があります。webhook X を使用して Admin ユーザーにメッセージを送信するアクションは、Admin ユーザープロファイルに webhook X の配信先詳細が定義されていない場合、配信に失敗します。

ユーザーメディアを定義するには:

  • Users > Users に移動してユーザーのプロパティフォームを開きます(または、自分のユーザープロファイルの User settings > Notifications に移動します)
  • メディアタブで Add をクリックします

Parameter Description
Type ドロップダウンリストには、有効なメディアタイプの名前が表示されます。
無効なメディアタイプのメディアを編集中の場合、そのタイプは赤色で表示されることに注意してください。
Send to メッセージの送信先となる連絡先情報を入力します。
メールメディアタイプでは、アドレス欄の下にある ボタンをクリックすることで、複数のアドレスを追加できます。この場合、通知は一覧にあるすべてのアドレスに送信されます。アドレスの例については、メディアタイプ emailEmail パラメータの説明を参照してください。
When active メッセージを送信する時間を制限できます。たとえば、稼働日のみ(1-5,09:00-18:00)に設定できます。この制限はユーザーのタイムゾーンに基づくことに注意してください。ユーザーのタイムゾーンが変更され、システムのタイムゾーンと異なる場合は、重要なメッセージを見逃さないように、この制限をそれに応じて調整する必要がある場合があります。
形式の説明については、期間指定ページを参照してください。
ユーザーマクロを使用できます。
Use if severity 通知を受け取りたいトリガーの深刻度のチェックボックスをオンにします。
トリガー以外のイベントの通知を受け取りたい場合は、デフォルトの深刻度('Not classified')を必ずチェックする必要があることに注意してください。
保存後、選択したトリガーの深刻度は対応する深刻度の色で表示され、未選択のものはグレー表示になります。
Status ユーザーメディアのステータスです。
Enabled - 使用中です。
Disabled - 使用されていません。