Configurar notificações para métricas com base em registros

Este documento explica como configurar notificações quando uma métrica com base em registros corresponde aos critérios especificados. Estas instruções, que mostram como criar uma política de alertas e configurar canais de notificação, são para o console do Google Cloud . Também é possível criar políticas de alertas usando a API Cloud Monitoring e o comando da Google Cloud CLI gcloud alpha monitoring policies.

As políticas de alertas que monitoram métricas com base em registros não podem extrair dados de entradas de registro. Se você quiser que uma notificação extraia dados de uma entrada de registro, crie um alerta com base em registros.

Antes de começar

  1. Verifique se seu papel do Identity and Access Management inclui as permissões necessárias para criar e visualizar métricas com base em registros e criar políticas de alertas. Para mais detalhes, consulte Permissões de métricas com base em registros.

  2. Confirme se você conhece as métricas com base em registros. Para mais informações, consulte Visão geral das métricas com base em registros.

  3. Configure os canais de notificação que você quer usar para receber notificações. Para informações sobre essas etapas, consulte Criar e gerenciar canais de notificação.

Criar uma política de alertas em uma métrica de contagem

Com uma política de alertas, é possível descrever um conjunto de condições que você queira monitorar. Ao criar uma política de alertas, você também precisa especificar as condições: o que é monitorado e quando enviar notificações. As notificações incluem informações sobre o incidente e botões que permitem visualizar registros relevantes e detalhes do incidente:

Exibição do botão "Exibir registros" em uma notificação.

Para criar uma política de alertas que compare o valor de uma métrica de contador com base em registros a um limite, faça o seguinte:

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

    Acessar Métricas com base em registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

  2. Encontre a métrica que você quer monitorar, clique em Mais e selecione Criar alerta com base na métrica.

  3. Verifique se o campo Selecionar uma métrica lista um metric.type e um resource.type. Se necessário, adicione uma cláusula resource.type.

    Por exemplo, o filtro a seguir especifica uma métrica e um recurso:

    metric.type="logging.googleapis.com/byte_count"
AND resource.type="gce_instance"

  4. No menu Janela contínua, recomendamos que você selecione um valor de pelo menos 10 minutos. Em particular, esse valor precisa ser grande o suficiente para garantir que várias entradas de registro que correspondam ao seu filtro sejam contadas.

    Por exemplo, se uma métrica baseada em registros contar entradas de registro de "pulsação", que são esperadas a cada N minutos, defina o valor do menu Janela rotativa como 2N minutos ou 10 minutos, o que for maior.

  5. Clique em Próxima e selecione Limite.

  6. Insira um Valor do limite e, opcionalmente, configure os campos Gatilho do alerta e Posição do limite.

  7. Opcional: atualize a Janela de novo teste e use os campos Opções avançadas para configurar como a política de alertas lida com dados ausentes. Em geral, a configuração padrão é adequada.

  8. Clique em Próxima, em Canais de notificação e selecione os canais que você quer usar para a política de alertas.

  9. Opcional: na seção Documentação, insira as informações que você quer incluir nas notificações. Normalmente, as informações incluem instruções sobre como responder à notificação.

    Não inclua a extração de rótulos de entradas de registro na sua documentação. As políticas de alertas que monitoram uma métrica com base em registros não podem extrair dados de entradas de registro.

  10. No campo Nomear a política de alertas, digite um nome para a política.

  11. Clique em Criar política.

Solução de problemas

Se você encontrar problemas, consulte Solução de problemas de métricas com base em registros.

A seguir