Cuando usas VM Extension Manager 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 o solucionar cualquier problema con las extensiones de tu 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 servicios y las APIs de Google Cloud . 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 que corresponda a la forma en que planeas usar las muestras de esta página:
Console
Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.
gcloud
-
Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:
gcloud initSi usas un proveedor de identidad externo (IdP), primero debes acceder a la 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 Google Cloud CLI.
Si usas un proveedor de identidad externo (IdP), primero debes acceder a la 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 .
Visualiza los registros de la extensión de VM
Para ver los registros de extensiones de VM, usa la consola de Google Cloud , 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 período (por ejemplo,2024-02-01T00:00:00Z).
Ejemplo de búsqueda:
resource.type="gce_instance" resource.labels.instance_id="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 los registros de la extensión de VM, usa el comando logging read. 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: el comienzo del período (por ejemplo,2024-01-01T00:00:00Z).END_TIME: Es el final del período (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 período (por ejemplo,2024-01-01T00:00:00Z).END_TIME: Es el final del período (por ejemplo,2024-02-01T00:00:00Z).PROJECT_ID: Es el ID del proyecto de Google Cloud .
Entrada de registro de eventos de la 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": "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 la extensión de VM:
| Campo | Descripción |
|---|---|
eventMessage |
Es un mensaje que describe el evento, incluido el estado de aplicación de la política y el estado de la extensión. |
extensionName |
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 que se fijó en la política de la extensión o la versión más reciente si no se fijó ninguna. |
revisionId |
Es un archivo binario específico de una versión de la extensión. Cada versión de la 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 archivo binario correcto para la VM. |
eventType |
El tipo de evento Puede ser uno de los siguientes valores:
|