容器深入解析記錄結構描述

容器深入解析會將它收集的記錄資料儲存在 Log Analytics 工作區中名為 ContainerLogV2 的資料表中。 本文說明了此資料表的結構描述及其設定選項。 它還將此資料表與舊版的 ContainerLog 資料表進行比較，並提供從中移轉的詳細資料。

表格比較

ContainerLogV2 是 CLI 2.54.0 版和更新版本的預設結構描述。 這是透過受控識別驗證將容器深入解析上線的客戶的預設資料表。 ContainerLogV2 可以使用資料收集設定，透過 CLI 2.51.0 版或更高版本明確加以啟用。

下表醒目提示使用 ContainerLogV2 和 ContainerLog 結構描述之間的主要差異。

¹ 如果 LogMessage 是有效的 JSON 格式，且具有名為 level 的索引鍵，則會使用其值。 否則，會使用 regex 型關鍵字比對來從 LogMessage 推斷出 LogLevel。 這種推論可能會導致一些錯誤分類。 LogLevel 是具有健康情況值 (例如 CRITICAL、ERROR、WARNING、INFO、DEBUG、TRACE 或 UNKNOWN) 的字串欄位。

² KubernetesMetadata 是透過 Kubernetes 中繼資料啟用的選用資料行。 此欄位的值為 JSON 格式，其中包含以下欄位：podLabels、podAnnotations、podUid、Image、ImageTag 和 Image repo。

³ DCR 設定需要受控識別驗證。

啟用 ContainerLogV2 結構描述

使用叢集的資料收集規則 (DCR) 或 ConfigMap 為叢集啟用 ContainerLogV2 結構描述。 如果兩個設定都已啟用，則會優先使用 ConfigMap。 僅當 DCR 和 ConfigMap 均明確設定為關閉時才會使用 ContainerLog 資料表。

啟用 ContainerLogsV2 結構描述之前，您應該評估您是否有任何警示規則依賴 ContainerLog 表格。 任何這類警示都必須更新，才能使用新的資料表。 執行下列 Azure Resource Graph 查詢以掃描參考 ContainerLog 資料表的警示規則。

resources
| where type in~ ('microsoft.insights/scheduledqueryrules') and ['kind'] !in~ ('LogToMetric')
| extend severity = strcat("Sev", properties["severity"])
| extend enabled = tobool(properties["enabled"])
| where enabled in~ ('true')
| where tolower(properties["targetResourceTypes"]) matches regex 'microsoft.operationalinsights/workspaces($|/.*)?' or tolower(properties["targetResourceType"]) matches regex 'microsoft.operationalinsights/workspaces($|/.*)?' or tolower(properties["scopes"]) matches regex 'providers/microsoft.operationalinsights/workspaces($|/.*)?'
| where properties contains "ContainerLog"
| project id,name,type,properties,enabled,severity,subscriptionId
| order by tolower(name) asc

Kubernetes 中繼資料和記錄篩選

Kubernetes 中繼資料和記錄篩選會使用額外的 Kubernetes 中繼資料來擴充 ContainerLogsV2 結構描述。 記錄篩選功能可為工作負載和平台容器提供篩選功能。 這些功能為您提供更豐富的內容並提高工作負載的可見度。

功能

• 增強的 ContainerLogV2 結構描述 啟用 Kubernetes Logs 中繼資料時，它會將資料行新增至名為 KubernetesMetadata 的 ContainerLogV2，以透過簡單的記錄查詢來增強疑難排解能力，且無需與其他資料表進行連接。 此資料列中的欄位包括：PodLabels、PodAnnotations、PodUid、Image、ImageID、ImageRepo、ImageTag。 這些欄位增強了使用記錄查詢的疑難排解體驗，而無需與其他資料表連接。 如需啟用 Kubernetes 中繼資料功能的詳細資料，請參閱下文。

• 記錄層級 此功能會將 LogLevel 資料行新增至 ContainerLogV2，包括以下可能的值：嚴重、錯誤、警告、資訊、偵錯、追蹤或未知。 這可以幫助您根據嚴重性等級來評估應用程式的健康情況。 新增 Grafana 儀表板後，您可以視覺化記錄層級隨時間變化的趨勢，並快速找出受影響的資源。

• 用於視覺效果的 Grafana 儀表板 Grafana 儀表板提供了記錄層級的顏色編碼視覺效果，也提供了對記錄量、記錄速率、日誌記錄、記錄的深入解析。 您可以取得時間緊迫的分析、一段時間的記錄層級趨勢動態深入解析，以及重要的即時監視。 該儀表板也提供依電腦、Pod 和容器列出的詳細明細，有助於進行深入分析和精確的疑難排解。 如需安裝 Grafana 儀表板的相關詳細資料，請參閱下方。

• 工作負載的註釋型記錄篩選 透過 Pod 註釋的有效率記錄篩選。 這可讓您專注於相關的資訊，而無需篩選不必要的資訊。 註釋型篩選可讓您藉由註釋 Pod 來排除特定 Pod 和容器的記錄收集，這有助於大幅降低記錄分析成本。 如需設定註釋型篩選的詳細資料，請參閱註釋型記錄篩選。

• 平台記錄的 ConfigMap 型記錄篩選 (系統 Kubernetes 命名空間) 平台記錄會由系統 (或類似受限制的) 命名空間中的容器所發出。 預設情況下，系統命名空間中的所有容器記錄都會被排除，以將 Log Analytics 工作區中的資料成本降到最低。 不過，在特定的疑難排解案例中，系統容器的容器記錄扮演著至關重要的角色。 其中一個範例是 kube-system 命名空間中的 coredns 容器。

啟用 Kubernetes 中繼資料

使用具有以下設定的 ConfigMap 來啟用 Kubernetes 中繼資料。 啟用 metadata_collection 時，預設會收集所有中繼資料欄位。 取消註解 include_fields 以指定要收集的個別欄位。

[log_collection_settings.metadata_collection]
    enabled = true
    include_fields = ["podLabels","podAnnotations","podUid","image","imageID","imageRepo","imageTag"]

幾分鐘後，KubernetesMetadata 資料行應包含在 ContainerLogV2 資料表的任何記錄查詢中，如下所示。

安裝 Grafana 儀表板

從位於 ContainerLogV2 Dashboard 的 Grafana 資源庫中匯入儀表板。 然後，您可以開啟儀表板並選取資料來源、訂用帳戶、資源群組、叢集、命名空間和標籤的值。

多行記錄

啟用多行記錄后，先前分割的容器記錄會合併在一起，並以單一項目傳送至 ContainerLogV2 表格。 如果合併的記錄行大於 64 KB，則會因為 Log Analytics 工作區限制而遭到截斷。 這項功能也支援 .NET、Go、Python 和 Java 堆疊追蹤，其會顯示為 ContainerLogV2 表格中的單一項目。 使用 ConfigMap 啟用多行記錄，如使用 ConfigMap 在容器深入解析中設定資料收集中所述。

下列螢幕擷取畫面會顯示 Go 例外狀況堆疊追蹤的多行記錄：

多行記錄已停用

多行記錄已啟用

Java 堆疊追蹤

Python 堆疊追蹤

下一步

• 設定 ContainerLogv2 的基本記錄。
• 了解如何從 ContainerLogV2 查詢資料