Compartir a través de

Opciones de almacenamiento y supervisión de registros en Azure Container Apps

Azure Container Apps ofrece opciones para almacenar y ver los registros de la aplicación. Puede configurar las opciones de registro en el nivel de entorno de Container Apps. Si selecciona Azure Monitor como destino de los registros, puede configurar las opciones de diagnóstico tanto en el nivel de entorno como en el nivel de aplicación de contenedor.

Los registros de aplicaciones de Container Apps constan de dos categorías diferentes:

  • Mensajes de salida de la consola de contenedor (stdout/stderr).
  • Registros del sistema generados por Azure Container Apps.
  • Registros de la consola de Spring App.

Puede elegir entre estos destinos de registros:

  • Log Analytics: Log Analytics de Azure Monitor es la opción de almacenamiento y visualización predeterminadas. Los registros se almacenan en un área de trabajo de Log Analytics donde se pueden ver y analizar mediante consultas de Log Analytics. Para más información sobre Log Analytics, consulte Log Analytics de Azure Monitor.
  • Azure Monitor: Azure Monitor enruta los registros a uno o varios destinos:
    • Área de trabajo de Log Analytics para ver y analizar.
    • Una cuenta de Azure Storage para archivar.
    • Centro de eventos de Azure para la ingesta de datos y los servicios analíticos. Para obtener más información, consulte Azure Event Hubs.
    • Una solución de supervisión de asociados de Azure, como, Datadog, Elastic, Logz.io y otros. Para más información, consulte Soluciones de asociados.
  • No guardar registros: puede deshabilitar el almacenamiento de datos de registro. Cuando está inhabilitado, aún puede ver los registros de contenedor en tiempo real a través de la función flujo de registros en su aplicación de contenedores. Para obtener más información, consulte Transmisión de registros.

Cuando se selecciona No guardar registros o el destino de Azure Monitor, el elemento de menú Registros que proporciona el editor de consultas de Log Analytics en el Azure Portal está deshabilitado.

Configuración de opciones de registro

Siga estos pasos para configurar las opciones de registro de su entorno en Azure Portal:

  1. Vaya al entorno de Container Apps en el portal.

  2. Seleccione supervisión>Opciones de registro.

  3. Puede elegir entre las siguientes opciones de destino de registros :

    • Azure Log Analytics: con esta opción, seleccione un área de trabajo de Log Analytics para almacenar los datos de registro. Los registros se pueden ver a través de consultas de Log Analytics. Para más información sobre Log Analytics, consulte Log Analytics de Azure Monitor.
    • Azure Monitor: Azure Monitor enruta los registros a un destino. Al seleccionar esta opción, debe seleccionar Configuración de diagnóstico para completar la configuración después de seleccionar Guardar en esta página.
    • No guardar registros: esta opción deshabilita el almacenamiento de datos de registro.

  4. Seleccione Guardar.

Configuración de diagnóstico

Si seleccionó Azure Monitor como destino de los registros, también debe configurar las opciones de diagnóstico. Puede configurar las opciones de diagnóstico tanto en el nivel de entorno como en el nivel de aplicación de contenedor.

Configuración de las opciones de diagnóstico en el nivel de entorno

Siga estos pasos para configurar las opciones de diagnóstico para su entorno:

  1. Vaya a su entorno en el portal.

  2. Seleccione Supervisión>Configuración de diagnóstico. Si acaba de establecer el destino de los registros del entorno en Azure Monitor, es posible que tenga que actualizar la página para que aparezca este elemento de configuración.

Los detalles de destino se guardan como configuración de diagnóstico. Puede crear hasta cinco configuraciones de diagnóstico para su entorno. Puede configurar diferentes categorías de registro para cada configuración de diagnóstico. Por ejemplo, cree una configuración de diagnóstico para enviar la categoría de registros del sistema a un destino y otra para enviar la categoría de registros de la consola de contenedor a otro destino.

Creación de una nueva configuración de diagnóstico:

  1. Seleccione Agregar configuración de diagnóstico.

  2. En Nombre de configuración de diagnóstico, introduzca un nombre para su configuración de diagnóstico.

  3. Seleccione los grupos de categorías de registro o categorías que desea enviar a este destino. Puede seleccionar una o varias categorías.

  4. Si desea enviar métricas de nivel de aplicación, seleccione Métricas>AllMetrics.

  5. Seleccione uno o varios detalles de destino:

    • Enviar al área de trabajo de Log Analytics: seleccione entre las áreas de trabajo de Log Analytics existentes.
    • Archivar en una cuenta de almacenamiento: seleccione entre cuentas de Almacenamiento de Azure.
    • Transmisión a un centro de eventos: seleccione de entre el centro de eventos de Azure.
    • Enviar a una solución de asociado: seleccione entre las soluciones de asociados de Azure.

  6. Seleccione Guardar.

Para más información sobre la configuración de diagnóstico, consulte Configuración de diagnóstico en Azure Monitor.

Configuración de las opciones de diagnóstico en el nivel de aplicación de contenedor

Siga estos pasos para configurar las opciones de diagnóstico de la aplicación contenedora:

  1. Vaya a su aplicación contenedora en el portal.

  2. Seleccione Supervisión>Configuración de diagnóstico. Si acaba de establecer el destino de registros del entorno de la aplicación contenedora en Azure Monitor, es posible que tenga que actualizar la página para que aparezca este elemento de configuración.

  3. Seleccione Agregar configuración de diagnóstico.

  4. En Nombre de configuración de diagnóstico, introduzca un nombre para su configuración de diagnóstico.

  5. En Métricas, seleccione AllMetrics.

  6. Seleccione uno o varios detalles de destino:

    • Enviar al área de trabajo de Log Analytics: seleccione entre las áreas de trabajo de Log Analytics existentes.
    • Archivar en una cuenta de almacenamiento: esta opción está en desuso.
    • Transmisión a un centro de eventos: seleccione de entre el centro de eventos de Azure.
    • Enviar a una solución de asociado: seleccione entre las soluciones de asociados de Azure.

  7. Seleccione Guardar.

Configuración de opciones de registro

Configure el destino de los registros para el entorno de Container Apps mediante la CLI de Azure y los comandos az containerapp create y az containerapp update con el argumento --logs-destination.

En primer lugar, registre el espacio de nombres Microsoft.Insights.

az provider register --namespace Microsoft.Insights

Envío a un área de trabajo de Log Analytics

Para crear un entorno de Container Apps mediante un área de trabajo de Log Analytics existente como destino de registros, ejecute el siguiente comando. Reemplace el <PLACEHOLDERS> por sus valores. Puede obtener el identificador de recurso del área de trabajo de Log Analytics desde la página del área de trabajo de Log Analytics en Azure Portal o desde el az monitor log-analytics workspace show comando .

az containerapp env create \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --logs-destination log-analytics \
  --logs-workspace-id <LOG_ANALYTICS_WORKSPACE_ID>

El --logs-destination argumento acepta los valores log-analytics, azure-monitory none.

Envío a Azure Monitor

Para actualizar un entorno de Container Apps existente para usar Azure Monitor como destino de los registros, ejecute el siguiente comando. Reemplace <PLACEHOLDERS> por valores propios:

az containerapp env update \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --logs-destination azure-monitor

Configuración de las opciones de diagnóstico

Cuando --logs-destination se establece en azure-monitor, debe crear configuraciones de diagnóstico para configurar los detalles de destino de las categorías de registro con el comando az monitor diagnostics-settings. Puede configurar estas opciones de diagnóstico en el nivel de entorno y en el nivel de aplicación de contenedor.

Para crear la configuración de diagnóstico en el nivel de entorno, ejecute el siguiente comando. Reemplace el <PLACEHOLDERS> por sus valores. Puede obtener el identificador de entorno desde la página de entorno en el Azure portal o con el comando az containerapp env show.

az monitor diagnostic-settings create \
  --name "AllMetricsToLogAnalytics" \
  --resource <ENVIRONMENT_ID> \
  --logs '[{"categoryGroup":"allLogs","enabled":true}]' \
  --metrics '[{"category":"AllMetrics","enabled":true}]' \
  --workspace <LOG_ANALYTICS_RESOURCE_ID>

Asegúrese de que no haya espacios en los valores JSON proporcionados a los --logs parámetros y --metrics .

Para el --logs parámetro , puede especificar category o categoryGroup, pero no ambos a la vez. Para categoryGroup, los valores disponibles son audit y allLogs. Para category, los valores disponibles son ContainerAppConsoleLogs y ContainerAppSystemLogs.

Para el --metrics parámetro , la única categoría disponible es AllMetrics.

Para obtener más información, consulte LogSettings y MetricSettings.

Para crear la configuración de diagnóstico en el nivel de aplicación de contenedor, ejecute el siguiente comando. Reemplace el <PLACEHOLDERS> por sus valores. Puede obtener el identificador de aplicación de contenedor desde Azure Portal o desde el az containerapp show comando .

Al crear la configuración de diagnóstico en el nivel de aplicación de contenedor, no se admite el --logs parámetro y, para el --metrics parámetro , la única categoría disponible es AllMetrics.

az monitor diagnostic-settings create \
--name "AllMetricsToLogAnalytics" \
--resource <CONTAINER_APP_ID> \
--metrics '[{"category":"AllMetrics","enabled":true}]' \
--workspace <LOG_ANALYTICS_RESOURCE_ID>

Para más información sobre los comandos de configuración de diagnóstico de Azure Monitor, consulte az monitor diagnostic-settings.

Limitaciones

Las siguientes limitaciones se aplican a medida que configura las opciones de registro.

  • Private Link: no se admite el envío de registros directamente a un área de trabajo de Log Analytics a través de Private Link. Sin embargo, puede usar Azure Monitor y enviar los registros al mismo área de trabajo de Log Analytics. Esta indirección es necesaria para evitar la pérdida de datos de registro del sistema.

Pasos siguientes

Supervisión de registros con Log Analytics