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