Zabbix 4.4で追加されたWebhookでSlackに通知する設定メモ

Zabbix

2019.10.22

Zabbix 4.4 ではメディアタイプ（障害などを通知する方法）に Webhook が追加されました。これまでは、Slack などのチャットサービスに障害通知を送信する場合は、外部スクリプトを作成する必要がありましたが、この Webhook を使えば、Zabbix の管理画面だけで外部サービスに通知するための JavaScriptコードの入力や編集がすることができます。そこで今回は、Zabbix 4.4 で追加された Webhook で Slack に通知を送信する設定手順をまとめてみました。

Slack の Incoming Webhooks を有効化
1. Slackアプリの作成
2. Incoming Webhooks の有効化
Zabbix メディアタイプ Webhook の設定
通知設定
おわりに

Slack の Incoming Webhooks を有効化

Zabbix からの通知を Slack に投稿できるように Incoming Webhooks を有効化します。Incoming Webhooks は、外部から Slack にメッセージを投稿するための一番簡単な仕組みです。

テスト用に適当なチャネルを作成しておきます。（既存のチャネルを使っても構いません）

Slackアプリの作成

まだ Slackアプリを作成していない場合は https://api.slack.com/apps のページで Slackアプリを作成します。

アプリ名を入力して Zabbix からの通知を投稿するワークスペースを選択します。ここで設定したアプリ名が Slack の投稿者名として表示されます。

Incoming Webhooks の有効化

Incoming Webhooks 選択して「Activate Incoming Webhooks」を「ON」にします。

ページの下にスクロールして「Add New Webhook to Workspace」をクリックします。

投稿先のチャネルを選択して「許可する」をクリックします。

Webhook URL が作成されますのでコピーしておきます。※ Incoming Webhooks には認証の仕組みはありませんので Webhook URL は秘密にして扱いましょう。

最後に、サンプルの curlコマンドを実行して指定したチャネルに「Hello, World!」が投稿されることを確認しておきます。

curl -X POST -H 'Content-type: application/json' \
--data '{"text":"Hello, World!"}' \
https://hooks.slack.com/services/****

Zabbix メディアタイプ Webhook の設定

Zabbix のメディアタイプ Webhook を使って、Slack に通知を送信できるように設定します。

「管理」→「メディアタイプ」→「メディアタイプの作成」をクリックします。

適当な名前を入力し、タイプ「Webhook」を選択します。デフォルトで設定されているパラメータはすべて削除して、名前「text」、値「{ALERT.MESSAGE}」のパラメータを追加します。

（補足）以前の Slack の Incoming Webhooks は、パラメータでチャネルやユーザー名、アイコンが指定できましたが、Slack API に変更がありそれらができなくなりました。チャネルやユーザー名、アイコンなどは Slackアプリで設定してください。

参考資料：Reference- Message payloads | Slack

スクリプトの鉛筆マークをクリックして、以下の JavaScriptコードを入力します。req.Post のところの Webhook URL は、ご自分で作成した Webhook URL に書き換えてください。

var req = new CurlHttpRequest();
req.AddHeader('Content-Type: application/x-www-form-urlencoded');
 
Zabbix.Log(4, 'webhook request value='+value);
 
req.Post(
  'https://hooks.slack.com/services/****',
  'payload='+value
);
 
Zabbix.Log(4, 'response code: '+req.Status());
 
return JSON.stringify({
  'tags': {
    'endpoint': 'slack'
  }
});

JavaScriptコードを入力して、ページ下部にある「追加」をクリックすれば、メディアタイプの設定完了です。

最後に作成したメディアタイプの「テスト」をクリックして、Slack に投稿されることを確認します。