Quando você usa o Gerenciador de extensões de VM para gerenciar extensões nas 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 solucionar problemas com as extensões de VM.
Antes de começar
- Leia a documentação do Gerenciador de extensões de VM.
- Leia 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 Google Cloud serviços e APIs do. Para executar
código ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no
Compute Engine com uma destas opções:
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.
gcloud
-
Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
-
- Defina uma região e uma zona padrão.
REST
Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.
Instale a Google Cloud CLI.
Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .
Conferir registros de extensão de VM
Para conferir registros de extensão de VM, use o Google Cloud console, 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 final do período (por exemplo,2024-02-01T00:00:00Z).
Consulta de exemplo:
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"Clique em Executar consulta.
gcloud
Para pesquisar registros de extensão de VM, use o logging read
comando. 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 final 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 final do período (por exemplo,2024-02-01T00:00:00Z).PROJECT_ID: o ID do Google Cloud projeto.
Entrada de registro de eventos de extensão de VM
Confira abaixo 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": "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"
}
Detalhes da entrada de registro
A tabela a seguir descreve os parâmetros que podem ser encontrados nos registros de 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 uma lista de extensões compatíveis e os respectivos nomes, 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 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. Ele pode ser um dos seguintes valores:
|