Quando utilizzi il gestore di estensioni VM per gestire le estensioni sulle tue istanze Compute Engine (VM), l'agente guest su ogni VM registra gli eventi relativi all'applicazione dell'estensione. Utilizza Cloud Logging per visualizzare questi log in Esplora log per monitorare e risolvere eventuali problemi relativi alle estensioni VM.
Prima di iniziare
- Leggi la documentazione relativa a gestore di estensioni VM.
- Scopri come utilizzare Esplora log.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire
codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su
Compute Engine selezionando una delle seguenti opzioni:
Seleziona la scheda relativa a come intendi utilizzare i campioni in questa pagina:
Console
Quando utilizzi la console Google Cloud per accedere ai servizi Google Cloud e alle API, non devi configurare l'autenticazione.
gcloud
-
Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:
gcloud initSe utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
-
- Imposta una regione e una zona predefinite.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .
Visualizza i log delle estensioni VM
Per visualizzare i log delle estensioni VM, utilizza la console Google Cloud , Google Cloud CLI o REST.
Console
- Nella console Google Cloud , vai alla pagina Esplora log.
Nel campo Query, inserisci la seguente query:
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_TIMESostituisci quanto segue:
INSTANCE_ID: l'ID dell'istanza VM.EXTENSION_NAME: il nome dell'estensione (ad esempioops-agent).START_TIME: l'inizio dell'intervallo di tempo (ad esempio,2024-01-01T00:00:00Z).END_TIME: la fine dell'intervallo di tempo (ad esempio,2024-02-01T00:00:00Z).
Query di esempio:
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"Fai clic su Esegui query.
gcloud
Per cercare i log delle estensioni VM, utilizza il comando
logging read. Ad esempio:
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"'
Sostituisci quanto segue:
INSTANCE_ID: l'ID dell'istanza VM.YOUR_EXTENSION_NAME: il nome dell'estensione (ad esempioops-agent).START_TIME: l'inizio dell'intervallo di tempo (ad esempio,2024-01-01T00:00:00Z).END_TIME: la fine dell'intervallo di tempo (ad esempio,2024-02-01T00:00:00Z).
REST
Invia una richiesta all'API Logging V2. Il corpo della richiesta deve
contenere il parametro filter. Ad esempio:
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"
]
}
Sostituisci quanto segue:
INSTANCE_ID: l'ID dell'istanza VM.EXTENSION_NAME: il nome dell'estensione (ad esempioops-agent).START_TIME: l'inizio dell'intervallo di tempo (ad esempio,2024-01-01T00:00:00Z).END_TIME: la fine dell'intervallo di tempo (ad esempio,2024-02-01T00:00:00Z).PROJECT_ID: il tuo ID progetto Google Cloud .
Voce di log eventi dell'estensione VM
Di seguito è riportato un esempio di voce di log per un evento di estensione 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"
}
Dettagli della voce di log
La seguente tabella descrive i parametri che puoi trovare nei log dell'estensione VM:
| Campo | Descrizione |
|---|---|
eventMessage |
Un messaggio che descrive l'evento, inclusi lo stato di applicazione e l'integrità dell'estensione. |
extensionName |
Il nome dell'estensione (ad esempio, ops-agent).
Per un elenco delle estensioni supportate e dei relativi nomi, vedi Estensioni supportate. |
extensionVersion |
La versione dell'estensione selezionata per l'installazione. Questa versione è la versione bloccata nel criterio delle estensioni o l'ultima versione se non è stata bloccata alcuna versione. |
revisionId |
Un file binario specifico di una versione dell'estensione. Ogni versione dell'estensione può avere più revisioni per supportare diversi sistemi operativi e Google sceglie automaticamente quella corretta per una VM specifica. Fornire questo ID revisione al team dell'Assistenza Google può aiutare a eseguire il debug per verificare se è stato scelto il binario corretto per la VM. |
eventType |
Il tipo di evento. Può essere uno dei seguenti valori:
|