Schemat dziennika usługi Container Insights

Usługa Container Insights przechowuje dane dziennika, które zbiera w tabeli o nazwie ContainerLogV2. W tym artykule opisano schemat tej tabeli oraz jej porównanie i migrację ze starszej tabeli ContainerLog .

Ważne

ContainerLogV2 będzie domyślnym schematem za pośrednictwem narzędzia ConfigMap dla interfejsu wiersza polecenia w wersji 2.54.0 lub nowszej. KontenerLogV2 będzie domyślnym formatem pozyskiwania dla klientów, którzy będą dołączać szczegółowe informacje o kontenerze przy użyciu uwierzytelniania tożsamości zarządzanej przy użyciu usługi ARM, Bicep, Terraform, zasad i dołączania portalu. KontenerLogV2 można jawnie włączyć za pomocą interfejsu wiersza polecenia w wersji 2.51.0 lub nowszej przy użyciu ustawień zbierania danych.

Obsługa tabeli ContainerLog zostanie wycofana 30 września 2026 r.

Porównanie tabel

W poniższej tabeli przedstawiono najważniejsze różnice między używaniem schematu ContainerLogV2 i ContainerLog.

Różnice między funkcjami ContainerLog ContainerLogV2
Schemat Szczegółowe informacje na stronie ContainerLog. Szczegóły na stronie ContainerLogV2.
Dodatkowe kolumny to:
- ContainerName
- PodName
- PodNamespace.
Wprowadzanie Można konfigurować tylko za pomocą narzędzia ConfigMap. Konfigurowalne za pomocą narzędzia ConfigMap i DCR. 1
Cennik Tylko zgodne z pełnowartościowymi dziennikami analitycznymi. Obsługuje warstwę dzienników podstawowych o niskich kosztach oprócz dzienników analitycznych.
Wykonywanie zapytania Wymaga wielu operacji sprzężenia z tabelami spisu dla standardowych zapytań. Zawiera dodatkowe metadane zasobnika i kontenera, aby zmniejszyć złożoność zapytań i operacje łączenia.
Wiele wierszy Nieobsługiwane wpisy wielowierszowe są podzielone na wiele wierszy. Obsługa rejestrowania wielowierszowego w celu umożliwienia skonsolidowanych, pojedynczych wpisów dla danych wyjściowych wielowierszowych.

1Konfiguracja dcR nie jest obsługiwana w przypadku klastrów korzystających z klastrów opartych na uwierzytelnianiu jednostki usługi. Przeprowadź migrację klastrów z jednostką usługi do tożsamości zarządzanej , aby korzystać z tego środowiska.

Uwaga

Eksportowanie do centrum zdarzeń i konta magazynu nie jest obsługiwane, jeśli przychodzący komunikat LogMessage nie jest prawidłowym plikiem JSON. Aby uzyskać najlepszą wydajność, zalecamy emitowanie dzienników kontenerów w formacie JSON.

Ocena wpływu na istniejące alerty

Przed włączeniem schematu ContainerLogsV2 należy ocenić, czy istnieją reguły alertów, które opierają się na tabeli ContainerLog . Aby korzystać z nowej tabeli, należy zaktualizować wszystkie takie alerty.

Aby przeprowadzić skanowanie pod kątem alertów odwołujących się do tabeli ContainerLog , uruchom następujące zapytanie usługi Azure Resource Graph:

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

Włączanie schematu ContainerLogV2

Można włączyć schemat ContainerLogV2 dla klastra przy użyciu reguły zbierania danych klastra (DCR) lub ConfigMap. Jeśli oba ustawienia są włączone, pierwszeństwo będzie mieć ConfigMap. Dzienniki Stdout i stderr zostaną pozyskane tylko do tabeli ContainerLog, gdy zarówno dcR, jak i ConfigMap są jawnie wyłączone.

Rejestrowanie wielowierszowe w usłudze Container Szczegółowe informacje

Po włączeniu rejestrowania wielowierszowego wcześniej podzielone dzienniki kontenerów są łączone i wysyłane jako pojedyncze wpisy do tabeli ContainerLogV2. Jeśli linia dziennika szwów jest większa niż 64 KB, zostanie obcięta z powodu limitów obszaru roboczego usługi Log Analytics. Ta funkcja obsługuje również ślady stosu .NET, Go, Python i Java, które są wyświetlane jako pojedyncze wpisy w tabeli ContainerLogV2. Włącz rejestrowanie wielowierszowe za pomocą narzędzia ConfigMap zgodnie z opisem w temacie Konfigurowanie zbierania danych w usłudze Container Insights przy użyciu narzędzia ConfigMap.

Uwaga

Mapa konfiguracji zawiera teraz opcję specyfikacji języka, w której klienci mogą wybrać tylko języki, które cię interesują. Tę funkcję można włączyć, edytując języki w opcji stacktrace_languages na mapie konfiguracji.

Na poniższych zrzutach ekranu przedstawiono rejestrowanie wielowierszowe dla śledzenia stosu wyjątków języka Go:

Rejestrowanie wielowierszowe jest wyłączone

Screenshot that shows Multi-line logging disabled.

Włączono rejestrowanie wielowierszowe

Screenshot that shows Multi-line enabled.

Ślad stosu języka Java

Screenshot that shows Multi-line enabled for Java.

Ślad stosu języka Python

Screenshot that shows Multi-line enabled for Python.

Następne kroki