ヘルスチェックのロギング情報

エンドポイントのヘルス ステータスが変化するタイミングで、ロード バランシング ヘルスチェックのログを取得できます。ヘルスチェックのログは次の目的に使用できます。

• エンドポイントのヘルス ステータスをリアルタイムでデバッグし、トラブルシューティングする
• エンドポイントのヘルス ステータスを可視化する
• 監査とコンプライアンス

ヘルスチェックによって、ヘルス ステータスの遷移に関する情報が Logging に記録されます。Logging の有効化と無効化はヘルスチェックごとに行います。

Logging におけるヘルスチェックのログを確認する場合、ヘルスチェックに該当するログの除外がないようにしてください。GCE Instance Group ログと Network Endpoint Group ログが許可されているかどうか確認する方法については、除外フィルタをご覧ください。

ロギングを有効または無効にする

このセクションでは、新規または既存のヘルスチェックでロギングを有効にする方法と、既存のヘルスチェックでロギングを無効にする方法について説明します。

新しいヘルスチェックでロギングを有効にする

gcloud compute health-checks create PROTOCOL HEALTH_CHECK_NAME \
    --enable-logging

resource "google_compute_health_check" "health_check_tcp_with_logging" {
  provider = google-beta

  name = "health-check-tcp"

  timeout_sec        = 1
  check_interval_sec = 1

  tcp_health_check {
    port = "22"
  }

  log_config {
    enable = true
  }
}

既存のヘルスチェックでのロギングの有効化

gcloud compute health-checks update PROTOCOL HEALTH_CHECK_NAME \
    --enable-logging

既存のヘルスチェックでロギングを無効にする

gcloud compute health-checks update PROTOCOL HEALTH_CHECK_NAME \
    --no-enable-logging

ログの表示

1. ログを表示するには、ログ エクスプローラに移動します。

   ヘルスチェックのログは、インスタンス グループまたはネットワーク エンドポイント グループによってインデックスに登3録されます。

2. すべてのログを表示するには、[リソース] メニューで、バックエンドの種類に応じて GCE Instance Group または Network Endpoint Group を選択します。

3. または、[クエリ] フィールドに次の内容を貼り付けます。PROJECT_ID は、プロジェクトの ID に置き換えます。

   logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"
   

ロードバランサのヘルスチェックに関するログベースの指標のエクスポートを構成できます。

フィルタを使用してログを表示する

より具体的な検索に基づいてログを取得することもできます。たとえば、次のフィルタは、指定されたバックエンド インスタンスの IP アドレスのすべてのログを表示します。

  logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"
jsonPayload.healthCheckProbeResult.ipAddress="IP_ADDRESS"

通常、ブール型のログフィールドは、フィールドの値が true の場合にのみ表示されます。ブール フィールドの値が false の場合、そのフィールドはログから省略されます。

ログフィールドには UTF-8 エンコードが適用されます。UTF-8 以外の文字セットは、疑問符に置き換えられます。

ログの内容

ヘルスチェックのログエントリには、エンドポイントの状態のモニタリングとデバッグに役立つ情報が含まれています。ログエントリには次のタイプの情報が含まれています。

• 重大度、プロジェクト ID、プロジェクト番号、タイムスタンプなど、ほとんどのログに表示される一般情報。
• ヘルスチェック固有のフィールド（次の表をご覧ください）。

ヘルスチェックの状態

エンドポイントは HEALTHY または UNHEALTHY のいずれかとみなされます。これらは基本的な状態です。それぞれの基本的な状態には、詳細な状態が複数含まれています。

分散 Envoy ヘルスチェックを使用するハイブリッド NEG とリージョン インターネット NEG は、詳細なヘルス状態をサポートしていません。

次の表に、基本的なヘルス状態と詳細なヘルス状態の対応関係を示します。

状態を変更しても、ロードバランサの動作が変わるとは限りません。次のような場合を考えてみましょう。

1. サーバーが不適切なレスポンスを送信しているため、エンドポイントは UNHEALTHY とみなされる。
2. その後、サーバーは応答を停止し、新しい状態は TIMEOUT になる。
3. 詳細な TIMEOUT 状態は基本的な UNHEALTHY 状態に対応するため、ロードバランサは依然としてエンドポイントは UNHEALTHY であるとみなす。

次の表に、各ヘルス状態の定義を示します。

各エンドポイントを調べる複数のヘルス チェッカーがあります。Google Cloud は、一意のログのみが生成されるように、ロギングの前にログエントリの重複を排除します。

ヘルス チェッカーが再起動すると、エンドポイントのヘルス状態が実際には変更されていなくても、ログに記録されたヘルス状態が UNKNOWN から上記の既知の状態のいずれかに変わることがあります。Google Cloud は、ベスト エフォート ヒューリスティックを用いて、このようなログエントリを抑制しています。

コネクション ドレインを使用している場合、エンドポイント ヘルス ステータスが DRAINING のヘルスチェック ログは生成されません。ヘルスチェック ログには、ヘルスチェック プローブによって観察された結果が反映されます。コネクション ドレインは、ヘルスチェック プローブによって観察された結果に影響しません。コネクション ドレインは、新しい状態が DRAINING であることをロードバランサに通知するだけで、ヘルス チェッカーによって観測されるエンドポイントの実際の状態を効果的にオーバーライドします。

Cloud Logging API を使用してログを操作できます。この API は、特定のフィールドが設定されたログをインタラクティブにフィルタし、一致するログを Cloud Logging、Cloud Storage、BigQuery、または Pub/Sub にエクスポートする方法を提供します。Logging API について詳しくは、Cloud Logging API の概要をご覧ください。

ヘルスチェックのログエントリ

LogEntry jsonPayload には、次の情報を含むフィールド healthCheckProbeResult が挿入されます。

フィルタの使用例

このセクションでは、一般的なログフィルタの例を示します。

特定のインスタンス グループのヘルスチェック結果をすべて検索します

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"  AND
resource.type="gce_instance_group" AND
resource.labels.instance_group_name="INSTANCE_GROUP_NAME"

特定の NEG のヘルスチェック結果をすべて検索します

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"  AND
resource.type="gce_network_endpoint_group" AND
resource.labels.network_endpoint_group_id="ENDPOINT_GROUP_ID"

バックエンド インスタンスの IP アドレス 10.128.15.201 のすべてのヘルスチェックの推移を検索します

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"
jsonPayload.healthCheckProbeResult.ipAddress="10.128.15.201"

前の状態が HEALTHY で、現在の状態が TIMEOUT であるすべてのエンドポイントを検索します

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"
jsonPayload.healthCheckProbeResult.previousDetailedHealthState="HEALTHY"
jsonPayload.healthCheckProbeResult.detailedHealthState="TIMEOUT"

特定の期間のヘルスログを検索します

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"
timestamp>"2019-02-14T02:20:00.0Z"
timestamp<"2019-02-14T03:30:00.0Z"

制限事項

• ログは、エンドポイントのヘルス ステータスの遷移に対してのみ生成されます。
• レガシー ヘルスチェックはサポートされていません。
• ターゲット プールはサポートされていません。
• エンドポイントのヘルス状態が UNKNOWN の場合、ログは生成されません。
• VM の移行の場合、エンドポイントのヘルス状態が「UNHEALTHY」に移行したときに生成されたログエントリが表示されない可能性があります。
• エンドポイントを削除しても、ログは生成されません。たとえば、VM を停止したときなどです。

次のステップ

• ヘルスチェックのコンセプトについて理解する。
• ヘルスチェックを作成します。
• Logging について理解する