メディアタイプ
概要
メディアタイプは、Zabbix から通知やアラートを送信するために使用される配信チャネルです。
メディアタイプは、以下の配信方法をサポートしています。
メディアタイプは、Alerts > Media types で管理されます。一部のメディアタイプは、デフォルトのデータセットにあらかじめ定義されています。
動作させるには、それらのパラメータを微調整するだけで済みます。

メディアタイプがアラート処理の中でどのように位置付けられるかを確認するために、Zabbix からエンドユーザーへ通知を配信するための3つの要件を見てみましょう。
- 通知を送信するアクション操作を定義する必要があります
- 動作するメディアタイプを定義する必要があります(SMTP を使用してアラートを送信する Email など)
- ユーザーレベルの配信先情報(メールアドレス、電話番号など)を ユーザーメディア で定義する必要があります
メディアタイプのテスト
設定済みのメディアタイプが動作するかをテストするには、メディアタイプ一覧で Test をクリックします。
テスト要求は Zabbix サーバーに送信されます。Zabbix サーバーは指定されたメディアタイプを使用してアラートの送信を試み、その結果を Webインターフェースに返します。Webインターフェースはサーバーが結果を返すまで待機します。メディアタイプのテストには、既定で 65 秒のタイムアウトがあります(Administration > General > Timeouts で設定可能です)。
テストの詳細については、以下も参照してください。
設定
ZabbixのWebインターフェースでメディアタイプを作成するには、次の手順に従います。
- アラート > メディアタイプ に移動します。
- メディアタイプの作成 をクリックします。
- フォームにメディアタイプのパラメータを入力します。
一部のパラメータは、すべての配信方法で共通です。
Webインターフェース設定ファイル(zabbix.conf.php)の $ZBX_FEATURE_FLAGS['media_type_denylist'] 機能フラグに1つ以上の配信方法が指定されている場合、それらの配信方法は タイプ リストで使用できません。

| パラメータ | 説明 |
|---|---|
| 名前 | メディアタイプの名前。 |
| タイプ | メディアタイプの配信方法を選択します。 |
| 説明 | メディアタイプの説明を入力します。 |
| 有効 | メディアタイプを有効にするには、チェックボックスを選択します。 |
方法固有のパラメータについては、メール、SMS、カスタムalertscript、または webhook のページを参照してください。
メッセージテンプレート
メッセージテンプレート タブには、イベントタイプごとのデフォルトメッセージ(障害、障害復旧、ディスカバリなど)が含まれます。

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

| Parameter | Description |
|---|---|
| Message type | デフォルトメッセージを使用するイベントの種類。 各イベントタイプにつき、定義できるデフォルトメッセージは 1 つだけです。 |
| Subject | デフォルトメッセージの件名。件名にはマクロを含めることができます。255 文字までです。 件名は SMS メディアタイプでは使用できません。 |
| Message | デフォルトメッセージです。データベースの種類に応じて、使用できる文字数に制限があります(詳細は メッセージの送信 を参照してください)。 メッセージには、サポートされている マクロ を含めることができます。 障害および障害更新メッセージでは、式マクロがサポートされています(例: {?avg(/host/key,1h)})。 |
デフォルトメッセージは、アクション オペレーション で定義されている場合、カスタムメッセージによって上書きされることに注意してください。
メッセージテンプレートの定義は、webhook やカスタムアラートスクリプトを含むすべての配信方法で必須です。これらは通知にデフォルトメッセージを使用しません。
たとえば、アクション「Send message to Pushover webhook」は、Pushover webhook の障害メッセージが定義されていない場合、障害通知の送信に失敗します。
オプション
オプションタブには、アラート処理の設定が含まれています。
同じオプションセットをメディアタイプごとに設定できます。
すべてのメディアタイプは並列で処理されます。
同時セッションの最大数はメディアタイプごとに設定できますが、
サーバー上のアラートプロセスの総数は、StartAlerters パラメータでのみ制限できます。
1つのトリガーによって生成されたアラートは順番に処理されます。
そのため、複数の通知が同時に処理されるのは、複数のトリガーによって生成された場合のみです。

| パラメータ | 説明 |
|---|---|
| 同時セッション数 | メディアタイプで使用する並列アラートセッションの数を選択します。 1 - 1セッション 無制限 - セッション数を無制限にする カスタム - セッション数を指定する 無制限または大きな値を設定すると、より多くのセッションを並列で実行でき、通知の送信容量が増加します。無制限または大きな値は、多数の通知を同時に送信する必要がある大規模な環境で使用してください。 同時セッション数を超える通知を送信する必要がある場合、残りの通知はキューに入れられます。通知が失われることはありません。 |
| 試行回数 | 通知の送信を試行する回数です。最大100回まで指定できます。デフォルト値は「3」です。「1」を指定した場合、Zabbixは通知を1回だけ送信し、送信に失敗しても再試行しません。 |
| 試行間隔 | 送信に失敗した場合に通知の再送を試行する間隔を秒単位で指定します(0~3600)。「0」を指定した場合、Zabbixは直ちに再試行します。 時間のサフィックスがサポートされています(例: 30s、1m、1h)。 |
ユーザーメディア
メディアタイプでは通知の送信方法を定義するのに対し、ユーザーメディアでは通知の送信先を定義します。
ユーザーメディア(メールアドレス、webhookユーザーIDなど)は、配信方法にかかわらず、ユーザープロファイルで定義する必要があります。webhook X を使用して Admin ユーザーにメッセージを送信するアクションは、webhook X の配信先情報がAdminユーザーのプロファイルに定義されていない場合、配信に失敗します。
ユーザーメディアを定義するには、次の手順に従います。
- Users > Users に移動し、ユーザープロパティフォームを開きます。 または、自分のユーザープロファイルの User settings > Notifications に移動します。
- Media タブで Add をクリックします。
- フォームにユーザーメディアのパラメータを入力します。

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