Como gerenciar políticas de alertas

Com uma política de alertas, é possível descrever um conjunto de condições que você queira monitorar. Essas condições podem estar relacionadas ao estado de um sistema não íntegro ou ao consumo de recursos. Por exemplo, talvez você queira criar uma política para monitorar uma verificação de tempo de atividade ou para criar uma política que monitore o uso da API Cloud Monitoring. Além das condições, em uma política de alertas, é possível especificar como você quer receber notificações e qual documentação estará incluída nelas.

Esta página ilustra como usar o Monitoring no Console do Google Cloud para criar e gerenciar uma política de alertas. Você também pode usar a API Cloud Monitoring para realizar essas tarefas. Para mais informações sobre essa abordagem, consulte Como gerenciar políticas de alertas por API. Para ver as políticas representadas em JSON, consulte Políticas de amostra.

Antes de começar

Antes de criar políticas de alertas, conheça a terminologia e os conceitos gerais delas. Isso inclui entender os componentes de uma política, o conceito de um incidente e os preços e limitações. Consulte Introdução a alertas para ver mais informações.

Canais de notificação

Com os canais de notificação, você especifica como quer ser informado sobre os alertas. Quando há um tipo de canal de notificação definido, é possível selecioná-lo durante a configuração das notificações da política de alertas.

Para obter uma lista de tipos de canais de notificação e informações de configuração de canal, consulte Opções de notificação.

Políticas de alerta sobre verificações de tempo de atividade

Crie a política de alertas para uma verificação de tempo de atividade a partir da janela Verificações de tempo de atividade. Seguindo essa diretriz, a maioria dos campos na política de alertas é pré-configurada:

Como criar uma política de alertas

  1. No Console do Cloud, selecione Monitoring:

    Acesse o Monitoring

    Se você nunca usou o Monitoring, um espaço de trabalho será criado automaticamente e seu projeto será associado a ele. Caso contrário, se seu projeto não estiver associado a um espaço de trabalho, uma caixa de diálogo será exibida e será possível criar um novo espaço de trabalho ou adicionar este projeto a um espaço de trabalho existente. Depois de fazer sua seleção, clique em Adicionar. Depois que o espaço de trabalho é criado, você passa automaticamente para Alertas.

  2. Selecione Alertas.

  3. Clique em Criar política.

    A caixa de diálogo Criar uma política de alertas é exibida.

  4. Depois de concluir a especificação do nome, condições, canais de notificação e adição de documentação, clique em Salvar.

Nomenclatura

Na janela Criar nova política de alertas, insira um nome para ela. O nome da política é incluído nas notificações e é exibido na janela Políticas.

Condições

Cada condição em uma política de alerta descreve um recurso que está sendo monitorado e quando esse recurso não está atendendo uma medida de desempenho. Se uma política de alertas tiver uma condição, um incidente será criado quando a configuração for avaliada como verdadeira. Por exemplo, se a configuração for Any time series is above 10 for 5 minutes, quando essa instrução for avaliada como verdadeira, a condição será atendida e, portanto, um incidente será criado. Consulte Várias condições para informações sobre como combinar várias condições.

Para adicionar uma condição de alerta a uma política, na janela Criar nova política de alertas, clique em Adicionar condição. Para ver informações sobre como definir condições, consulte Como especificar condições.

Políticas com várias condições

Uma política de alertas pode conter até seis condições.

Se você estiver usando a API Cloud Monitoring ou se a política de alertas tiver várias condições, especifique quando as violações das condições individuais resultam na abertura de um incidente:

  • Se você estiver usando o Console do Google Cloud, use o campo Disparadores de política.
  • Se você estiver usando a API Cloud Monitoring, use o campo combiner.

Esta tabela lista as configurações no Console do Cloud, o valor equivalente na API Cloud Monitoring e uma descrição de cada configuração:

Valor de acionamento da política do Console do Google em nuvem
Valor do combinador
da API Cloud Monitoring
Significado
Qualquer condição é atendida
(valor padrão)
OR Um incidente será aberto se algum recurso violar alguma das condições.
Todas as condições são atendidas AND Um incidente será aberto se cada condição for violada por pelo menos um recurso, mesmo que um recurso diferente viole cada condição.
Todas as condições são atendidas
nos recursos correspondentes
AND_WITH_MATCHING_RESOURCE Um incidente será aberto se cada condição for violada pelo mesmo recurso. Essa configuração é a opção de combinação mais rigorosa.

Nesse contexto, o termo met significa que a configuração da condição é avaliada como true. Por exemplo, se a configuração for Any time series is above 10 for 5 minutes, quando esta instrução for avaliada como true, a condição será atendida.

Exemplo

Considere um projeto do Google Cloud que contenha duas instâncias de VM, vm1 e vm2. Além disso, suponha que você crie uma política de alertas com duas condições:

  • A condição chamada CPU usage is too high monitora o uso da CPU das instâncias. Essa condição é atendida quando a utilização da CPU de qualquer instância está acima de 100 ms/s por um minuto.
  • A condição chamada Excessive utilization monitora a utilização da CPU das instâncias. Essa condição é atendida quando a utilização da CPU de qualquer instância está acima de 60% por um minuto.

Inicialmente, suponha que ambas as condições sejam avaliadas como false.

Em seguida, suponha que o uso da CPU da vm1 exceda 100 ms/s por 1 minuto. Isso faz com que CPU usage is too high seja avaliado como true. Se as condições forem combinadas com Qualquer condição for atendida, um incidente será criado porque uma condição foi atendida. Se as condições forem combinadas com Todas as condições foram atendidas ou Todas as condições foram atendidas em recursos correspondentes, um incidente não será criado. Essas opções de combinação exigem que ambas as condições sejam avaliadas como true.

Agora, suponha que o uso da CPU da vm1 continue a ultrapassar 100 ms/s e que a utilização da CPU da vm2 exceda 60% por 1 minuto. O resultado é que ambas as condições são avaliadas como true. Veja a seguir o que ocorre com base na forma como as condições são combinadas:

  • Qualquer condição é atendida: um segundo incidente é criado porque a vm2 está fazendo com que Excessive utilization seja avaliado como true.

    Quando a configuração de uma condição é avaliada como true, a política de alertas mantém um registro do recurso monitorado e da condição. Um incidente é criado com base no pareamento do recurso e da condição. Portanto, a vm1 que faz com que CPU usage is too high seja true e a vm2 que faz com que CPU usage is too high seja true são eventos distintos. Um incidente é criado para cada evento.

  • Todas as condições são atendidas: um incidente é criado porque ambas as condições são avaliadas como true.

    Neste exemplo, a vm1 faz com que CPU usage is too high seja true, enquanto a vm2 faz com que Excessive utilization seja avaliado como true. Consequentemente, um incidente é criado.

  • Todas as condições são atendidas nos recursos correspondentes: um incidente não é criado nesse caso porque nem a vm1 nem a vm2 fizeram com que ambas as condições fossem true. Para que um incidente seja criado para essa escolha do combinador, a mesma instância de VM precisa fazer com que as duas condições sejam avaliadas como true.

Notificações

Com os canais de notificação, você especifica como quer ser informado sobre os alertas. Se você não adicionar pelo menos um canal de notificação, não será notificado quando ocorrer um incidente. É possível adicionar vários canais de notificação. Para ver detalhes sobre as opções de canais de notificação, consulte Opções de notificação.

Para adicionar um canal de notificação, faça o seguinte:

  1. Clique em Adicionar canal de notificação.
  2. Selecione o Tipo de canal de notificação.
  3. Talvez seja necessário preencher campos complementares. Por exemplo, se você selecionar E-mail, seu endereço de e-mail será solicitado.
  4. Clique em Adicionar.

Para adicionar outro canal de notificação à política, repita as etapas anteriores. A configuração de pelo menos dois tipos de canal de notificação aumenta a confiabilidade.

Documentação

A documentação está incluída nas notificações para ajudar você a gerenciar a condição de falha. Use o Markdown para formatar a documentação ou utilize texto simples.

Além do Markdown, use variáveis para extrair informações da própria política e personalizar o conteúdo da documentação. Para mais informações, consulte Uso das variáveis.

Por exemplo, a documentação pode incluir um título como Addressing High CPU Usage e detalhes que identificam o projeto:

## Addressing High CPU Usage

This note contains information about high CPU Usage.

You can include variables in the documentation. For example:

This alert originated from the project ${project}, using
the variable $${project}.

As variáveis são substituídas por seus valores somente nas notificações. O painel Visualizar Markdown e os outros locais no Console do Cloud que mostram a documentação refletem somente a formatação do Markdown:

Exemplo de gravação de uma observação de documentação usando o markdown.

Também é possível incluir tags específicas do canal para controlar as notificações. Para mais informações, consulte Como usar os controles de canal.

Como gerenciar políticas

Para listar todas as políticas de alertas, faça o seguinte:

  1. No Console do Cloud, selecione Monitoring:

    Acesse o Monitoring

  2. Selecione Alertas.

  3. Uma lista parcial de políticas é mostrada no painel Políticas. Para ver todas as políticas e ativar a filtragem, clique em Ver todas as políticas.

Para visualizar os detalhes de uma política de alertas, clique em seu nome.

Para restringir as políticas de alerta listadas, adicione filtros. Cada filtro é composto por um nome e um valor. É possível definir o valor como uma correspondência exata para um nome de política ou uma correspondência parcial. As correspondências não diferenciam maiúsculas de minúsculas. Se você tiver vários filtros, os filtros serão unidos automaticamente por um AND lógico, a menos que você insira um filtro OR. A captura de tela a seguir lista todas as políticas de alerta que identificam test ou My Uptime Check Alert Policy:

Visão geral de alertas de exemplo com filtros.

Na janela Políticas é possível editar, excluir, copiar, ativar ou desativar uma política de alertas:

  • Para editar ou copiar uma política, clique em Mais opções e selecione a opção correspondente. Editar e copiar políticas é semelhante à criação de uma política de alertas. É possível mudar e, em alguns casos, excluir os valores nos campos. Quando terminar, clique em Salvar.

  • Para excluir uma política, clique em Mais opções e selecione Excluir. Na janela de confirmação, selecione Excluir.

  • Para alterar o status ativado da política de alertas, clique no botão localizado abaixo do título Ativado.

Se você selecionar uma política de alertas, os detalhes da política serão exibidos. Por exemplo, a captura de tela a seguir ilustra os detalhes da política de alertas chamada My Uptime Check Alert Policy:

Página de detalhes da política de alertas de exemplo.

É possível editar, excluir, copiar, ativar ou desativar uma política de alertas na janela Detalhes da política. Por exemplo, para desativar uma política de alertas que está ativada, clique em Ativada e selecione Desativar. Da mesma forma, para ativar uma política que está desativada, clique em Desativada.