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.
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:
Abre la página de creación de instancias de Compute Engine en Google Cloud Console.
Especifica un nombre para tu instancia.
En la sección Disco de arranque, selecciona una imagen de Container-Optimized OS
Haz clic en Administración, seguridad, discos, herramientas de redes, instancia única para expandir las opciones adicionales.
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 comotrue
.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.
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
Ve a la página Instancias de VM
Haz clic en el nombre de la instancia de Container-Optimized OS que deseas actualizar.
Haz clic en Editar en la barra superior Detalles de la instancia de VM.
En la sección Metadatos personalizados, agrega una entrada de metadatos nueva con Clave como
google-logging-enabled
y Valor comotrue
para habilitar ofalse
para inhabilitarlo.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 yfalse
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
Ve a la página Instancias de VM
Haz clic en el nombre de la instancia de Container-Optimized OS desde la que quieres acceder a los registros.
En la sección Registros, haz clic en Cloud Logging.
Esto abrirá el Explorador de registros de la instancia en cuestión. 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 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.