モニターを管理する

モニターをセットアップする

モニターは、ロードバランサーの作成ワークフロー 内、または Monitors タブで作成できます。

1. Load Balancing を開きます。

2. Monitors タブを選びます。

3. Create monitor を選びます。

4. 次の情報を追加します。

   • Type: ヘルスモニターに使うプロトコルです
     • Enterprise 以外のお客様: HTTP、HTTPS、TCP から選びます。
     • Enterprise のお客様: HTTP、HTTPS、TCP、UDP ICMP、ICMP Ping、SMTP から選びます。
   • Path: ヘルスモニターリクエストを送るエンドポイントのパスです
   • Port: ヘルスモニターの宛先ポートです

5. 追加の設定は Advanced health monitor settings を選びます。

   • Interval:
     • デフォルトを大きくすると、フェイルオーバー時間を改善できますが、エンドポイントの負荷も増える場合があります。
     • 最小間隔（秒）は 60（Pro）、15（Business）、10（Enterprise）です。
   • Timeout と Retries:
     • ヘルスモニターリクエストが Timeout で指定した時間を超え（かつ、その超過回数が指定した Retries 回数を超えた）場合、unhealthy を返します。
   • Expected Code(s): 期待する HTTP レスポンスコード。個別に指定する（200、302）か、範囲で指定します（たとえば 2xx と入力すると、200 番台のすべてのレスポンスコードが対象になります）。
   • Response Body:
     • レスポンス本文内の、大文字小文字を区別しない部分文字列を探します。
     • 値は比較的静的で、HTML ページの先頭 10 KB 以内にあることを確認してください。
   • Simulate Zone:
     • ロードバランサーが存在するゾーンと同じゾーンを使うことを推奨します。
     • ヘルスモニターリクエストの egress ゾーン設定を変更し、Authenticated Origin Pulls (mTLS)、Argo Smart Routing、Bring your own CA (mTLS)、Dedicated CDN Egress IPs、HTTP/2 to Origin などの機能との互換性を確保します。
   • Follow Redirects:
     • 301 または 302 コードを unhealthy として報告する代わりに、ヘルスモニターリクエストは最終エンドポイントまでリダイレクトをたどります。
   • Configure Request Header(s):
     • エンドポイントが特定の受信ヘッダーを期待している場合に便利です。
   • Header:
     • ヘルスモニターで送信する HTTP リクエストヘッダーです。デフォルトで Host ヘッダーを設定することを推奨します。User-Agent ヘッダーは上書きできません。このパラメーターは HTTP および HTTPS モニターでのみ有効です。

6. Save を選びます。

サーバーを準備する

ファイアウォールや Web サーバーが、設定したヘルスモニター、または Cloudflare IP アドレス ↗ に関連するリクエストをブロックしたり、レート制限したりしないようにしてください。

各ヘルスモニターの HTTP user-agent は "Mozilla/5.0 (compatible; Cloudflare-Traffic-Manager/1.0; +https://www.cloudflare.com/traffic-manager/; pool-id: $poolid)" です。$poolid は 関連するプール の先頭 16 文字です。

モニターをプールに紐づける

モニターを作成したら、プールに紐づけます。

1. Load Balancing を開きます。

2. Pools タブを選択します。

3. 対象のプールで Edit を選択します。

4. 次の情報を更新します。

   • Monitor: モニターを選びます。
   • Health Monitor Regions: Cloudflare がヘルスモニターリクエストを送る地理的リージョンを指定します。モニターがプールの健全性を確認する方法 のため、複数リージョンを選ぶとサーバー負荷が増えることがあります。
   • Notification E-mail: 通知を受け取るメールアドレスです（個人、メーリングリスト、PagerDuty アドレス）。

5. Save を選択します。最初のチェック結果が出るまで、ヘルスモニターのステータスは unknown です。

モニターをセットアップする

モニターのプロパティの一覧は、Create Monitor を参照してください。API 認証で困った場合は、Cloudflare API ドキュメント を参照してください。

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/load_balancers/monitors" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"type": "https",
		"description": "Login page monitor",
		"method": "GET",
		"path": "/health",
		"header": {
				"Host": [
						"example.com"
				],
				"X-App-ID": [
						"abc123"
				]
		},
		"port": 8080,
		"timeout": 3,
		"retries": 0,
		"interval": 90,
		"expected_body": "alive",
		"expected_codes": "2xx",
		"follow_redirects": true,
		"allow_insecure": true,
		"consecutive_up": 3,
		"consecutive_down": 2,
		"probe_zone": "example.com"
	}'

応答には、新しいモニターの完全な定義が含まれます。

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "id": ":monitor-id",
    "created_on": "2021-01-01T05:20:00.12345Z",
    "modified_on": "2021-01-01T05:20:00.12345Z",
    "type": "https",
    "description": "Login page monitor",
    "method": "GET",
    "path": "/health",
    "header": {
      "Host": [
        "example.com"
      ],
      "X-App-ID": [
        "abc123"
      ]
    },
    "port": 8080,
    "timeout": 3,
    "retries": 0,
    "interval": 90,
    "expected_body": "alive",
    "expected_codes": "2xx",
    "follow_redirects": true,
    "allow_insecure": true,
    "consecutive_up": 3,
    "consecutive_down": 2,
    "probe_zone": "example.com"
  }
}

サーバーを準備する

ファイアウォールや Web サーバーが、設定したヘルスモニター、または Cloudflare IP アドレス ↗ に関連するリクエストをブロックしたり、レート制限したりしないようにしてください。

各ヘルスモニターの HTTP user-agent は "Mozilla/5.0 (compatible; Cloudflare-Traffic-Manager/1.0; +https://www.cloudflare.com/traffic-manager/; pool-id: $poolid)" です。$poolid は 関連するプール の先頭 16 文字です。

モニターをプールに紐づける

モニターを作成したら、その id プロパティを保存します。プールを作成する ときに、monitor パラメーターへこの値を含めます。

ダッシュボードでモニターを編集するには:

1. Load Balancing を開きます。
2. Monitors を選択します。
3. 対象のモニターで Edit を選択します。
4. 必要に応じて設定を更新します。
5. Save を選択します。

API でモニターを編集するときは、変更の範囲に応じてリクエストの種類が変わります。

特定の設定だけを更新し、構成全体を再送信したくない場合は PATCH リクエストを使います。より広い変更には PUT リクエストを使います。

ダッシュボードでモニターを削除するには:

1. Load Balancing を開きます。
2. Monitors タブを選択します。
3. 対象のモニターで Delete を選択します。

API でモニターを削除するには、DELETE リクエストを送ります。