Container Insights-logboekschema

Artikel
03/05/2024

Container Insights slaat logboekgegevens op die worden verzameld in een tabel met de naam ContainerLogV2. In dit artikel wordt het schema van deze tabel en de vergelijking en migratie van de verouderde ContainerLog-tabel beschreven.

Belangrijk

ContainerLogV2 is het standaardschema via de ConfigMap voor CLI versie 2.54.0 en hoger. ContainerLogV2 is de standaardopname-indeling voor klanten die containerinzichten onboarden met Managed Identity-verificatie met behulp van ARM, Bicep, Terraform, Beleid en Portal-onboarding. ContainerLogV2 kan expliciet worden ingeschakeld via CLI-versie 2.51.0 of hoger met behulp van instellingen voor gegevensverzameling.

Ondersteuning voor de ContainerLog-tabel wordt op 30 september 2026 buiten gebruik gesteld.

Tabelvergelijking

In de volgende tabel ziet u de belangrijkste verschillen tussen het gebruik van het ContainerLogV2- en ContainerLog-schema.

Functieverschillen	ContainerLog	ContainerLogV2
Schema	Details bij ContainerLog.	Details van ContainerLogV2. Aanvullende kolommen zijn: - `ContainerName` - `PodName` - `PodNamespace`.
Onboarding	Alleen configureerbaar via ConfigMap.	Configureerbaar via zowel ConfigMap als DCR. ¹
Prijzen	Alleen compatibel met volledige analyselogboeken.	Biedt ondersteuning voor de laag eenvoudige logboeken naast analyselogboeken.
Uitvoeren van query's	Vereist meerdere joinbewerkingen met voorraadtabellen voor standaardquery's.	Bevat aanvullende pod- en containermetagegevens om de complexiteit van query's en joinbewerkingen te verminderen.
Meerdere regels	Niet ondersteund, vermeldingen met meerdere regels worden gesplitst in meerdere rijen.	Ondersteuning voor logboekregistratie met meerdere regels om geconsolideerde, enkelvoudige vermeldingen voor uitvoer met meerdere regels toe te staan.

¹DCR-configuratie wordt niet ondersteund voor clusters die gebruikmaken van op service-principal gebaseerde verificatieclusters. Migreer uw clusters met service-principal naar beheerde identiteit om deze ervaring te gebruiken.

Notitie

Exporteren naar Event Hub en opslagaccount wordt niet ondersteund als de binnenkomende LogMessage geen geldige JSON is. Voor de beste prestaties raden we u aan containerlogboeken in JSON-indeling te verzenden.

De impact op bestaande waarschuwingen beoordelen

Voordat u het ContainerLogsV2-schema inschakelt, moet u beoordelen of u waarschuwingsregels hebt die afhankelijk zijn van de ContainerLog-tabel . Dergelijke waarschuwingen moeten worden bijgewerkt om de nieuwe tabel te kunnen gebruiken.

Als u wilt scannen op waarschuwingen die verwijzen naar de ContainerLog-tabel , voert u de volgende Azure Resource Graph-query uit:

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

Het ContainerLogV2-schema inschakelen

U kunt het ContainerLogV2-schema voor een cluster inschakelen met behulp van de DCR (Data Collection Rule) of ConfigMap van het cluster. Als beide instellingen zijn ingeschakeld, heeft de ConfigMap voorrang. Stdout- en stderr-logboeken worden alleen opgenomen in de ContainerLog-tabel wanneer zowel de DCR als de ConfigMap expliciet zijn ingesteld op uit.

Logboekregistratie met meerdere regels in Container Insights

Als logboekregistratie met meerdere regels is ingeschakeld, worden eerder gesplitste containerlogboeken samengevoegd en als één vermelding naar de ContainerLogV2-tabel verzonden. Als de gestikte logboeklijn groter is dan 64 kB, wordt deze afgekapt vanwege de limieten van de Log Analytics-werkruimte. Deze functie biedt ook ondersteuning voor .NET-, Go-, Python- en Java-stacktraceringen, die worden weergegeven als één vermelding in de ContainerLogV2-tabel. Schakel logboekregistratie met meerdere regels in met ConfigMap, zoals beschreven in Gegevensverzameling configureren in Container Insights met behulp van ConfigMap.

Notitie

De configmap bevat nu een optie voor taalspecificatie, waarbij de klanten alleen de talen kunnen selecteren waarin ze geïnteresseerd zijn. Deze functie kan worden ingeschakeld door de talen te bewerken in de optie stacktrace_languages in de configmap.

In de volgende schermafbeeldingen ziet u logboekregistratie met meerdere regels voor go-uitzonderingsstacktracering:

Logboekregistratie met meerdere regels uitgeschakeld