[comment]: # ({56bf7160-56bf7160}) # 4 Webhook [comment]: # ({/56bf7160-56bf7160}) [comment]: # ({02b4d443-6584b266}) #### 概要 Webhookメディアタイプは、カスタムJavaScriptコードを使用してHTTPコールを行うのに便利で、ヘルプデスクシステム、チャット、メッセンジャーなどの外部ソフトウェアとの簡単な統合が可能です。 Zabbixが提供するインテグレーションをインポートするか、独自のインテグレーションをゼロから作成することができます。 [comment]: # ({/02b4d443-6584b266}) [comment]: # ({d863deaf-27a06b1f}) #### 連携 以下の連携が利用可能で、定義済みの webhook メディアタイプを使用して、Zabbix通知を次の宛先に送信できます。 - [brevis.one](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/brevis.one/README.md) - [Discord](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/discord/README.md) - [Event-Driven Ansible](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/event_driven_ansible/README.md) - [Express.ms messenger](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/express.ms/README.md) - [GitHub](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/github/README.md) - [GLPI](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/README.md) - [IBM Maximo Service Request](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/maximo_service_request/README.md) - [iLert](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/ilert/README.md) - [iTop](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/itop/README.md) - [Jira](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira/README.md) - [Jira Service Management](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira_service_management/README.md) - [ManageEngine ServiceDesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/manageengine_servicedesk/README.md) - [Mantis Bug Tracker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/mantisbt/README.md) - [Mattermost](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/mattermost/README.md) - [MS Teams](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams/README.md) - [MS Teams Workflows](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams-workflow/README.md) - [LINE](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/line/README.md) - [Opsgenie](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/opsgenie/README.md) - [OTRS CE](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/otrs_ce/README.md) - [Pagerduty](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pagerduty/README.md) - [Pushover](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover/README.md) - [Redmine](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/redmine/README.md) - [Rocket.Chat](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/rocketchat/README.md) - [ServiceNow](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/servicenow/README.md) - [SIGNL4](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/signl4/README.md) - [Slack](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/slack/README.md) - [SolarWinds](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/solarwinds/README.md) - [SysAid](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/sysaid/README.md) - [Telegram](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/telegram/README.md) - [TOPdesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/topdesk/README.md) - [VictorOps](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/victorops/README.md) - [Zammad](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/zammad/README.md) - [Zendesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/zendesk/README.md) ::: notetip ここに記載されているサービスに加えて、Zabbixは**Spiceworks**とも連携できます（webhook は不要です）。 Zabbix通知をSpiceworksチケットに変換するには、[メールメディアタイプ](/manual/config/notifications/media/email)を作成し、指定したZabbixユーザーのプロファイル設定にSpiceworksヘルプデスクのメールアドレス（例: help\@zabbix.on.spiceworks.com）を入力してください。 ::: [comment]: # ({/d863deaf-27a06b1f}) [comment]: # ({2ff62d0e-d84f1038}) #### 設定 webhook連携の使用を開始するには、次の手順を実行します。 1. ダウンロードしたZabbixバージョンの `templates/media` ディレクトリで必要な .yaml ファイルを探すか、Zabbixの[git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media)からダウンロードします。 2. ファイルをZabbixインストール環境に[インポート](/manual/xml_export_import/media#importing)します。 webhookはメディアタイプの一覧に表示されます。 3. *Readme.md* ファイルの手順に従ってwebhookを設定します（上のwebhook名をクリックすると、*Readme.md* にすばやくアクセスできます）。 一からカスタムwebhookを作成するには、次の手順を実行します。 1. *Alerts > Media types* に移動します。 2. *Create media type* をクリックします。 **Media type** タブには、このメディアタイプ固有のさまざまな属性が含まれています。 ![](../../../../../assets/en/manual/config/notifications/media/media_webhook_express.png){width="600"} 必須の入力フィールドには、赤いアスタリスクが付いています。 以下のパラメータは、webhookメディアタイプ固有のものです。 |Parameter|Description| |--|--------| |*Parameters*|webhook変数を属性と値のペアとして指定します。
事前設定済みのwebhookでは、パラメータの一覧はサービスによって異なります。パラメータの説明については、webhookの *Readme.md* ファイルを確認してください。
新しいwebhookでは、いくつかの共通変数がデフォルトで含まれます（URL:, HTTPProxy:, To:{ALERT.SENDTO}, Subject:{ALERT.SUBJECT}, Message:{ALERT.MESSAGE}）。これらはそのまま使用しても、削除してもかまいません。

webhookパラメータでは、[ユーザーマクロ](/manual/appendix/macros/supported_by_location_user)、問題通知でサポートされるすべての[マクロ](/manual/appendix/macros/supported_by_location)、および追加で {ALERT.SENDTO}、{ALERT.SUBJECT}、{ALERT.MESSAGE} マクロをサポートしています。

HTTPプロキシを指定する場合、このフィールドはアイテム設定の[HTTP proxy](/manual/config/items/itemtypes/http#configuration)フィールドと同じ機能をサポートします。プロキシ文字列には、使用するプロキシの種類を指定するために `[scheme]://` をプレフィックスとして付けることができます（例: https、socks4、socks5。詳細は[documentation](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html)を参照してください）。| |*Script*|パラメータフィールド内、またはその横にある鉛筆アイコンをクリックすると開くモーダルエディターに、JavaScriptコードを入力します。このコードがwebhook処理を実行します。
スクリプトは、パラメータと値のペアを受け取る関数コードです。値は JSON.parse() メソッドを使用してJSONオブジェクトに変換する必要があります。例: `var params = JSON.parse(value);`。

コードはすべてのパラメータにアクセスでき、HTTP GET、POST、PUT、DELETE リクエストを実行できるほか、CONNECT、PATCH、HEAD、OPTIONS、TRACE などの追加メソッドもサポートし、HTTPヘッダーとリクエストボディも制御できます。
スクリプトには return 演算子を含める必要があります。含まれていない場合は無効になります。OKステータスと任意のタグおよびタグ値の一覧（*Process tags* オプションを参照）またはエラー文字列を返すことができます。

復旧イベント（自動生成されたもの、または手動クローズの結果として生成されたものを問わず）はサーバーによって作成され、解決済みイベントタグ（テンプレート、ホスト、トリガーから継承されたタグを含む）を含みます。webhookスクリプトはアラート作成後に実行されるため、webhookスクリプトが返したタグは最初のアラート作成後にのみ追加され、初回の問題メッセージまたは即時の復旧メッセージの [{EVENT.TAGS}](/manual/appendix/macros/supported_by_location#eventtags) および [`{EVENT.RECOVERY.TAGS}`](/manual/appendix/macros/supported_by_location#eventrectags) マクロには含まれません。
*Note*: 各スクリプトが独自のデータで動作し、同時呼び出し間の衝突を避けるため、グローバル変数（例: `global = 1`）ではなくローカル変数（例: `var local = 1`）を使用することを推奨します（[known issues](/manual/installation/known_issues#preprocessing--global-variables-are-unsafe)を参照）。

以下も参照してください: [Webhook development guidelines](https://www.zabbix.com/documentation/guidelines/en/webhooks)、[Webhook script examples](/manual/config/notifications/media/webhook/webhook_examples)、[Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects)。
| |*Timeout*|JavaScriptの実行タイムアウト（1～60秒、デフォルトは30秒）。
時間サフィックスをサポートしています。例: 30s、1m。| |*Process tags*|返されたJSONプロパティ値をタグとして処理するには、チェックボックスをオンにします。これらのタグは、既存の問題タグに追加されます。
[webhook tags](https://www.zabbix.com/documentation/guidelines/en/webhooks#webhook-tags)を使用する場合、webhookは少なくとも空の tags オブジェクトを含むJSONオブジェクトを返す必要があることに注意してください: `var result = {tags: {}};`
返すことができるタグの例: *jira-id:prod-1234*、*responsible:John Smith*、*processed:*| |*Include event menu entry*|作成された外部チケットへのリンクを[event menu](/manual/web_interface/menu/event_menu)に含めるには、チェックボックスをオンにします。
有効化されていて、このチェックボックスがオンになっている各webhookについて、エントリが追加されます。*Menu entry name* および *Menu entry URL* パラメータに [{EVENT.TAGS.}](/manual/appendix/macros/supported_by_location#events) マクロが含まれている場合、これらのマクロを解決できるときのみエントリが追加されることに注意してください（つまり、イベントにこれらのタグが定義されている必要があります）。
このオプションを有効にした場合、webhookを異なるユーザーへの通知送信に使用すべきではありません（代わりに[専用ユーザー](/manual/config/notifications/media/webhook#user-media)の作成を検討してください）。また、[単一の問題イベント](/manual/config/notifications/media/webhook#configuring-alert-actions)に対して複数のアラートアクションで使用すべきでもありません。| |*Menu entry name*|メニューエントリ名を指定します。
[{EVENT.TAGS.}](/manual/appendix/macros/supported_by_location#events) マクロをサポートしています。
このフィールドは、*Include event menu entry* がオンの場合にのみ必須です。| |*Menu entry URL*|メニューエントリのリンク先URLを指定します。
[{EVENT.TAGS.}](/manual/appendix/macros/supported_by_location#events) マクロをサポートしています。
このフィールドは、*Include event menu entry* がオンの場合にのみ必須です。| デフォルトメッセージおよびアラート処理オプションの設定方法の詳細については、[共通メディアタイプパラメータ](/manual/config/notifications/media#common-parameters)を参照してください。 ::: notewarning webhookがデフォルトメッセージを使用しない場合でも、このwebhookで使用される操作タイプのメッセージテンプレートは定義しておく必要があります。 ::: [comment]: # ({/2ff62d0e-d84f1038}) [comment]: # ({f9688d90-e5e73ea8}) #### テスト 設定済みのWebhookメディアタイプをテストするには: 1. [メディアタイプの一覧](/manual/config/notifications/media#overview)から該当するWebhookを探します。 2. 一覧の最終列にある*テスト*をクリックします(テスト用ウィンドウが開きます)。 3. 必要に応じてWebhookパラメータの値を編集します。 マクロを例示値に置き換えてください。そうしないとマクロが解決されず、テストが失敗します。 4. *テスト*をクリックします。 テストウィンドウで値を置き換えたり削除したりしても、テスト手順のみに影響し、実際のWebhook属性値は変更されません。 ![](../../../../../assets/ja/manual/config/webhook_test1.png){width="600"} テストウィンドウを閉じずにメディアタイプのテストログエントリを表示するには、*ログを開く*をクリックします(新しいポップアップウィンドウが開きます)。 ![](../../../../../assets/ja/manual/config/mediatype_test2.png){width="600"} [comment]: # ({/f9688d90-e5e73ea8}) [comment]: # ({817ae9ce-b2974109}) **Webhookテストが成功した場合：** - *"Media type test successful."* メッセージが表示されます。 - サーバーのレスポンスがグレーの *Response* フィールドに表示されます。 - レスポンスタイプ（JSONまたはString）が *Response* フィールドの下に表示されます。 [comment]: # ({/817ae9ce-b2974109}) [comment]: # ({d11e9918-abfbc807}) **Webhookテストが失敗した場合:** - *"メディアタイプのテストに失敗しました。"* というメッセージが表示され、続いて追加の失敗の詳細が表示されます。 [comment]: # ({/d11e9918-abfbc807}) [comment]: # ({22965c08-6eeec89a}) #### ユーザーメディア メディアタイプの設定が完了したら、*Users > Users* セクションに移動し、既存のユーザーに webhook メディアを割り当てるか、webhook を表す新しいユーザーを作成します。 既存ユーザーに対するユーザーメディアの設定手順は、すべてのメディアタイプで共通であり、[メディアタイプ](/manual/config/notifications/media#user-media) ページで説明されています。 webhook がタグを使用してチケット\\メッセージIDを保存する場合、同じ webhook を異なるユーザーにメディアとして割り当てることは避けてください。そうしないと webhook エラーが発生する可能性があります（これは *Include event menu entry* オプションを利用する大半の webhook に当てはまります）。 この場合のベストプラクティスは、webhook を表す専用ユーザーを作成することです。 1. webhook メディアタイプを設定した後、*Users > Users* セクションに移動し、webhook を表す専用のZabbixユーザーを作成します。たとえば、Slack webhook の場合はユーザー名を *Slack* にします。 メディア以外のすべての設定はデフォルトのままで構いません。このユーザーは Zabbix にログインしないためです。 2. ユーザープロファイルで *Media* タブに移動し、必要な連絡先情報を指定して [webhook を追加](/manual/config/notifications/media#user-media) します。 webhook が *Send to* フィールドを使用しない場合は、検証要件を回避するため、サポートされている文字の任意の組み合わせを入力してください。 3. このユーザーに対して、アラートを送信する必要があるすべてのホストに少なくとも読み取り[権限](/manual/config/users_and_usergroups/permissions#permissions-to-host-groups)を付与します。 アラートアクションを設定する際は、Operation details の *Send to users* フィールドにこのユーザーを追加してください。これにより、Zabbix はこのアクションからの通知に webhook を使用します。 [comment]: # ({/22965c08-6eeec89a}) [comment]: # ({1b5d3274-ac89791d}) #### アラートアクションの設定 アクションは、どの通知をウェブフック経由で送信するかを決定します。 ウェブフックを含む[アクションの設定](/manual/config/notifications/action)手順は、以下の例外を除き、他のすべてのメディアタイプと同じです。 - ウェブフックがチケットやメッセージIDの保存や更新・解決操作の処理に[ウェブフックタグ](https://www.zabbix.com/documentation/guidelines/en/webhooks#webhook-tags)を使用する場合、1つの問題イベントに対して同じウェブフックを複数のアラートアクションで使用しないでください。 {EVENT.TAGS.}が存在し、ウェブフック内で更新された場合、その結果の値は未定義になります。 これを回避するには、更新された値を保存するためにウェブフックで新しいタグ名を使用してください。 これは、Zabbixが提供するJira、Jira Service Desk、Mattermost、Opsgenie、OTRS、Redmine、ServiceNow、Slack、Zammad、Zendeskのウェブフックおよび*イベントメニューエントリを含める*オプションを利用するほとんどのウェブフックに該当します。 ただし、同じアクションの複数の操作やエスカレーションステップ、または異なる[条件](/manual/config/notifications/action/conditions)により同じ問題イベントでトリガーされない異なるアクションで、1つのウェブフックを使用することは可能です。 - [内部イベント](/manual/config/events/sources#internal-events)用のアクションでウェブフックを使用する場合、*カスタムメッセージ*のチェックボックスを必ずマークし、アクション操作の設定でカスタムメッセージを定義してください。 そうしないと、通知は送信されません。 [comment]: # ({/1b5d3274-ac89791d})