Monitorar extensões de VM

Monitorar a integridade e a 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. Use os painéis do Cloud Monitoring para visualizar o uso de recursos, como consumo de CPU ou memória, e configure políticas de alertas para receber notificações quando ocorrer um evento, como uma falha de instalação.

Neste documento, descrevemos como monitorar extensões de VM gerenciadas pelo Gerenciador de extensões de VM nas suas instâncias do Compute Engine usando o Cloud Monitoring e ajudamos 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 serviços e APIs do Cloud de Confiance by S3NS . 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 Cloud de Confiance para acessar os serviços e as APIs do Cloud de Confiance by S3NS , 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
  • 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 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 Cloud de Confiance .

Antes de começar

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

Papéis necessários do IAM

Para ter 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 ter 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 conferir 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 e gerenciar painéis. 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 e gerenciar painéis:

  • Para ver 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 métricas a seguir estão disponíveis para monitorar as extensões de VM no Monitoring:

Nome da métrica Tipo de métrica Descrição
Status da restrição de 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 conferir uma lista de nomes de extensões, consulte extensões compatíveis.

Os valores possíveis para status são:

  • 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 conferir uma lista de nomes de extensões, consulte extensões compatíveis.

Os valores possíveis para status são:
  • 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 da VM expresso como uma porcentagem.
Bytes máximos de memória usados 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 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 Cloud de Confiance , 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 o seguinte:
    1. Em Recursos ativos, selecione Instância de VM.
    2. Em Categoria da 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

Com o Monitoring, é possível criar alertas e receber notificações quando uma métrica ultrapassar um limite especificado. Por exemplo, você pode receber uma notificação quando o status de integridade de uma extensão mudar para CRASHED.

  1. No console do Cloud de Confiance , 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 o seguinte:
      1. Em Recursos ativos, selecione Instância de VM.
      2. Em Categoria da métrica, selecione Vm_extensions.
      3. Em Métrica, selecione uma opção, 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 disparo, 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