1 メディアタイプ

概要

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

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

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

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

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

設定したメディアタイプが動作するかどうかをテストするには、メディアタイプリストのテストをクリックします。

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

以下のテストもご覧ください。

設定

Zabbix フロントエンドでメディアタイプを作成するには:

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

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

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

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

メッセージテンプレート

メッセージテンプレート タブには、イベントタイプ(問題、問題復旧、検出など)ごとにデフォルトのメッセージが含まれています。

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

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

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

::: 注意事項 メッセージテンプレートの定義は、すべての配信方法(通知にデフォルトメッセージを使用しないWebhookやカスタムアラートスクリプトを含む)で必須です。 例えば、"Pushover Webhookにメッセージを送信"というアクションは、Pushover Webhookの問題メッセージが定義されていない場合、問題通知の送信に失敗します。 :::

オプション

オプション タブには、アラート処理に関する設定があります。

各メディアタイプに対して、同じオプションセットを設定できます。

すべてのメディアタイプは並列処理されます。 同時セッションの最大数はメディアタイプごとに設定できますが、 サーバー上のアラートプロセスの総数は StartAlerters パラメータ によってのみ制限されます。

1つのトリガーによって生成されたアラートは、順番に処理されます。 したがって、複数のトリガーによって生成された通知のみ、同時に処理できます。

パラメータ 説明
同時セッション数 メディアタイプごとに、同時アラータセッション数を選択します。
1 - 1セッション
無制限 - 無制限のセッション数
カスタム - カスタムのセッション数を選択
無制限/高い値は、同時セッション数が増加し、通知送信容量が増加します。多数の通知を同時に送信する必要がある大規模環境では、無制限/高い値を使用する必要があります。
同時セッション数よりも多くの通知を送信する必要がある場合、残りの通知はキューに入れられ、失われることはありません。
試行回数 通知送信の試行回数。最大100回まで指定できます。デフォルト値は'3'です。'1'を指定した場合、Zabbixは通知を1回だけ送信し、送信に失敗しても再試行しません。
試行間隔 送信に失敗した場合の通知の再送信頻度(秒単位、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 - 使用されていません。

Gmail/Office365 メディアタイプの自動設定

Gmail または Office365 をご利用の場合、メディアタイプの設定が簡素化されます。

メールメディアタイプ設定のメールプロバイダーフィールドでは、Gmail および Office 365 用の事前設定済みオプションを選択できます。

Gmail/Office365 関連のオプションを選択する際は、送信者のメールアドレスとパスワードを入力するだけで、有効なメディアタイプを作成できます。

メールアドレスとパスワードを入力すると、Zabbix は Gmail/Office365 メディアタイプの必要な設定すべてに、実際の値または推奨値(SMTP サーバーSMTP サーバーポートSMTP HELO接続セキュリティ)を自動的に入力します。この自動化により、これらのフィールドは表示されませんが、メディアタイプリスト(詳細列を参照)でSMTPサーバーとメールの詳細を確認できます。

以下の点にもご注意ください。

  • リレーオプションではパスワードは不要です。
  • Office365リレーの場合、指定されたメールアドレスのドメイン名がSMTPサーバーに動的に入力されます(つまり、example-com.mail.protection.outlook.comの"example.com"を実際の値に置き換えます)