コンテンツにスキップ

ヘルスモニタ通知

Cloudflareは、ロードバランシングのヘルスモニタで使用される通知をCloudflareの集中型通知サービスに移行しています。

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

Cloudflareのアカウントレベルの通知サービスは、ほとんどのCloudflareサービスの集中管理場所となりました。この変更により、一貫性と管理の効率化が促進され、Webhookの設定や同じ通知に複数のプールを関連付けるなど、通知配信のオプションが増えます。これらの新しい通知は、ゾーンレベルではなくアカウントレベルで管理されます。

すべての顧客に対して、既存のヘルスモニタ通知をCloudflareの集中型通知サービスに移行することを強く推奨します。これにより、アラートの欠落を避けることができます。

移行ガイド

このガイドを使用して、すべての既存のヘルスモニタ通知を移行してください。

ステップ1 - 既存の通知を見つける

まず、どのプールが通知を使用しているかを特定する必要があります。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": "user@example.com"
},
{
"name": "pool-2",
"notification_email": "user@example.com"
},
{
"name": "pool-3",
"notification_email": "user@example.com"
},
{
"name": "pool-4",
"notification_email": "user@example.com"
}
]

コードなし

ダッシュボードで既存の通知があるプールを見つけるには:

  1. Cloudflareダッシュボードにログインし、アカウントとドメインを選択します。
  2. トラフィック > ロードバランシングに移動します。
  3. プールを管理をクリックします。
  4. プールを選択し、編集をクリックします。
  5. ヘルスモニタ通知の値がオンに切り替えられており、通知メールアドレスフィールドにメールアドレスが存在することを確認します。

ステップ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で見つけたプールで、プール通知を探します。ヘルスアラートを作成をクリックして通知を作成します。

ステップ3 - 廃止された通知を削除する

移行プロセスの最終ステップとして、レガシー通知からすべてのメールを削除し、今後廃止通知のメールを受け取らないようにする必要があります。

これらの手順はダッシュボードで実行できますが、Cloudflareは新しいAPIエンドポイントを使用することを推奨しています。

コードあり

Cloudflare APIを使用する場合、最近PATCHエンドポイントが追加され、複数のプールからメール通知を簡単に削除できます。

リクエスト
curl --request PATCH \
"https://api.cloudflare.com/client/v4/accounts/{account_id}/load_balancers/pools" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
"notification_email": ""
}'

このAPI呼び出しは、標準のページネーションクエリパラメータ、limit/offsetまたはper_page/pageをサポートしているため、デフォルトでは最初の25プールのみを更新します。すべてのプールを更新するには、API呼び出しを調整してさまざまなページをループするか、各リクエストでより多くのプールを含めることを検討してください。

必要に応じて、ダッシュボードを使用してレガシー通知を削除できます。

コードなし

ステップ2で新しい通知を作成した後、以前に編集していたプールに戻ります。廃止された通知を無効にするには、フィールドからすべての通知メールアドレスを削除する必要があります。

このステップ(すべてのプールからすべての通知メールを削除する)を完了しないと、移行は完了と見なされず、今後もこの廃止に関する追加のメールを受け取り続けることになります。