Usa Cloud Logging con Container-Optimized OS

A partir de milestone 67, Container-Optimized OS incluye el agente de Logging del paquete de operaciones de Google Cloud, que exporta los registros del sistema y del contenedor a Cloud. Registro. Para obtener más detalles, consulta la fuente de configuración específica de Container-Optimized OS o la documentación del paquete de operaciones de Google Cloud. En este documento, se explica cómo usar el agente de registro en Container-Optimized OS y cómo acceder a los registros.

Nota: Logging está disponible automáticamente cuando eliges Container-Optimized OS como la imagen de nodo para ejecutar los clústeres de Google Kubernetes Engine. Estas instrucciones son para las situaciones en las que usas Container-Optimized OS fuera de GKE, como en Compute Engine.

Crea una instancia nueva con el agente de Logging habilitado

Console

Para ejecutar una instancia de Compute Engine en Container-Optimized OS con un agente de registro habilitado, realiza las siguientes acciones:

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

   Cree una nueva instancia 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, herramientas de redes, instancia única para expandir las opciones adicionales.

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

6. De manera opcional, especifica cualquier otra opción para tu caso práctico. Consulta la página sobre cómo crear y configurar 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 registro habilitado, usa el comando gcloud compute instances create y agrega 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.

Si deseas obtener más información sobre el comando gcloud, consulta la documentación de referencia de gcloud compute instances create. Para obtener más detalles sobre cómo crear instancias de Container-Optimized OS, consulta la página sobre cómo crear y configurar instancias.

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

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 Detalles de la instancia de VM.

4. En la sección Metadatos personalizados, agrega una entrada de metadatos nueva con Clave como google-logging-enabled y Valor como true para habilitar o false para inhabilitarlo.

5. Haz clic en Guardar.

gcloud

Para habilitar o inhabilitar el agente de registro 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 y false para inhabilitarla.
• 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 abrirá el Explorador de registros de la instancia en cuestión. Para obtener más información, consulta Usa el Explorador de registros.

Nota: En el compilador de consultas, puedes filtrar por nombre de registro. Haz clic en Nombre del registro y selecciona el nombre del registro proporcionado. Por ejemplo, cos_audit para registros de auditoría o cos_containers para registros de contenedor de Docker.

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 tu instancia de VM.

Este comando intenta leer registros de la instancia de VM con instance-id, limitar 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 gcloud logging read.