健康狀態檢查記錄資訊

端點的健康狀態變更時，您可以取得負載平衡健康狀態檢查的記錄。健康狀態檢查記錄可用於下列用途：

• 即時偵錯及排解端點健康狀態問題
• 瞭解端點的健康狀態
• 稽核與法規遵循

健康狀態檢查會將健康狀態轉換資訊記錄到 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. 如要查看記錄，請前往記錄探索工具。

   健康狀態檢查記錄會依執行個體群組或網路端點群組建立索引。

2. 如要查看所有記錄，請在「資源」選單中選取 GCE Instance Group 或 Network Endpoint Group，視後端類型而定。

3. 或者，將下列內容貼到「Query」(查詢) 欄位。將 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. 負載平衡器仍會將端點視為 UNHEALTHY，因為詳細的 TIMEOUT 狀態會對應至基本 UNHEALTHY 狀態。

下表提供各健康狀態的定義。

有多個健康狀態檢查程式會探查每個端點； Trusted Cloud系統會在記錄前移除重複的記錄項目，因此只會產生不重複的記錄。

如果健康狀態檢查程式重新啟動，您可能會偶爾看到記錄的健康狀態從 UNKNOWN 變更為先前列出的已知狀態之一，即使端點的健康狀態實際上並未變更。 Trusted Cloud 會盡量使用啟發式方法來抑制這類記錄項目。

如果您使用連線排空，系統不會產生端點健康狀態 DRAINING 的健康狀態檢查記錄。這是因為健康狀態檢查記錄反映的是健康狀態檢查探測器觀察到的結果，而連線排空不會影響健康狀態檢查探測器觀察到的結果。連線排空功能會通知負載平衡器新狀態為 DRAINING，並有效覆寫健康狀態檢查器觀察到的端點實際健康狀態。

您可以使用 Cloud Logging API 與記錄互動。API 可讓您透過多種互動方式篩選已設定特定欄位的記錄，並將相符的記錄匯出至 Cloud Logging、Cloud Storage、BigQuery 或 Pub/Sub。如要進一步瞭解 Cloud 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 時就會發生這種情況。

後續步驟

• 閱讀健康狀態檢查的概念資訊。
• 建立健康狀態檢查。
• 請參閱記錄。