Cuando usas Gestor de extensiones de VM para administrar extensiones en tus instancias de Compute Engine (VMs), el agente invitado de cada VM registra eventos sobre la aplicación de la extensión. Usa Cloud Logging para ver estos registros en el Explorador de registros y supervisar y solucionar cualquier problema con tus extensiones de VM.
Antes de comenzar
- Lee la documentación de Gestor de extensiones de VM.
- Lee cómo usar el Explorador de registros.
-
Si aún no lo hiciste, configura la autenticación.
La autenticación verifica tu identidad para acceder a los Google Cloud servicios y las APIs. Para ejecutar
código o muestras desde un entorno de desarrollo local, puedes autenticarte en
Compute Engine seleccionando una de las siguientes opciones:
Selecciona la pestaña según cómo planeas usar las muestras en esta página:
Console
Cuando usas la Google Cloud consola de para acceder a los Google Cloud servicios y las APIs de, no necesitas configurar la autenticación.
gcloud
-
Instala la Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:
gcloud initSi usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.
-
- Configura una región y una zona predeterminadas.
REST
Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.
Instala la Google Cloud CLI.
Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.
Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de. Google Cloud
Consulta los registros de extensiones de VM
Para ver los registros de extensiones de VM, usa la Google Cloud consola de, Google Cloud CLI o REST.
Console
- En la consola de Google Cloud , accede a la página Explorador de registros.
En el campo Consulta, ingresa la siguiente consulta:
resource.type="gce_instance" resource.labels.instance_id="INSTANCE_ID" jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" jsonPayload.extensionName="EXTENSION_NAME" timestamp >= START_TIME timestamp <= END_TIMEReemplaza lo siguiente:
INSTANCE_ID: Es el ID de la instancia de VM.EXTENSION_NAME: Es el nombre de la extensión (por ejemplo,ops-agent).START_TIME: Es el comienzo del intervalo de tiempo (por ejemplo,2024-01-01T00:00:00Z).END_TIME: Es el final del intervalo de tiempo (por ejemplo,2024-02-01T00:00:00Z).
Consulta de ejemplo:
resource.type="gce_instance" resource.labels.instance_id="projects/7654321/zones/us-central1-a/instances/123456" jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" jsonPayload.extensionName="ops-agent" timestamp >= "2024-01-01T00:00:00Z" timestamp <= "2024-02-01T01:00:00Z"Haz clic en Ejecutar consulta.
gcloud
Para buscar registros de extensiones de VM, usa el logging read
comando. Por ejemplo:
gcloud logging read 'resource.type="gce_instance" AND \
resource.labels.instance_id="INSTANCE_ID" AND \
jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" AND \
jsonPayload.extensionName="YOUR_EXTENSION_NAME" AND \
timestamp >= "START_TIME" AND \
timestamp <= "END_TIME"'
Reemplaza lo siguiente:
INSTANCE_ID: Es el ID de la instancia de VM.YOUR_EXTENSION_NAME: Es el nombre de la extensión (por ejemplo,ops-agent).START_TIME: Es el comienzo del intervalo de tiempo (por ejemplo,2024-01-01T00:00:00Z).END_TIME: Es el final del intervalo de tiempo (por ejemplo,2024-02-01T00:00:00Z).
REST
Realiza una solicitud a la API
de Logging V2. El cuerpo de la solicitud debe contener el parámetro filter. Por ejemplo:
POST https://logging.googleapis.com/v2/entries:list
{
"filter": "resource.type="gce_instance" AND
"resource.labels.instance_id="INSTANCE_ID" AND
"jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" AND
"jsonPayload.extensionName="EXTENSION_NAME" AND
"timestamp >= "START_TIME" AND
"timestamp <= "END_TIME",
"pageSize": 10,
"resourceNames": [
"projects/PROJECT_ID"
]
}
Reemplaza lo siguiente:
INSTANCE_ID: Es el ID de la instancia de VM.EXTENSION_NAME: Es el nombre de la extensión (por ejemplo,ops-agent).START_TIME: Es el comienzo del intervalo de tiempo (por ejemplo,2024-01-01T00:00:00Z).END_TIME: Es el final del intervalo de tiempo (por ejemplo,2024-02-01T00:00:00Z).PROJECT_ID: Es el ID del Google Cloud proyecto.
Entrada de registro de eventos de extensión de VM
A continuación, se muestra un ejemplo de una entrada de registro para un evento de extensión de VM:
{
"insertId": "rsiudxbck",
"jsonPayload": {
"eventMessage": "Enforcement State: Installing ops-agent@4bda61add3e5c989.; Extension Health: Plugin is running ok",
"timestamp": "2026-03-23T16:13:40.496755675Z",
"extensionName": "ops-agent",
"revisionId": "4bda61add3e5c989",
"@type": "type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent",
"eventType": "INSTALLED"
},
"resource": {
"type": "gce_instance",
"labels": {
"project_id": "27654321",
"instance_id": "projects/7654321/zones/us-west1-a/instances/1234567",
"zone": "us-west1-a"
}
},
"timestamp": "2026-03-23T16:13:40.496854498Z",
"severity": "INFO",
"logName": "projects/my-project/logs/compute.googleapis.com%2Fvm_extension_policies",
"receiveTimestamp": "2026-03-23T16:13:40.906133199Z"
}
Detalles de la entrada de registro
En la siguiente tabla, se describen los parámetros que puedes encontrar en los registros de extensiones de VM:
| Campo | Descripción |
|---|---|
eventMessage |
Es un mensaje que describe el evento, incluido el estado de aplicación y el estado de la extensión. |
extensionName |
Es el nombre de la extensión (por ejemplo, ops-agent).
Para obtener una lista de las extensiones compatibles y sus nombres, consulta Extensiones compatibles. |
extensionVersion |
Es la versión de la extensión que se seleccionó para la instalación. Esta versión es la versión fijada en la política de extensión o la versión más reciente si no se fijó ninguna versión. |
revisionId |
Es un objeto binario específico de una versión de extensión. Cada versión de extensión puede tener varias revisiones para admitir diferentes sistemas operativos, y Google elige automáticamente la correcta para una VM específica. Proporcionar este ID de revisión al equipo de asistencia de Google puede ayudar a depurar si se eligió el objeto binario correcto para la VM. |
eventType |
El tipo de evento Puede ser uno de los siguientes valores:
|