Gerenciar políticas de alertas

Neste documento, descrevemos como editar, listar e visualizar suas políticas de alertas usando o console do Google Cloud. Também descrevemos como visualizar a representação JSON de uma política e como adicionar políticas de alertas a um painel personalizado. Quando você adiciona políticas a um painel personalizado, é possível visualizá-las no mesmo contexto que os dados de métricas.

Neste documento, não descrevemos como editar, listar e visualizar suas políticas de alertas usando a API Cloud Monitoring. Para mais informações, consulte Gerenciar políticas de alertas por API.

Antes de começar

1. Para receber as permissões necessárias para criar e modificar políticas de alertas usando o console do Google Cloud, peça ao administrador para conceder a você o papel do IAM Editor do Monitoring (roles/monitoring.editor) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

   Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

   Para mais informações sobre os papéis do Cloud Monitoring, consulte Controlar o acesso com o Identity and Access Management.

2. Verifique se você conhece os conceitos gerais das políticas de alertas. Para mais informações, consulte Visão geral de alertas.

Editar, listar ou excluir políticas de alertas

1. No console do Google Cloud, acesse a página  Alertas:

   Acessar Alertas

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

   A página Alertas exibe painéis que listam informações resumidas, incidentes e políticas de alertas.

2. Clique em Ver todas as políticas no painel Políticas.

   A página Políticas lista todas as políticas, inclui uma barra de filtro e, para cada política, opções para editar, copiar ou excluir a política:

   • Para filtrar a lista de políticas de alertas, siga um destes procedimentos:

     • Digite um nome na barra de filtro. Por exemplo, para exibir apenas políticas cujo nome contenha Example, digite Example. Uma comparação que diferencia maiúsculas de minúsculas testa se uma política está listada.
     • Clique em Políticas de filtro, selecione a propriedade de filtro e insira um valor para o filtro ou selecione um no menu.

     Quando você adiciona vários filtros, um AND lógico une os filtros.

3. Opcional: para visualizar os detalhes de uma política, clique no nome dela. Para informações sobre a página Detalhes da política, consulte Ver uma política de alertas.

4. Opcional: para editar ou copiar uma política, clique em Mais opções e selecione a opção correspondente. Editar e copiar uma política é semelhante à criação de uma política de alertas com base em métricas. No entanto, nem todos os campos podem ser modificados. Quando terminar, clique em Salvar política.

5. Opcional: para excluir uma política, clique em Mais opções e selecione Excluir. Na caixa de diálogo de confirmação, selecione Excluir.

   Se um painel tiver um gráfico com dados de uma política de alertas, ele deixará de exibir dados quando a política for excluída. Para mais informações, consulte O widget da política de alertas não exibe dados.

Ver uma política de alertas

1. No console do Google Cloud, acesse a página  Alertas:

   Acessar Alertas

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

2. Para listar todas as políticas, clique em Ver todas as políticas no painel Políticas.

3. Encontre e selecione a política que você quer visualizar.

Por exemplo, a captura de tela a seguir ilustra os detalhes da política de alertas chamada Test staging:

Como mostrado na imagem anterior, a página de detalhes fornece informações sobre a política de alertas:

• Para visualizar os incidentes criados pela política, consulte a seção Incidentes.

• Para ver os canais de notificação configurados, consulte a seção Canais de notificação.

• Para visualizar as informações adicionais que você especificou para serem incluídas com uma notificação, consulte a seção Documentação.

• Para ver os rótulos definidos pelo usuário, consulte a seção Rótulos. Para exemplos que ilustram como usar rótulos para adicionar informações aos incidentes, consulte Anotar incidentes com rótulos.

• Para editar, copiar, excluir, fazer o download da representação JSON ou mudar o estado ativado da política, use as opções na barra de ferramentas. Por exemplo, para desativar uma política de alertas ativada, clique em Ativada e selecione Desativar na caixa de diálogo de confirmação.

Observação: uma política reativada pode ser acionada imediatamente. Para mais informações, consulte Notificações de políticas de alertas desativadas para uma explicação.

Visualizar a representação JSON de uma política de alertas

Ao criar ou modificar uma política de alertas usando a API Cloud Monitoring, você fornece uma representação JSON dessa política ao método da API. Você pode criar o JSON usando a documentação da API para orientar o conteúdo. Uma alternativa é criar uma política usando o console do Google Cloud e, em seguida, fazer o download dela para o sistema local. O arquivo JSON transferido por download pode ser editado e usado como modelo para outras políticas. Para exemplos de políticas descritas pelo JSON, consulte Políticas de amostra.

Para fazer o download da representação JSON de uma política de alertas, faça o seguinte:

1. No console do Google Cloud, acesse a página  Alertas:

   Acessar Alertas

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

2. Encontre a política que você quer visualizar e clique no nome dela para abrir a página Detalhes da política.
3. Clique em JSON.

Para visualizar a representação JSON de uma política de alertas quando estiver editando, clique em  Ver código.

Adicionar política de alertas ao painel

Para visualizar as políticas de alertas no mesmo contexto que os dados de métricas, adicione essas políticas a um painel personalizado. Nesse painel, é mostrado um gráfico para cada política de alertas adicionada. Esses gráficos exibem a métrica monitorada, o limite e o número de incidentes abertos da política. Esses gráficos também contêm links que permitem visualizar ou editar a política.

É possível adicionar políticas com uma condição aos painéis personalizados. Políticas que contêm várias condições só podem ser visualizadas no contexto de alerta.

Para exibir um resumo de uma política de alertas em um painel personalizado, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Acessar Painéis

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

2. Selecione um painel ou clique em Criar painel.
3. Na barra de ferramentas, clique em  Add widget.
4. Na caixa de diálogo Adicionar widget, selecione Política de alertas.
5. Clique em Política de alertas e selecione uma. Somente políticas de alertas de condição única podem ser selecionadas no menu Política de alertas.
6. Para aplicar as alterações ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

A captura de tela a seguir ilustra um gráfico de uma política de alertas:

Neste exemplo, a política de alertas está monitorando o uso da CPU de duas máquinas virtuais diferentes. A linha tracejada mostra o limite de condição, que é definido como 50%. O ícone verde com o rótulo No incidents indica que não há incidentes abertos para a política de alertas. Se você colocar o ponteiro no ícone que mostra o número de incidentes abertos, uma caixa de diálogo será aberta direcionando para a política de alertas subjacente.

Para mais informações, consulte Exibir políticas de alertas e incidentes em um painel.