Monitorar extensões de VM

O monitoramento da integridade e da performance das extensões de VM ajuda a gerenciar o uso de recursos e resolver problemas em toda a frota de instâncias do Compute Engine. É possível usar os painéis do Cloud Monitoring para visualizar o uso de recursos, como o consumo de CPU ou memória, e configurar políticas de alertas para receber notificações quando um evento, como uma falha de instalação, ocorrer.

Este documento descreve como monitorar as extensões de VM gerenciadas pelo Gerenciador de extensões de VM nas instâncias do Compute Engine usando o Cloud Monitoring e ajuda você a fazer o seguinte:

Antes de começar

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

    gcloud

    1. Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init

      Ao 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 desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a Google Cloud CLI.

      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 .

Antes de começar

Antes de monitorar as extensões, verifique se você concluiu o seguinte:

Papéis do IAM obrigatórios

Para receber as permissões necessárias para monitorar métricas e criar painéis, 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 e gerenciar painéis, 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 têm as permissões necessárias para monitorar métricas e gerenciar painéis. Para acessar as permissões exatas que são 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 e gerenciar painéis:

  • 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 conseguir 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ão, consulte Extensões compatíveis.

Os valores possíveis para status são os seguintes:

  • 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ão, consulte Extensões compatíveis.

Os valores possíveis para status são os seguintes:
  • 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 Tempo máximo de CPU usado pela extensão de VM 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 Uso máximo de memória da extensão de VM em bytes.

Criar painéis de monitoramento personalizados

É possível criar painéis de monitoramento 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 Google Cloud console, 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 a métrica, expanda o menu Selecionar uma métrica e faça isto:
    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 monitorar 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 monitoramento permite que você crie alertas e receba notificações quando uma métrica ultrapassa um limite especificado. Por exemplo, é possível receber uma notificação quando o status de integridade de uma extensão muda para CRASHED.

  1. No Google Cloud console, 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, defina as condições de alerta e os canais de notificação.
    1. Para selecionar a métrica, expanda o menu Selecionar uma métrica e faça isto:
      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 monitorar extensões de VM.
      4. Clique em Aplicar.
    2. Configure as condições de acionamento, como verificar se o rótulo status é 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