Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

ヘルスモニター通知

最終更新 Markdown で表示Agent セットアップ

Cloudflare は、ロードバランシングの ヘルスモニター が使う通知を、Cloudflare の集中管理 Notifications Service へ移行しています。

何が変わり、なぜ変わるのか

Cloudflare のアカウントレベルの Notifications Service は、いまほとんどの Cloudflare サービスの集中管理場所です。この変更により、運用がそろい、管理が簡単になります。Webhook の設定や、複数プールを同じ通知に紐づけるなど、通知の届け方も増えます。新しい通知はゾーンレベルではなく、アカウントレベルで管理します。

既存の Health Monitor 通知は、Cloudflare の集中 Notifications Service へ移行することを強くおすすめします。アラートが途切れないようにするためです。

移行ガイド

既存のヘルスモニター通知は すべて このガイドで移行してください。

ステップ 1 - 既存の通知を探す

まず、通知を使っているプールを特定します。Cloudflare API で全プールを一覧し、notification_email パラメーターを確認すると簡単です。

コードを使う

Cloudflare API で全プールを一覧し、各プールに notification_email パラメーターの値があるかを確認します。

リクエストbash
curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/load_balancers/pools" \
--header "Authorization: Bearer <API_TOKEN>" \
| jq '[.result[] | select(.notification_email != "") | {name, notification_email}]'
レスポンスjson
[
    {
        "name": "pool-1",
        "notification_email": "[email protected]"
    },
    {
        "name": "pool-2",
        "notification_email": "[email protected]"
    },
    {
        "name": "pool-3",
        "notification_email": "[email protected]"
    },
    {
        "name": "pool-4",
        "notification_email": "[email protected]"
    }
]

コードを使わない

ダッシュボードで、既存の通知があるプールを探す手順は次のとおりです。

  1. Cloudflare ダッシュボード ↗ にログインし、アカウントとドメインを選びます。
  2. Load Balancing を開きます。
  3. Pools タブを選びます。
  4. プールで Edit を選びます。
  5. Health Check Notifications が On になっており、Notification email address フィールドにメールアドレスが入っていることを確認します。

ステップ 2 - 新しい通知を作成する

このステップでは、既存のレガシー通知をすべて置き換える新しい通知を作成します。

コードを使う

Cloudflare API を使う場合は、次のパラメーターを指定して 既存の通知をすべて再作成 します。

"alert_type": "load_balancing_health_alert",
"filters": {
    "pool_id": <<ARRAY_OF_INCLUDED_POOL_IDS>>,
    "new_health": <<ARRAY_OF_STATUS_TRIGGERS>> ["Unhealthy", "Healthy"],
    "event_source": <<ARRAY_OF_OBJECTS_WATCHED>> ["pool", "origin"]
}

コードを使わない

ステップ 1 で見つけたプールの Pool Notifications を確認します。Create a Health Alert を選んで 通知の作成 を開始します。

ステップ 3 - 非推奨の通知を削除する

移行の最後のステップとして、レガシー通知からメールアドレスをすべて削除します。今後、非推奨に関するメールが届かないようにするためです。

ダッシュボードでも実行できますが、手間を減らすなら新しい API エンドポイントの利用をおすすめします。

コードを使う

Cloudflare API を使う場合、最近追加された PATCH エンドポイントで、複数プールのメール通知をまとめて削除できます。

Required API token permissions

At least one of the following token permissions is required:
  • Load Balancing: Monitors and Pools Write
Patch Poolsbash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/load_balancers/pools" \
	--request PATCH \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"notification_email": ""
	}'

この API 呼び出しは、標準のページネーションクエリパラメーター(limit/offset または per_page/page)に対応します。デフォルトでは、一覧の先頭 25 プールだけが更新されます。すべてのプールを更新するには、ページを順に処理するか、1 回のリクエストで扱うプール数を増やしてください。

必要なら、ダッシュボードでレガシー通知を削除できます。

コードを使わない

ステップ 2 で新しい通知を作成すると、編集中だったプールの画面に戻ります。非推奨の通知を無効にするには、フィールドから通知用メールアドレスをすべて削除します。

このステップ(すべてのプールから通知用メールを削除すること)を完了しないと、移行は完了扱いにはならず、この非推奨に関するメールが引き続き届きます。

役に立ちましたか?