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

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

トンネルヘルスアラートは、アラート対象の各 IPsec/GRE トンネルについて、過去 6 時間に顧客トラフィック（ヘルスチェック用トラフィックを除く）を実際に転送したトンネルのヘルスチェック成功率を監視します。各 IPsec/GRE トンネルで成功すべきヘルスチェックの割合について、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_tunnel_health_check_event",
		"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_tunnel_health_check_event",
  				"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 からアラートが届くまでの時間は、選んだ感度によって変わります。