Configurar alertas para snapshots programados

É possível criar uma métrica personalizada para gerar alertas ou fornecer informações para solucionar problemas com snapshots programados.

Por exemplo, para configurar um alerta para falhas de snapshots programados, use o seguinte procedimento:

  1. Crie uma consulta personalizada para capturar eventos de snapshots programados.
  2. Crie uma métrica com base na consulta para contar as falhas de snapshot programados.
  3. Crie uma política de alertas para enviar um alerta quando há uma falha de snapshot programado.

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ódigo ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com um destes métodos:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

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

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

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

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Papéis e permissões necessárias

Para receber as permissões necessárias e criar uma programação de snapshot, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

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 usando papéis personalizados ou outros papéis predefinidos.

Criar uma consulta personalizada

Para capturar eventos de snapshots programados, crie uma consulta personalizada no Explorador de registros.

  1. No console do Google Cloud , acesse a página Logging > Explorador de registros.

    Acessar a página Análise de registros

  2. Se o editor de consultas não estiver visível na parte de cima da página, clique no botão Mostrar consulta.

  3. Insira o texto a seguir no editor de consultas, substituindo PROJECT_ID pelo ID do projeto:

    resource.type="gce_disk"
logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event"
protoPayload.methodName="ScheduledSnapshots"
severity>"INFO"

  4. Clique em Executar consulta.

Criar uma métrica

Depois de criar a consulta personalizada, crie uma métrica que conte as falhas de snapshots programados.

  1. Na parte de cima da tabela de resultados na página do Explorer de registros, clique no menu suspenso Ações.
  2. Selecione Criar métrica.

  3. Na janela Criar métrica com base em registros, forneça os seguintes detalhes:

    • Tipo de métrica: Counter
    • Nome da métrica com base em registros: scheduled_snapshot_failure_count
    • Descrição: count of scheduled snapshot failures

    A seção Seleção de filtro é preenchida automaticamente com a consulta da etapa anterior.

  4. Em Rótulos, clique em Adicionar rótulo e digite o seguinte:

    • Nome do rótulo: status
    • Descrição: status of scheduled snapshot request
    • Tipo de rótulo: STRING
    • Nome do campo: protoPayload.response.status

  5. Clique em Concluído.

  6. Clique em Criar métrica.

Criar uma política de alertas

Depois de criar a métrica, crie uma política de alertas para enviar um alerta quando houver uma falha de snapshot programado.

  1. No Google Cloud console, acesse a página Cloud Logging > Métricas com base em registros.

    Acessar a página "Métricas com base em registros"

  2. Na seção Métricas definidas pelo usuário, encontre a nova métrica chamada scheduled_snapshot_failure_count.

  3. Clique no botão de menu Mais nesta linha e selecione Criar alerta com base na métrica.

    A página Criar política de alertas é aberta.

  4. Na guia Nova condição, configure seu indicador de alerta:

  5. Defina a Janela contínua como 5 minutes ou o intervalo de tempo que você preferir.

  6. Em Função de janela contínua, selecione Sum.

    Clique em Próxima.

  7. Na guia Configurar acionador, insira o seguinte:

    1. Tipo de condição: Threshold
    2. Acionador de alerta: Any time series violates
    3. Posição do limite: Above threshold

    4. Valor do limite: 0.

      Definir Valor limite como 0 aciona um alerta se ocorrer qualquer falha de instantâneo. É possível modificar esse valor conforme a carga de trabalho exige.

    5. Nome da condição: Snapshot failure threshold exceeded

    Clique em Próxima.

  8. Na guia Notificações e nome, defina o Nome da política de alertas. Opcionalmente, é possível adicionar critérios de notificação e documentação para essa política.

    Clique em Próxima.

  9. Revise o alerta.

  10. Clique em Criar política.

Para saber mais sobre como criar políticas de alertas, consulte Criar políticas de alertas de limite de métrica.

A seguir