1 メディアタイプ

概要

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

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

メディアタイプは Alerts > Media types で管理します。一部のメディアタイプは、デフォルトデータセットにあらかじめ定義されています。
必要なのは、それらが動作するようにパラメータを調整することだけです。

メディアタイプがアラート通知の流れの中でどのように位置付けられるかを理解するために、Zabbix からエンドユーザーへ通知を配信するために必要な 3 つの要件を見てみましょう。

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

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

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

詳細なテスト手順については、以下も参照してください。

設定

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

  • 次へ移動します: Alerts > Media types
  • Create media type をクリックします
  • フォームにメディアタイプのパラメータを入力します

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

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

方法固有のパラメータについては、emailSMScustom alertscript、または webhook のページを参照してください。

メッセージテンプレート

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

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

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

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

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

オプション

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

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

パラメータ 説明
同時セッション メディアタイプで使用する並列アラートセッションの数を選択します。
1 - 1セッション
無制限 - セッション数を無制限にする
カスタム - セッション数を指定する
無制限または大きな値を設定すると、並列セッション数が増え、通知の送信容量が向上します。無制限または大きな値は、多数の通知を同時に送信する必要がある大規模な環境で使用してください。
同時セッション数を超える通知を送信する必要がある場合、残りの通知はキューに入れられます。通知が失われることはありません。
試行回数 通知の送信を試行する回数です。最大100回まで指定できます。デフォルト値は「3」です。「1」を指定した場合、Zabbixは通知を1回だけ送信し、送信に失敗しても再試行しません。
試行間隔 送信に失敗した場合に通知の再送を試行する間隔を秒単位で指定します(0-3600)。「0」を指定した場合、Zabbixは直ちに再試行します。
時間のサフィックスがサポートされています(例: 30s1m1h)。

ユーザーメディア

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

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

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

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

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