メール
概要
メッセージの配信チャネルとしてメールを設定するには、メールをメディアタイプとして設定し、特定のアドレスをユーザーに割り当てる必要があります。
単一イベントに対する複数の通知は、同じメールスレッドにまとめられます。
設定
email をメディアタイプとして設定するには、次の手順を実行します。
- 障害 > メディアタイプ に移動します。
- メディアタイプの作成 をクリックします（または、事前定義されたメディアタイプの一覧で Email をクリックします）。
メディアタイプ タブには、メディアタイプの一般的な属性が含まれます。
必須入力フィールドには、赤いアスタリスクが付いています。
email メディアタイプの設定をエクスポートすると、パスワードは平文でエクスポートされます。
以下のパラメータは、email メディアタイプ固有のものです。
| Parameter | Description |
|---|---|
| Email provider | email プロバイダーを選択します: Generic SMTP、Gmail、Gmail relay、Office365、または Office365 relay。 Gmail/Office365 関連のオプションを選択した場合、送信者の email アドレスとパスワードのみを指定すればよく、SMTP server、SMTP server port、SMTP helo、Connection security などの項目は Zabbix により自動的に入力されます。詳細は Automated Gmail/Office365 media types を参照してください。 |
| SMTP server | 送信メッセージを処理する SMTP サーバーを設定します。 このフィールドは、email プロバイダーとして Generic SMTP を選択した場合に使用できます。 |
| SMTP server port | 送信メッセージを処理する SMTP サーバーポートを設定します。 このフィールドは、email プロバイダーとして Generic SMTP を選択した場合に使用できます。 |
| ここで入力したアドレスは、送信メッセージの From アドレスとして使用されます。 実際の email アドレスとともに送信者の表示名（上のスクリーンショットの Zabbix_info zabbix\@company.com にある "Zabbix_info" のようなもの）を追加できます。 Zabbix の email では、RFC 5322 で許可されている内容と比べて表示名にいくつか制限があります。例を以下に示します。 有効な例: zabbix\@company.com（email アドレスのみ。山括弧は不要） Zabbix_info zabbix\@company.com（表示名と山括弧付きの email アドレス） ∑Ω-monitoring zabbix\@company.com（表示名に UTF-8 文字を使用） 無効な例: Zabbix HQ zabbix\@company.com（表示名はあるが、email アドレスが山括弧で囲まれていない） "Zabbix\@\<H(comment)Q\>" zabbix\@company.com（RFC 5322 では有効ですが、Zabbix の email では quoted pair とコメントはサポートされません） |
|
| SMTP helo | 正しい SMTP helo 値を設定します。通常はドメイン名です。 空の場合、email のドメイン名（つまり Email フィールドの @ の後ろの部分）が送信されます。ドメイン名を取得できない場合は、デバッグレベルの警告がログに記録され、サーバーのホスト名が HELO コマンドのドメインとして送信されます。このフィールドは、email プロバイダーとして Generic SMTP を選択した場合に使用できます。 |
| Connection security | 接続セキュリティのレベルを選択します: None - CURLOPT_USE_SSL オプションを使用しません STARTTLS - CURLOPT_USE_SSL オプションを CURLUSESSL_ALL 値で使用します SSL/TLS - CURLOPT_USE_SSL の使用は任意です |
| SSL verify peer | SMTP サーバーの SSL 証明書を検証する場合にチェックボックスをオンにします。 証明書検証のため、サーバー設定ディレクティブ "SSLCALocation" の値は CURLOPT_CAPATH に設定されます。 これにより cURL オプション CURLOPT_SSL_VERIFYPEER が設定されます。 |
| SSL verify host | SMTP サーバー証明書の Common Name フィールドまたは Subject Alternate Name フィールドが一致することを検証する場合にチェックボックスをオンにします。 これにより cURL オプション CURLOPT_SSL_VERIFYHOST が設定されます。 |
| Authentication | 認証レベルを選択します: None - cURL オプションは設定されません Username and password - "AUTH=*" を意味し、認証方式の選択は cURL に委ねられます OAuth - OAuth 認証 OAuth 認証は Office365 relay email プロバイダーではサポートされていません。 |
| Username | 認証に使用するユーザー名。 これにより CURLOPT_USERNAME の値が設定されます。 ユーザーマクロ がサポートされます。 |
| Password | 認証に使用するパスワード。 これにより CURLOPT_PASSWORD の値が設定されます。 ユーザーマクロ がサポートされます。 ここで入力した値は、メディアタイプ設定をエクスポートするとそのままエクスポートされます。エクスポートされたファイルで機密認証情報が露出しないようにするには、文字列のパスワードの代わりにユーザーマクロ（たとえば {$EMAIL_SMTP_PASSWORD}）を使用してください。マクロ参照はエクスポートされ、秘密値は移行先システムで設定（または再設定）する必要があります。 |
| OAuth tokens | 新しいウィンドウで OAuth tokens を取得するためのパラメータを設定するには、Configure をクリックします。 このフィールドは、Authentication フィールドで "OAuth" が選択されている場合にのみ使用できます。 |
| Message format | メッセージ形式を選択します: HTML - HTML として送信 Plain text - プレーンテキストとして送信 |
SMTP 認証を有効にするには、Zabbix サーバーを --with-libcurl コンパイル オプション付きでビルドする必要があります。このオプションには libcurl が必要です（バージョンの詳細は server の要件を参照してください）。
デフォルトメッセージや障害処理オプションの設定方法については、common media type parameters も参照してください。
OAuthトークン
OAuthトークンを取得するには、以下のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
| リダイレクトエンドポイント | OAuth認証後にOAuthサービスがリダイレクトするZabbixフロントエンドのURLを入力します（形式：https://<zabbix-frontend-url>/zabbix.php?action=oauth.authorize）。フロントエンドURLが定義されている場合、新しいメールメディアタイプには自動的に設定されます。 |
| クライアントID | OAuth認証サーバーに登録されたクライアントアプリの一意の識別子を入力します。 |
| クライアントシークレット | OAuth認証サーバーに登録されたクライアントアプリの秘密鍵を入力します。 |
| 認証エンドポイント | ユーザー認証を要求するOAuth認証サーバーのURLを入力します。 |
| 認証パラメータ | 認証エンドポイントのパラメータを入力します。 |
| 認証コード | 認証コードを入力します： 自動 - リダイレクトページを介して自動的にコードを取得します 手動 - 自動取得に失敗した場合は手動でコードを入力します |
| トークンエンドポイント | 認証コードをアクセストークンおよびリフレッシュトークンと交換するためのOAuth認証サーバーのURLを入力します。 |
| トークンパラメータ | アクセストークンのパラメータを入力します。 |
OAuthトークンの取得は、Gmail、Gmailリレー、Office365のメールプロバイダーに対して自動化機能があります。リダイレクトエンドポイント、クライアントID、クライアントシークレットの値を入力するだけで十分です。Zabbixは他の必要な値を自動的に入力します（プロバイダー別のOAuth URLデフォルト値を参照）。
OAuthアクセストークンとリフレッシュトークンの取得
OAuthパラメータを送信した後:
-
ブラウザのポップアップが開き、ユーザーを認可エンドポイントに誘導します。
-
ユーザーはOAuthサービスでZabbixを認可します。
-
OAuthサービスは、認可コードとスコープ値を持って、ユーザーをZabbixフロントエンドアクション
oauth.authorizeにリダイレクトします。 -
その応答として、Zabbixはトークンエンドポイントにリクエストを行い、認可コードをアクセストークンとリフレッシュトークンに交換します。
テスト
設定したメールメディアタイプが正しく動作するかをテストするには、次の手順を実行します。
- 一覧 で該当するメールを見つけます。
- 一覧の最後の列にある Test をクリックします（テスト用ウィンドウが開きます）。
- Send to の宛先アドレス、メッセージ本文、必要に応じて件名を入力します。
- Test をクリックしてテストメッセージを送信します。
テストの成功または失敗メッセージは、同じウィンドウに表示されます。
ユーザーメディア
メールメディアタイプの設定が完了したら、ユーザー > ユーザー セクションに移動し、ユーザープロファイルを編集して、そのユーザーにメールメディアを割り当てます。
すべてのメディアタイプに共通するユーザーメディア設定の手順は、メディアタイプ ページで説明されています。