トンネルヘルスアラートを設定する

トンネルヘルスアラート（旧 Magic Tunnel ヘルスアラート）を設定すると、IPsec/GRE トンネルの成功した ヘルスチェック の割合が、選択した サービスレベル目標（SLO） を下回ったときに、メール、Webhook、PagerDuty で通知を受け取れます。

トンネルヘルスアラートは、アラートに含めた各 IPsec/GRE トンネルについて、過去 6 時間に顧客トラフィック（ヘルスチェックトラフィックを除く）を実際に転送したトンネルのヘルスチェック成功率を監視します。トンネルごとに、ヘルスチェックが成功しなければならない割合の SLO しきい値を定義できます。アラートに含めた IPsec/GRE トンネルの成功ヘルスチェック数が SLO しきい値を下回ると、アラートが発火します。

トンネルヘルスアラートが発火すると、メール、Webhook、PagerDuty の通知に次のデータが含まれます。

• Cloudflare アカウント名
• Cloudflare アカウント ID
• アラートの種類
• トンネル名
• トンネル ID
• トンネルの状態
• アラート SLO
• タイムスタンプ

現在、Cloudflare ダッシュボードでは 7 つの SLO しきい値を設定できます。より細かく設定するには、API を使います。

トンネルヘルスアラートの SLO しきい値は、アラートに含めた各 IPsec/GRE トンネルの成功ヘルスチェックの割合です。

アラートを受け取るまでの時間は、SLO しきい値に設定した感度レベルによって変わります。感度を高くすると、トンネルの健全性が低下したときに早く通知されますが、短時間または軽微な障害でもアラートが出ることがあります。感度を低くすると誤検知は減りますが、深刻度の低い問題の通知が遅れることがあります。

検出のタイミング自体は感度レベルによらず同じです。通知の速さは、トンネルの健全性がどれだけ低下したかと、選んだ感度に依存します。ユースケースに合う値を決めるため、SLO をテスト することをおすすめします。

詳細は Cloudflare がトンネルヘルスアラートを計算する方法 を参照してください。

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/alerting/v3/policies" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"alert_type": "magic_wan_tunnel_health",
		"description": "<DESCRIBE_POLICY>",
		"enabled": true,
		"filters": {
				"slo": [
						"99.9"
				]
		},
		"mechanisms": {
				"email": [
						{
								"id": "EMAIL_ADDRESS"
						}
				]
		},
		"name": "<DESCRIBE_ALERT>"
	}'

  	{
  		"result": [
  			{
  				"id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
  				"name": "<POLICY_NAME>",
  				"description": "<POLICY_DESCRIPTION>",
  				"enabled": true,
  				"alert_type": "magic_wan_tunnel_health",
  				"mechanisms": {
  					"email": [
  						{
  							"id": "<YOUR_EMAIL>"
  						}
  					]
  				},
  				"created": "2024-09-11T14:13:29.585658Z",
  				"modified": "2024-09-11T14:13:29.585658Z",
  				"conditions": {
  					"and": [
  						{
  							"or": [
  								{
  									"<=": [
  										{
  											"var": "slo"
  										},
  										"99.9"
  									]
  								}
  							]
  						}
  					]
  				},
  				"filters": {
  					"slo": ["99.9"]
  				}
  			}
  		],
  		"success": true,
  		"errors": [],
  		"messages": []
  	}
  

特定のアラート感度レベルがユースケースに合うかテストする手順は次のとおりです。

1. 過去 6 時間にトラフィックがあるトンネルに対して、特定の感度レベルの アラートを作成 します。どのトンネルを選ぶか迷う場合は、Network Analytics でネットワークのリアルタイムおよび過去のデータを確認してください。
2. テスト対象のトンネルを無効にし、ヘルスチェック失敗 が 100% になるようにします。
3. Cloudflare がアラートを送るまでの時間は、選んだ感度によって変わります。