Migrar alertas clássicos do dashboard para o Grafana Alerting - Amazon Managed Grafana
Pré-visualizar os alertas do GrafanaMigrar para o sistema do Grafana AlertingGrafana Alerting versus alertas legados do dashboard

Migrar alertas clássicos do dashboard para o Grafana Alerting

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x.

Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte Trabalhar no Grafana versão 9.

Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.

Os espaços de trabalho que optam por não usar o Grafana Alerting usam os Alertas clássicos do dashboard. Para mudar para o novo Grafana Alerting, primeiro é necessário escolher o recurso. Para ver detalhes sobre as diferenças entre os alertas clássicos do dashboard e o Grafana Alerting, consulte Grafana Alerting versus alertas legados do dashboard. A Grafana Labs anunciou que os alertas clássicos do dashboard serão removidos na versão 11.

Quando você usa alertas de dashboard clássicos, o Amazon Managed Grafana mostra uma pré-visualização dos alertas do Grafana, na qual você pode revisar e modificar os alertas atualizados antes de finalizar o upgrade.

Pré-visualizar os alertas do Grafana

Você pode pré-visualizar seus alertas nos alertas do Grafana antes de migrar. Na pré-visualização, você pode fazer alterações nos alertas que mudarão a migração.

Para pré-visualizar sua migração de alertas do Grafana

  1. Faça login no espaço de trabalho do Grafana.

  2. No menu à esquerda, escolha Alertas (legados) para visualizar os alertas atuais.

  3. No menu à esquerda, escolha Atualização de alertas para visualizar os alertas no Grafana Alerting.

    Nessa visualização, você pode ver como ficarão os alertas após a migração.

nota

Nessa visualização, você também pode fazer alterações que afetarão a migração. Para desfazer as alterações feitas, escolha Redefinir atualização no canto superior direito da página de atualização.

Quando estiver pronto para atualizar os alertas, consulte a próxima seção.

Migrar para o sistema do Grafana Alerting

Você pode configurar a instância do Amazon Managed Grafana para usar o Grafana Alerting usando o AWS Management Console, a AWS CLI ou a API do Amazon Managed Grafana. Para obter detalhes sobre como configurar o Amazon Managed Grafana, incluindo ativar ou desativar o Grafana Alerting, consulte Configurar um espaço de trabalho do Amazon Managed Grafana.

Quando o Grafana Alerting está ativado, os alertas clássicos existentes do dashboard migram em um formato compatível com o Grafana Alerting. Na página de alertas da instância do Grafana, você pode visualizar os alertas migrados junto com os novos alertas. Com o Grafana Alerting, as regras de alerta gerenciadas pelo Grafana enviam várias notificações em vez de um único alerta quando são correspondidas.

O acesso de leitura e gravação aos alertas clássicos do dashboard e aos alertas do Grafana é regido pelas permissões das pastas que os armazenam. Durante a migração, as permissões clássicas de alerta do dashboard são correspondidas com as novas permissões de regras da seguinte forma:

  • Se o dashboard do alerta original tiver permissões, a migração criará uma pasta nomeada com este formato Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1} para corresponder às permissões do dashboard original (incluindo as permissões herdadas da pasta).

  • Se não houver permissões no dashboard e ele estiver em uma pasta, a regra será vinculada a essa pasta e herdará suas permissões.

  • Se não houver permissões no dashboard e ele estiver na pasta Geral, a regra será vinculada à pasta Alertas gerais e ela herdará as permissões padrão.

nota

Como não há a opção de Keep Last State para alertas NoData no Grafana, essa opção passa a ser NoData durante a migração das regras clássicas. A opção Keep Last State de tratamento de Error é migrada para uma nova opção Error. Para corresponder ao comportamento do Keep Last State, em ambos os casos, durante a migração, o Amazon Managed Grafana cria automaticamente um silêncio para cada regra de alerta com duração de um ano.

Os canais de notificação são migrados para uma configuração do Alertmanager com as rotas e os receptores apropriados. Os canais de notificação padrão são adicionados como pontos de contato à rota padrão. Canais de notificação não associados a nenhum alerta do dashboard seguem a rota autogen-unlinked-channel-recv.

Limitações

  • O sistema do Grafana Alerting pode recuperar regras de todas as fontes de dados disponíveis do Prometheus, Loki e Alertmanager. Talvez não seja possível obter regras de alerta de outras fontes de dados compatíveis.

  • A migração de ida e volta entre os alertas do Grafana e o alerta clássico do dashboard pode resultar na perda de dados dos recursos compatíveis em um sistema, mas não no outro.

    nota

    Caso migre de volta para o alerta clássico do dashboard, você perderá todas as alterações realizadas na configuração de alertas definida enquanto o Grafana Alerting estava ativado, incluindo todas as novas regras de alerta criadas.

Grafana Alerting versus alertas legados do dashboard

Introduzido no Grafana 8, o Grafana Alerting tem vários aprimoramentos em relação aos alertas legados do dashboard.

Alertas multidimensionais

Agora você pode criar alertas que oferecem visibilidade de todo o sistema com uma única regra de alerta. Gere várias instâncias de alerta de uma única regra de alerta. Por exemplo, você pode criar uma regra para monitorar o uso do disco de vários pontos de montagem em um único host. O mecanismo de avaliação retorna várias séries temporais de uma única consulta, com cada série temporal identificada pelo seu conjunto de rótulos.

Criar alertas fora dos dashboards

Ao contrário dos alertas legados do dashboard, os alertas do Grafana permitem que você crie consultas e expressões que combinam dados de várias fontes de maneiras exclusivas. Você ainda pode vincular dashboards e painéis às regras de alerta usando seu ID e pode solucionar rapidamente os problemas do sistema sob observação.

Como os alertas unificados não estão mais diretamente vinculados às consultas do painel, eles não incluem imagens ou valores de consulta no e-mail de notificação. Você pode usar modelos de notificação personalizados para visualizar os valores da consulta.

Criar regras de alertas para o Grafana Mimir e Loki

No Grafana Alerting, você pode gerenciar as regras de alertas do Loki e do Grafana Mimir usando a mesma interface e API dos alertas gerenciados pelo Grafana.

Visualize e pesquise alertas de fontes de dados compatíveis com o Prometheus

Os alertas para fontes de dados compatíveis com o Prometheus agora estão listados na seção de alertas do Grafana. Você pode pesquisar rótulos em várias fontes de dados para encontrar rapidamente alertas relevantes.

Alertas especiais para o estado de alerta NoData e Erro

O Grafana Alerting introduziu um novo conceito dos estados de alerta. Quando a avaliação de uma regra de alerta produzir o estado NoData ou Erro, o Grafana Alerting vai gerar alertas especiais que terão os seguintes rótulos:

  • alertname com o valor DataSourceNoData ou DataSourceError, dependendo do estado.

  • rulename nome da regra de alerta à qual o alerta especial pertence.

  • datasource_uid terá o UID da fonte de dados que causou o estado.

  • Todos os rótulos e anotações da regra de alerta original.

Você pode lidar com esses alertas da mesma forma que os alertas regulares, adicionando um silêncio, uma rota para um ponto de contato etc.

nota

Se a regra usar várias fontes de dados e uma ou várias não retornarem dados, o alerta especial será criado para cada fonte de dados que causou o estado de alerta.