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 9.x.

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

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 o alerta clássico do dashboard. Para mudar para o novo Grafana Alerting, primeiro é necessário escolher o recurso.

Você pode configurar sua instância do Amazon Managed Grafana para usar alertas do Grafana usando o AWS Management Console, o AWS CLI ou a API 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.

nota

Ao usar o Grafana Alerting, as regras de alerta definidas no Grafana, em vez de no Prometheus, enviam várias notificações para o seu ponto de contato. Se você estiver usando alertas nativos do Grafana, recomendamos que continue usando os alertas clássicos do dashboard e não habilite o novo recurso de alerta do Grafana. Se você quiser visualizar os alertas definidos na fonte de dados Prometheus, recomendamos que você habilite o Grafana Alerting, que envia somente uma única notificação para alertas criados no Alertmanager do Prometheus.

Essa limitação foi removida nos espaços de trabalho do Amazon Managed Grafana que são compatíveis com o Grafana v10.4 e versões posteriores.

Migrar para o sistema do Grafana Alerting

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.