Quando você usa o VM Extension Manager para gerenciar extensões nas suas instâncias do Compute Engine (VMs), o agente convidado em cada VM registra eventos sobre a aplicação da extensão. Use o Cloud Logging para conferir esses registros na Análise de registros e monitorar e resolver problemas com as extensões de VM.
Antes de começar
- Leia a documentação do gerenciador de extensões de VM.
- Saiba como usar a Análise de registros.
-
Configure a autenticação, caso ainda não tenha feito isso.
Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar
códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no
Compute Engine selecionando uma das seguintes opções:
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o console Google Cloud para acessar os serviços e as APIs Google Cloud , não é necessário configurar a autenticação.
gcloud
-
Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud initAo usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.
-
- Defina uma região e uma zona padrão.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.
Instale a CLI do Google Cloud.
Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.
Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .
Ver registros de extensão de VM
Para conferir os registros de extensão de VM, use o console Google Cloud , a Google Cloud CLI ou REST.
Console
- No console do Google Cloud , acesse a página Análise de registros.
No campo Consulta, digite a seguinte 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_TIMESubstitua:
INSTANCE_ID: o ID da instância de VM.EXTENSION_NAME: o nome da extensão (por exemplo,ops-agent).START_TIME: o início do período (por exemplo,2024-01-01T00:00:00Z).END_TIME: o fim do período (por exemplo,2024-02-01T00:00:00Z).
Exemplo de consulta:
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"Clique em Executar consulta.
gcloud
Para procurar registros de extensão de VM, use o comando
logging read. Exemplo:
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"'
Substitua:
INSTANCE_ID: o ID da instância de VM.YOUR_EXTENSION_NAME: o nome da extensão (por exemplo,ops-agent).START_TIME: o início do período (por exemplo,2024-01-01T00:00:00Z).END_TIME: o fim do período (por exemplo,2024-02-01T00:00:00Z).
REST
Faça uma solicitação para a API Logging V2. O corpo da solicitação precisa
conter o parâmetro filter. Exemplo:
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"
]
}
Substitua:
INSTANCE_ID: o ID da instância de VM.EXTENSION_NAME: o nome da extensão (por exemplo,ops-agent).START_TIME: o início do período (por exemplo,2024-01-01T00:00:00Z).END_TIME: o fim do período (por exemplo,2024-02-01T00:00:00Z).PROJECT_ID: o ID do projeto Google Cloud .
Entrada de registro de eventos de extensão de VM
Confira a seguir um exemplo de entrada de registro para um evento de extensão 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"
}
Detalhes da entrada de registro
A tabela a seguir descreve os parâmetros que podem ser encontrados nos registros da extensão de VM:
| Campo | Descrição |
|---|---|
eventMessage |
Uma mensagem que descreve o evento, incluindo o estado de aplicação e a integridade da extensão. |
extensionName |
O nome da extensão (por exemplo, ops-agent).
Para conferir uma lista das extensões compatíveis e os nomes delas, consulte extensões compatíveis. |
extensionVersion |
A versão da extensão selecionada para instalação. Essa versão é a fixada na política de extensão ou a versão mais recente, se nenhuma versão foi fixada. |
revisionId |
Um binário específico de uma versão de extensão. Cada versão de extensão pode ter várias revisões para oferecer suporte a diferentes sistemas operacionais, e o Google escolhe automaticamente a correta para uma VM específica. Fornecer esse ID de revisão à equipe de suporte do Google pode ajudar a depurar se o binário correto foi escolhido para a VM. |
eventType |
O tipo de evento. Pode ser um dos seguintes valores:
|