汎用Webhook Inputs

汎用Webhook Inputsとは、様々な監視ツールからのWebhookを受け、任意のスクリプトを用いてハンドルすべきWebhookかを判定するInputsです。

このドキュメントではWebhook Inputsを利用する場合の設定について記載します。

前提条件

監視ツールなどでAutoScaler CoreへのUpまたはDownリクエストを送信するためのWebhookを設定します。

送信先URLは以下のようにします。

URLには以下のパラメータが指定可能です。

source: リクエスト元を識別するための名称。任意の値を利用可能。デフォルト値:default
resource-name: 操作対象のリソースの名前。Coreのコンフィギュレーションで定義したリソース名を指定する。デフォルト値:default
desired-state-name: 希望する状態の名前。Coreのコンフィギュレーションで定義したプラン名を指定する。特定の時刻に特定のスペックにしたい場合などに利用する。デフォルト値:""

これらのパラメータを複数指定する場合は&で繋げて記載します。

Urlの記載例: http://example.com:8080/up?source=grafana&resource-name=resource1

MackerelのWebhookでの通知を利用する例です。

あらかじめMackerel側でWebhookを送信するための設定をしておきます。
参考: Mackerelヘルプ: Webhookにアラートを通知する

次に、Webhookのボディを解析し、AutoScalerでハンドルすべきリクエストなのかを判定するためのスクリプトを作成します。

ここではjqコマンドを利用し、Webhookのボディのalert.statusがwarningだった場合はハンドルするようにします。
以下の内容でmackerel.shファイルを作成します。

#!/bin/sh

jq -e 'select(.alert.status == "warning")'

作成したらchmod +xなどで適切な権限を付与しておいてください。

$ chmod +x mackerel.sh

次にWebhook Inputsを起動します。

$ autoscaler inputs webhook --accept-http-methods "POST" --executable-path mackerel.sh

実行可能なファイルを指定します。スクリプトが終了コード0を返したらハンドルすべきWebhookと判断します。