Usa Cloud Logging con Container-Optimized OS

A partir del evento importante 67, Container-Optimized OS incluye el agente heredado de Logging de Google Cloud's operations suite que exporta registros del sistema y del contenedor a Cloud Logging Para obtener más información, consulta la fuente de configuración específica de Container-Optimized OS o la documentación de Google Cloud's operations suite. Este documento se centra en cómo usar el agente de Logging en Container-Optimized OS y cómo acceder a los registros.

Crea una instancia nueva con el agente de Logging habilitado

Console

Para ejecutar una instancia de Compute Engine en Container-Optimized OS con el agente de Logging habilitado, haz lo siguiente:

  1. Abre la página Creación de instancia de Compute Engine en Google Cloud Console.

    Cree una instancia nueva de Compute Engine

  2. Especifica un nombre para tu instancia.

  3. En la sección Disco de arranque, selecciona una imagen de Container-Optimized OS

  4. Haz clic en Administración, seguridad, discos, instancia única y herramientas de redes para expandir las opciones adicionales.

  5. En la pestaña Administración, desplázate hasta la sección Metadatos. Agrega una nueva entrada de metadatos, con la Clave como google-logging-enabled y el Valor como true.

  6. De manera opcional, especifica otras opciones para tu caso práctico. Consulta Crea y configura instancias para obtener más detalles.

  7. Haz clic en Crear para crear y, además, iniciar la instancia.

gcloud

Para ejecutar una instancia de Compute Engine en Container-Optimized OS con el agente de Logging habilitado, usa el comando gcloud compute instances create con google-logging-enabled=true en los metadatos. Por ejemplo:

gcloud compute instances create instance-name \
    --image-family cos-stable \
    --image-project cos-cloud \
    --zone compute-zone \
    --metadata google-logging-enabled=true

Reemplaza lo siguiente:

  • instance-name por el nombre de tu instancia de VM.
  • compute-zone por la zona de procesamiento de tu instancia.

Para obtener más información sobre el comando gcloud, consulta la documentación de referencia de gcloud compute instances create. Para obtener más información sobre cómo crear instancias de Container-Optimized OS, consulta Crea y configura instancias.

Actualiza una instancia existente para habilitar o inhabilitar el agente de Logging

Console

  1. Ve a la página Instancias de VM

    Ir a la página Instancias de VM

  2. Haz clic en el nombre de la instancia de Container-Optimized OS que deseas actualizar.

  3. Haz clic en Editar en la barra superior de Detalles de la instancia de VM.

  4. En la secciónMetadatos personalizados agrega una nueva entrada de metadatos, conTecla Comogoogle-logging-enabled yValor astrue para habilitar ofalse para inhabilitarla.

  5. Haz clic en Guardar.

gcloud

Para habilitar o inhabilitar el agente de Logging en una instancia existente, usa el comando gcloud compute instances add-metadata:

gcloud compute instances add-metadata instance-name \
    --zone compute-zone \
    --metadata google-logging-enabled=enabled-value

Reemplaza lo siguiente:

  • enabled-value: true para habilitar, false para inhabilitar.
  • instance-name por el nombre de tu instancia de VM.
  • compute-zone por la zona de procesamiento de tu instancia.

Accede a los registros

Console

  1. Ve a la página Instancias de VM

    Ir a la página Instancias de VM

  2. Haz clic en el nombre de la instancia de Container-Optimized OS desde la que quieres acceder a los registros.

  3. En la sección Registros, haz clic en Cloud Logging.

  4. Esto abre el Explorador de registros para la instancia determinada. Para obtener más información, consulta Usa el Explorador de registros.

gcloud

Para acceder a los registros, usa el comando gcloud logging read. Por ejemplo:

gcloud logging read \
"resource.type=gce_instance AND resource.labels.instance_id=instance-id" \
    --limit 10 \
    --format json \
    --freshness 30d

Reemplaza lo siguiente:

  • instance-id: Es el ID de la instancia de VM.

Con este comando, se intentan leer los registros de la instancia de VM con instance-id y se limitan a 10 registros en formato JSON de los últimos 30 días.

Para obtener más información sobre el comando gcloud, consulta la documentación de referencia de lectura de registros de gcloud.

Limitaciones conocidas

Compatibilidad con el controlador gcplogs

A partir del evento 89, si el agente de registro incluido con Container-Optimized OS está habilitado y el controlador de registro de Docker gcplogs está habilitado para uno o más contenedores, se realiza un exceso El registro puede generar los registros de advertencia mediante el agente de Logging incluido. Esto puede generar ruido de registro o aumentar los cargos relacionados de Cloud Logging.

Una solución alternativa es no usar gcplogs como un controlador de registro de Docker y, en su lugar, usar el controlador predeterminado que configuró Container-Optimized OS. Ten en cuenta que el agente de registro incluido con Container-Optimized OS exportará los registros de contenedor a Cloud Logging, por lo que no es necesario usar ambas soluciones al mismo tiempo.