Esquema de registro de Container Insights

Artículo
03/06/2024

Container Insights almacena los datos de registro que recopila en una tabla denominada ContainerLogV2. Este artículo describe el esquema de la tabla, así como la comparación con la tabla ContainerLog y la migración desde esta.

Importante

ContainerLogV2 será el esquema predeterminado a través de ConfigMap para la versión 2.54.0 de la CLI y versiones posteriores. ContainerLogV2 será el formato de ingesta predeterminado para los clientes que van a incorporar información de contenedor con la autenticación de identidad administrada mediante ARM, Bicep, Terraform, Policy y la incorporación del portal. ContainerLogV2 se puede habilitar explícitamente a través de la versión 2.51.0 o posterior de la CLI mediante la configuración de recopilación de datos.

La compatibilidad con la tabla ContainerLog se retirará el 30 de septiembre de 2026.

Comparación de tablas

En la tabla siguiente se destacan las principales diferencias entre el uso de los esquemas ContainerLogV2 y ContainerLog.

Diferencias de características	ContainerLog	ContainerLogV2
Esquema	Detalles en ContainerLog.	Detalles en ContainerLogV2. Las columnas adicionales son: - `ContainerName` - `PodName` - `PodNamespace`.
Incorporación	Configurable solamente a través de ConfigMap.	Configurable a través de ConfigMap y DCR. ¹
Precios	Solo compatible con los registros de análisis de precio completo.	Admite el nivel de registros básicos de bajo costo, además de los registros de análisis.
Consultas	Requiere varias operaciones de combinación con tablas de inventario para las consultas estándar.	Incluye metadatos adicionales de pod y contenedor para reducir la complejidad de las consultas y las operaciones de combinación.
Multilínea	No se admite, las entradas de varias líneas se dividen en varias filas.	Compatibilidad con el registro de varias líneas para permitir entradas únicas y consolidadas para la salida de varias líneas.

¹La configuración de DCR no se admite para clústeres que usan clústeres basados en la autenticación de la entidad de servicio. Migre los clústeres con la entidad de servicio a la identidad administrada para usar esta experiencia.

Nota:

No se admite la exportación al centro de eventos y a la cuenta de almacenamiento si LogMessage entrante no es un JSON válido. Para obtener el mejor rendimiento, se recomienda emitir registros de contenedor en formato JSON.

Evalúa el impacto las alertas existentes

Antes de habilitar el esquema ContainerLogsV2, debe comprobar si tiene reglas de alerta que dependan de la tabla ContainerLog. Todas esas alertas deberán actualizarse para usar la nueva tabla.

Para buscar las alertas que puedan hacer referencia a la tabla ContainerLog, ejecute la consulta de Azure Resource Graph siguiente:

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 el esquema ContainerLogV2

Puede habilitar el esquema ContainerLogV2 en el nivel de clúster a través de la regla de recopilación de datos (DCR) del clúster o ConfigMap. Si ambas opciones están habilitadas, ConfigMap tendrá prioridad. Los registros stdout y stderr solo se ingerirán en la tabla ContainerLog cuando DCR y ConfigMap se establezcan explícitamente en desactivados.

Registro de varias líneas en Container Insights

Con el registro de varias líneas habilitado, los registros de contenedor divididos previamente se unen y se envían como entradas únicas a la tabla ContainerLogV2. Si la línea de registro unida es superior a 64 KB, se truncará debido a los límites del área de trabajo de Log Analytics. Esta característica también admite seguimientos de la pila de .NET, Go, Python y Java, que aparecen como entradas únicas en la tabla ContainerLogV2. Habilite el registro de varias líneas con ConfigMap tal como se describe en Configuración de la recopilación de datos en Container Insights mediante ConfigMap.

Nota:

El mapa de configuración ahora incluye una opción de especificación de idioma, donde los clientes pueden seleccionar solo los idiomas en los que están interesados. Esta característica se puede habilitar editando los idiomas de la opción stacktrace_languages del mapa de configuración.

En las capturas de pantalla siguientes se muestra el registro de varias líneas para el seguimiento de la pila de excepciones de Go:

Registro de varias líneas deshabilitado