Esquema de log de insights de contêiner

Artigo
03/05/2024

O Container insights armazena dados de log coletados em uma tabela chamada ContainerLogV2. Este artigo descreve o esquema desta tabela e sua comparação e migração da tabela ContainerLog herdada.

Importante

ContainerLogV2 será o esquema padrão através do ConfigMap para CLI versão 2.54.0 e superior. O ContainerLogV2 será o formato de ingestão padrão para clientes que integrarão informações de contêiner com Managed Identity Auth usando ARM, Bicep, Terraform, Policy e Portal. O ContainerLogV2 pode ser explicitamente habilitado por meio da CLI versão 2.51.0 ou superior usando as configurações de coleta de dados.

O suporte para a tabela ContainerLog será desativado em 30 de setembro de 2026.

Comparação de tabelas

A tabela a seguir destaca as principais diferenças entre o uso do esquema ContainerLogV2 e ContainerLog.

Diferenças entre caraterísticas	ContainerLog	ContainerLogV2
Esquema	Detalhes em ContainerLog.	Detalhes em ContainerLogV2. As colunas adicionais são: - `ContainerName` - `PodName` - `PodNamespace`.
Integração	Apenas configurável através do ConfigMap.	Configurável através do ConfigMap e DCR. ¹
Preços	Compatível apenas com logs de análise de preço completo.	Suporta a camada de logs básicos de baixo custo, além de logs de análise.
A consultar	Requer várias operações de junção com tabelas de inventário para consultas padrão.	Inclui metadados adicionais de pod e contêiner para reduzir a complexidade da consulta e operações de junção.
Multilinha	Não suportadas, as entradas de várias linhas são divididas em várias linhas.	Suporte para registro em log de várias linhas para permitir entradas únicas consolidadas para saída de várias linhas.

1 Configuração DCR não suportada para clusters que utilizam clusters baseados na autenticação da entidade de serviço. Migre seus clusters com a entidade de serviço para a identidade gerenciada para usar essa experiência.

Nota

A exportação para o Hub de Eventos e a Conta de Armazenamento não são suportadas se o LogMessage de entrada não for um JSON válido. Para obter o melhor desempenho, recomendamos a emissão de logs de contêiner no formato JSON.

Avaliar o impacto nos alertas existentes

Antes de habilitar o esquema ContainerLogsV2 , você deve avaliar se tem alguma regra de alerta que dependa da tabela ContainerLog . Esses alertas precisarão ser atualizados para usar a nova tabela.

Para procurar alertas que façam referência à tabela ContainerLog , execute a seguinte consulta do 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

Habilitar o esquema ContainerLogV2

Você pode habilitar o esquema ContainerLogV2 para um cluster usando a Regra de Coleta de Dados (DCR) ou o ConfigMap do cluster. Se ambas as configurações estiverem habilitadas, o ConfigMap terá precedência. Os logs Stdout e stderr só serão ingeridos na tabela ContainerLog quando o DCR e o ConfigMap estiverem explicitamente desativados.

Registro em log de várias linhas no Container Insights

Com o log de várias linhas habilitado, os logs de contêiner divididos anteriormente são costurados e enviados como entradas únicas para a tabela ContainerLogV2. Se a linha de log costurada for maior que 64 KB, ela será truncada devido aos limites do espaço de trabalho do Log Analytics. Esse recurso também tem suporte para rastreamentos de pilha .NET, Go, Python e Java, que aparecem como entradas únicas na tabela ContainerLogV2. Habilite o registro em log de várias linhas com o ConfigMap conforme descrito em Configurar a coleta de dados no Container insights usando o ConfigMap.

Nota

O configmap agora apresenta uma opção de especificação de idioma, na qual os clientes podem selecionar apenas os idiomas em que estão interessados. Esse recurso pode ser ativado editando os idiomas na opção stacktrace_languages no configmap.

As capturas de tela a seguir mostram o registro em log de várias linhas para o rastreamento da pilha de exceções Go:

Registo de várias linhas desativado