Schema del log di Informazioni dettagliate sui contenitori

Articolo
02/06/2024

Informazioni dettagliate sui contenitori archivia i dati di log raccolti in una tabella denominata ContainerLogV2. Questo articolo descrive lo schema di questa tabella e il relativo confronto e migrazione dalla tabella ContainerLog legacy.

Importante

ContainerLogV2 sarà lo schema predefinito tramite ConfigMap per l'interfaccia della riga di comando versione 2.54.0 e successive. ContainerLogV2 sarà il formato di inserimento predefinito per i clienti che eseguiranno l'onboarding di informazioni dettagliate sui contenitori con l'autenticazione dell'identità gestita usando ARM, Bicep, Terraform, Criteri e onboarding del portale. ContainerLogV2 può essere abilitato in modo esplicito tramite l'interfaccia della riga di comando versione 2.51.0 o successiva usando le impostazioni di raccolta dati.

Il supporto per la tabella ContainerLog verrà ritirato il 30 settembre 2026.

Confronto tra tabelle

La tabella seguente evidenzia le differenze principali tra l'uso dello schema ContainerLogV2 e ContainerLog.

Differenze di funzionalità	ContainerLog	ContainerLogV2
Schema	Dettagli in ContainerLog.	Dettagli in ContainerLogV2. Le colonne aggiuntive sono: - `ContainerName` - `PodName` - `PodNamespace`.
Onboarding	Configurabile solo tramite ConfigMap.	Configurabile tramite ConfigMap e DCR. ¹
Prezzi	Compatibile solo con i log di analisi a prezzi completi.	Supporta il livello di log di base a basso costo oltre ai log di analisi.
Query	Richiede più operazioni di join con tabelle di inventario per le query standard.	Include metadati aggiuntivi di pod e contenitori per ridurre la complessità delle query e le operazioni di join.
Multiriga	Non supportato, le voci su più righe vengono suddivise in più righe.	Supporto per la registrazione su più righe per consentire voci singole consolidate per l'output multilinea.

¹Configurazione DCR non supportata per i cluster che usano cluster basati sull'autenticazione dell'entità servizio. Eseguire la migrazione dei cluster con l'entità servizio all'identità gestita per usare questa esperienza.

Nota

L'esportazione nell'hub eventi e l'account Archiviazione non è supportato se LogMessage in ingresso non è un codice JSON valido. Per ottenere prestazioni ottimali, è consigliabile creare log dei contenitori in formato JSON.

Valutare l'impatto sugli avvisi esistenti

Prima di abilitare lo schema ContainerLogsV2 , è necessario valutare se sono presenti regole di avviso che si basano sulla tabella ContainerLog . È necessario aggiornare tali avvisi per usare la nuova tabella.

Per analizzare gli avvisi che fanno riferimento alla tabella ContainerLog , eseguire la query di Azure Resource Graph seguente:

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

Abilitare lo schema ContainerLogV2

È possibile abilitare lo schema ContainerLogV2 per un cluster usando la regola di raccolta dati del cluster o ConfigMap. Se entrambe le impostazioni sono abilitate, ConfigMap avrà la precedenza. I log stdout e stderr verranno inseriti nella tabella ContainerLog solo quando sia DCR che ConfigMap vengono esplicitamente disattivati.

Registrazione su più righe in Container Insights

Con la registrazione su più righe abilitata, i log dei contenitori suddivisi in precedenza vengono uniti e inviati come singole voci alla tabella ContainerLogV2. Se la linea di log punti è superiore a 64 KB, verrà troncata a causa dei limiti dell'area di lavoro Log Analytics. Questa funzionalità include anche il supporto per le tracce dello stack .NET, Go, Python e Java, che vengono visualizzate come singole voci nella tabella ContainerLogV2. Abilitare la registrazione su più righe con ConfigMap come descritto in Configurare la raccolta dati in Informazioni dettagliate contenitore con ConfigMap.

Gli screenshot seguenti mostrano la registrazione su più righe per l'analisi dello stack di eccezioni Go:

Registrazione su più righe disabilitata