Cloudflare は、ロードバランシングの ヘルスモニター が使う通知を、Cloudflare の集中管理 Notifications Service へ移行しています。
Cloudflare のアカウントレベルの Notifications Service は、いまほとんどの Cloudflare サービスの集中管理場所です。この変更により、運用がそろい、管理が簡単になります。Webhook の設定や、複数プールを同じ通知に紐づけるなど、通知の届け方も増えます。新しい通知はゾーンレベルではなく、アカウントレベルで管理します。
既存の Health Monitor 通知は、Cloudflare の集中 Notifications Service へ移行することを強くおすすめします。アラートが途切れないようにするためです。
既存のヘルスモニター通知は すべて このガイドで移行してください。
まず、通知を使っているプールを特定します。Cloudflare API で全プールを一覧し、notification_email パラメーターを確認すると簡単です。
コードを使う
Cloudflare API で全プールを一覧し、各プールに notification_email パラメーターの値があるかを確認します。
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}]'[
{
"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]"
}
]コードを使わない
ダッシュボードで、既存の通知があるプールを探す手順は次のとおりです。
- Cloudflare ダッシュボード ↗ にログインし、アカウントとドメインを選びます。
- Load Balancing を開きます。
- Pools タブを選びます。
- プールで Edit を選びます。
- Health Check Notifications が On になっており、Notification email address フィールドにメールアドレスが入っていることを確認します。
このステップでは、既存のレガシー通知をすべて置き換える新しい通知を作成します。
コードを使う
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"]
}移行の最後のステップとして、レガシー通知からメールアドレスをすべて削除します。今後、非推奨に関するメールが届かないようにするためです。
ダッシュボードでも実行できますが、手間を減らすなら新しい API エンドポイントの利用をおすすめします。
コードを使う
Cloudflare API を使う場合、最近追加された PATCH エンドポイントで、複数プールのメール通知をまとめて削除できます。
Required API token permissions
At least one of the following token permissions is required:Load Balancing: Monitors and Pools Write
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 で新しい通知を作成すると、編集中だったプールの画面に戻ります。非推奨の通知を無効にするには、フィールドから通知用メールアドレスをすべて削除します。
このステップ（すべてのプールから通知用メールを削除すること）を完了しないと、移行は完了扱いにはならず、この非推奨に関するメールが引き続き届きます。