Gerenciar políticas de alertas

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Este documento descreve como editar, listar e visualizar suas políticas de alertas usando o console do Google Cloud. Por exemplo, ele descreve como editar uma política para que ela seja associada a um aplicativo do App Hub. Esta página também descreve como visualizar a representação JSON de uma política e como adicionar políticas de alerta a um painel personalizado, que permite visualizar as políticas no mesmo contexto dos dados de métricas.

Este documento não descreve 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.

Esse recurso só é compatível com projetos do Google Cloud. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.

Antes de começar

Conclua as seguintes etapas no projeto do Google Cloud que armazena suas políticas de alerta:

1. Para ter 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 de 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.

   Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de 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. Familiarize-se com 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 alerta

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

   Acessar Alertas

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

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

2. Na barra de ferramentas do console do Google Cloud, selecione seu projeto. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.

3. 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, faça o seguinte:

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

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

4. Opcional: para conferir os detalhes de uma política, clique no nome dela. Para saber mais sobre a página Detalhes da política, consulte Acessar uma política de alertas.

5. Opcional: para editar ou copiar uma política, clique em more_vert Mais opções e selecione a opção correspondente. Editar e copiar uma política é semelhante a criar 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.

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

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

Conferir uma política de alertas

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

   Acessar Alertas

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

2. Na barra de ferramentas do console do Google Cloud, selecione seu projeto. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.

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

4. Encontre e selecione a política que você quer consultar.

   A página de detalhes da política de alertas é aberta. Aqui, você pode monitorar ou editar sua política e conferir dados relacionados, como incidentes e notificações. Além disso, há outras possibilidades:

   • Modifique o período dos dados mostrados no gráfico. Os gráficos têm resolução limitada e podem não mostrar todas as medições de alguns períodos.

   • Edite o alerta para adicionar rótulos definidos pelo usuário, que serão incluídos nos incidentes e nas notificações. Para mais informações, consulte Anexar rótulos a incidentes.

   • Mude o estado ativado da política. Quando uma política é desativada, você não recebe notificações.

Conferir 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 para o 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 fazer o download dela no seu sistema local. O arquivo JSON transferido por download pode ser editado e usado como modelo para outras políticas. Para conferir exemplos de políticas descritas por 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 notifications Alertas:

   Acessar Alertas

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

2. Na barra de ferramentas do console do Google Cloud, selecione seu projeto. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.
3. Encontre a política que você quer consultar e clique no nome dela para abrir a página Detalhes da política.
4. Clique em get_app JSON.

Para conferir a representação JSON de uma política de alertas durante a edição, clique em code Ver código.

Adicionar política de alertas ao painel

Para conferir as políticas de alertas no mesmo contexto dos dados de métricas, adicione essas políticas a um painel personalizado. Quando você acessa esse painel, ele mostra um gráfico para cada política de alertas adicionada. Esses gráficos mostram 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. As 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:

   Ir para Painéis

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

2. Na barra de ferramentas do console do Google Cloud, selecione seu projeto. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.
3. Selecione um painel ou clique em Criar painel.
4. Na barra de ferramentas, clique em add Adicionar widget.
5. Na caixa de diálogo Adicionar widget, selecione notifications Política de alerta.
6. Clique em arrow_drop_down Política de alerta e selecione uma política de alerta. Somente as políticas de alertas de condição única podem ser selecionadas no menu Política de alertas.
7. Para aplicar as mudanças 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 alerta e incidentes em um painel.

Associar uma política de alertas a um aplicativo do App Hub

Ao adicionar rótulos definidos pelo usuário a uma política de alerta, é possível associá-la a um serviço ou carga de trabalho que faz parte de um aplicativo do App Hub. Esses rótulos são incluídos em incidentes e notificações, e a política de alerta também é listada nos painéis de monitoramento de aplicativos. Para saber mais sobre rótulos, consulte Anexar rótulos a incidentes.

Para associar uma política de alerta a uma carga de trabalho ou serviço usando o console do Google Cloud, faça o seguinte:

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

   Acessar Alertas

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

2. Na barra de ferramentas do console do Google Cloud, selecione seu projeto. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.
3. Encontre a política de alertas, clique em more_vert Ver mais, selecione Editar e acesse a seção Notificações e nome.
4. Na seção Marcadores do aplicativo, selecione seu aplicativo e depois a carga de trabalho ou o serviço.
5. Clique em Salvar política.

Depois de concluir essas etapas, rótulos com as seguintes chaves serão anexados à sua política de alertas. Esses rótulos identificam seu aplicativo e seu serviço ou carga de trabalho:

• apphub_application_location
• apphub_application_id
• apphub_service_id ou apphub_workload_id

Também é possível adicionar rótulos de usuário a uma política de alertas usando a CLI do Google Cloud, o Terraform ou a API Cloud Monitoring. No entanto, você precisa usar as chaves de rótulo mostradas no exemplo anterior. Para ver mais informações, consulte os seguintes tópicos:

• Gerenciar políticas de alertas pela API.
• Gerencie políticas de alertas com o Terraform.