Monitorar extensões de VM

Neste documento, descrevemos como monitorar extensões de VM gerenciadas pelo Gerenciador de extensões de VM nas instâncias do Compute Engine usando o Cloud Monitoring. Monitorar a integridade da extensão e o consumo de recursos ajuda a acompanhar o uso de CPU e memória e detectar falhas de instalação ou de ambiente de execução na frota de VMs.

Neste documento, você vai aprender a realizar as seguintes tarefas:

• Confira as métricas disponíveis para extensões de VM.
• Criar painéis de monitoramento personalizados
• Configurar políticas de alertas

Antes de começar

• 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 do Google Cloud para acessar os serviços e as APIs do Google Cloud , não é necessário configurar a autenticação.

  gcloud

  1. Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:

     gcloud init

     Observação: se você já instalou a CLI gcloud, verifique se tem a versão mais recente executando gcloud components update.
• 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 e 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 .

Antes de começar

Antes de monitorar as extensões, conclua os seguintes pré-requisitos:

• Instale extensões de VM criando políticas de extensão.
• Revise os conceitos básicos sobre o Gerenciador de extensões de VM.
• Revise os períodos de retenção do Monitoring e os preços do Monitoring.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para monitorar métricas, criar painéis e configurar políticas de alertas, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Para receber as permissões necessárias para monitorar métricas, criar painéis e configurar políticas de alertas, peça ao administrador para conceder a você os seguintes papéis do IAM:

• Para visualizar métricas e painéis: Leitor do Monitoring (roles/monitoring.viewer) no projeto
• Para criar e gerenciar painéis e políticas de alertas: Editor do Monitoring (roles/monitoring.editor) no projeto

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para monitorar métricas, criar painéis e configurar políticas de alertas. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para monitorar métricas, criar painéis e configurar políticas de alertas:

• Para visualizar painéis: monitoring.dashboards.get no projeto
• Para criar painéis: monitoring.dashboards.create no projeto
• Para configurar alertas: monitoring.alertPolicies.create no projeto

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Métricas disponíveis para extensões de VM

As seguintes métricas estão disponíveis para monitorar as extensões de VM no Monitoring:

Nome da métrica	Tipo de métrica	Descrição
Status de aplicação da extensão de VM	compute.googleapis.com/vm_extensions/extension/enforcement_status	O status de aplicação de uma extensão de VM do Compute Engine. Os rótulos incluem extension_name e status. Para uma lista de nomes de extensões, consulte Extensões compatíveis. Os valores possíveis para status incluem: ENFORCEMENT_STATE_UNSPECIFIED INSTALLING INSTALL_FAILED INSTALLED ROLLING_BACK ROLLBACK_FAILED ROLLED_BACK INCOMPATIBLE REMOVING SERVICE_DISABLED APPLYING_CONFIG
Status de integridade da extensão de VM	compute.googleapis.com/vm_extensions/extension/health_status	O status de integridade de uma extensão de VM. Os rótulos incluem extension_name e status. Para uma lista de nomes de extensões, consulte Extensões compatíveis. Os valores possíveis para status incluem: HEALTH_STATUS_UNSPECIFIED STARTING RUNNING STOPPING STOPPED CRASHED
Uso máximo da CPU da extensão de VM	compute.googleapis.com/vm_extensions/extension/cpu/max_usage	O tempo máximo de CPU que a extensão de VM usa, expresso como uma porcentagem.
Bytes máximos usados de memória da extensão de VM	compute.googleapis.com/vm_extensions/extension/memory/used_bytes	A memória máxima que a extensão de VM usa, em bytes.

Criar painéis de monitoramento personalizados

É possível criar painéis do Monitoring com os gráficos de extensão de VM mais relevantes para seu caso de uso. Para adicionar um gráfico a um painel, siga estas etapas:

1. No console do Google Cloud , selecione Monitoring:

   Acessar Monitoring

2. No painel de navegação, selecione Painéis.
3. Clique em Criar painel.
4. Clique em Adicionar widget.
5. Na janela Adicionar widget, em Dados, selecione Métrica.
6. Para selecionar uma métrica, abra o menu Selecionar uma métrica e siga estas etapas:
   1. Em Recursos ativos, selecione Instância de VM.
   2. Em Categoria de métrica, selecione Vm_extensions.
   3. Em Métrica, selecione uma métrica, como Status de integridade da extensão de VM. Para uma lista de métricas disponíveis, consulte Métricas disponíveis para extensões de VM.
   4. Clique em Aplicar.

Adicione ao painel quantos gráficos desejar. Para mais informações, consulte Criar e gerenciar painéis personalizados.

Definir políticas de alertas

O Monitoring permite que você crie alertas e receba notificações quando uma métrica ultrapassa um limite especificado. Por exemplo, você pode receber uma notificação quando o status de integridade de uma extensão mudar para CRASHED.

Para criar uma política de alertas, siga estas etapas:

1. No console do Google Cloud , selecione Monitoring.

   Acessar Monitoring

2. No painel de navegação, selecione Alertas.
3. Clique em Criar política.
4. Na página Criar política de alertas, configure a condição de alerta concluindo as seguintes etapas:
   1. Para selecionar uma métrica, abra o menu Selecionar uma métrica e siga estas etapas:
      1. Em Recursos ativos, selecione Instância de VM.
      2. Em Categoria de métrica, selecione Vm_extensions.
      3. Em Métrica, selecione uma métrica, como Status de aplicação da extensão de VM. Para uma lista de métricas disponíveis, consulte Métricas disponíveis para extensões de VM.
      4. Clique em Aplicar.
   2. Configure as condições do gatilho, como se o rótulo status é igual a INSTALL_FAILED.
5. Siga as instruções para adicionar canais de notificação e nomear a política.
6. Clique em Criar política.

Para mais informações, consulte Criar políticas de alertas.

A seguir

• Para inspecionar o progresso do lançamento e o status de integridade da extensão, consulte Ver detalhes e status da extensão de VM.
• Para consultar eventos de aplicação históricos e auditar registros de instalação ou falha no Cloud Logging, consulte Ver registros de extensão de VM.
• Para diagnosticar lançamentos com falha, verificar processos de convidado em execução ou inspecionar registros de depuração do agente convidado, consulte Resolver problemas de extensões de VM.
• Para modificar as definições de configuração, alterar as versões fixadas ou remover os agentes implantados, consulte Gerenciar extensões de VM usando políticas de extensão.