As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Configurar alertas **** 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](using-grafana-v9.md). Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md). Configure os recursos e as integrações de que você precisa para criar e gerenciar os alertas. **Pré-requisitos** Antes de configurar alertas, você deve fazer o seguinte: + Configure as [fonte de dados](AMG-data-sources.md). + Certifique-se de que a fonte de dados escolhida seja compatível e suportada pelo [Grafana Alerting](v10-alerting-overview-datasources.md). **Para configurar alertas** 1. Configure as [regras de alerta](v10-alerting-configure.md). + Crie regras de alerta e regras de gravação gerenciadas pelo Grafana ou gerenciadas pela fonte de dados. 1. Configure [pontos de contato](v10-alerting-configure-contactpoints.md). + Verifique o ponto de contato padrão e atualize o contato do sistema. + Opcionalmente, adicione novos pontos de contato e integrações. 1. Configurar [políticas de notificação](v10-alerting-explore-notifications-policies-details.md) + Verifique a política de notificação padrão e atualize o sistema. + Opcionalmente, adicione outras políticas aninhadas. + Opcionalmente, adicione rótulos e matchers de rótulos para controlar o roteamento de alertas. Os tópicos a seguir fornecem mais informações sobre opções adicionais de configuração, incluindo a configuração de gerenciadores de alertas externos e o roteamento de alertas gerenciados pelo Grafana fora do Grafana. **Topics** + [ # Migrar alertas clássicos do dashboard para o Grafana Alerting ](v10-alerting-use-grafana-alerts.md) + [ # Adicionar um Alertmanager externo ](v10-alerting-setup-alertmanager.md) + [ # Provisionar recursos do Grafana Alerting ](v10-alerting-setup-provision.md) # Migrar alertas clássicos do dashboard para o Grafana Alerting Migrar 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](using-grafana-v9.md). Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md). Os espaços de trabalho que optam por não usar o Grafana Alerting usam os [Alertas clássicos do dashboard](old-alerts-overview.md). 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 painel e os alertas da Grafana, consulte. [Grafana Alerting versus alertas legados do dashboard](#v10-alerting-diff-old-new) GrafanaLabs anunciou que os alertas clássicos do painel 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. 1. No menu à esquerda, escolha **Alertas (legados)** para visualizar os alertas atuais. 1. 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 sua instância do Amazon Managed Grafana para usar alertas do Grafana usando o Console de gerenciamento da AWS, 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](AMG-configure-workspace.md). 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 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 produz estado NoData ou erro, o Grafana Alerting gerará alertas especiais que terão os seguintes rótulos: + `alertname`com 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. # Adicionar um Alertmanager externo **** 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](using-grafana-v9.md). Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md). Configure o Grafana para usar um Alertmanager externo como o único Alertmanager para receber todos os alertas. Esse Alertmanager externo pode então ser configurado e administrado no próprio Grafana. **nota** Você não pode usar o Amazon Managed Service for Prometheus como um Alertmanager externo. Depois de adicionar o alertmanager, você pode usar a interface de usuário do Grafana Alerting para gerenciar silêncios, pontos de contato e políticas de notificação. Uma opção suspensa nessas páginas permite que você alterne entre os alertmanagers. Os alertmanagers externos são configurados como fontes de dados usando a configuração do Grafana no menu de navegação principal do Grafana. Isso permite que você gerencie os pontos de contato e as políticas de notificação de alertmanagers externos no Grafana e também criptografe as credenciais de autenticação básica HTTP que antes eram visíveis ao configurar alertmanagers externos por URL. **nota** A partir do Grafana 9.2, a configuração de URL dos alertmanagers externos na guia Admin na página Alertas está obsoleta. Ela será removida em uma versão futura. **Para adicionar um Alertmanager externo** 1. No menu à esquerda, escolha **Conexões**. 1. Pesquise por `Alertmanager`. 1. Escolha o botão **Criar uma fonte de dados**. 1. Preencha os campos na página, conforme necessário. Se você estiver provisionando a fonte de dados, defina o sinalizador `handleGrafanaManagedAlerts` no campo `jsonData` como `true` para enviar alertas gerenciados pelo Grafana para esse Alertmanager. **nota** As implementações do Prometheus, Grafana Mimir e Cortex do Alertmanager são compatíveis. Para o Prometheus, os pontos de contato e as políticas de notificação são somente leitura na interface de usuário do Grafana Alerting. 1. Escolha **Salvar e testar**. # Provisionar recursos do Grafana Alerting Provisionar recursos **** 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](using-grafana-v9.md). Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md). A infraestrutura de alertas geralmente é complexa, com muitas partes do pipeline que geralmente residem em lugares diferentes. Escalar isso em várias equipes e organizações é uma tarefa especialmente desafiadora. O provisionamento do Grafana Alerting facilita esse processo, permitindo que você crie, gerencie e mantenha os dados de alerta da maneira mais adequada para a sua organização. Existem duas opções de escolha: 1. Provisione os recursos de alerta usando a API HTTP de provisionamento de alerta. **nota** Normalmente, você não pode editar regras de alerta provisionadas por API na interface de usuário do Grafana. Para ativar a edição, adicione o x-disable-provenance cabeçalho às seguintes solicitações ao criar ou editar suas regras de alerta na API: ``` POST /api/v1/provisioning/alert-rules PUT /api/v1/provisioning/alert-rules/{UID} ``` 1. Provisione os recursos de alerta usando o Terraform. **nota** Atualmente, o provisionamento do Grafana Alerting é compatível com regras de alerta, pontos de contato, tempos de desativação de áudio e modelos. Recursos de alerta provisionados usando o provisionamento de arquivos ou o Terraform só podem ser editados na fonte que os criou e não no Grafana ou em qualquer outra fonte. Por exemplo, se você provisionar os recursos de alerta usando arquivos do disco, não poderá editar os dados no Terraform ou no Grafana. **Topics** + [ # Criar e gerenciar recursos de alertas usando o Terraform ](v10-alerting-setup-provision-terraform.md) + [ # Visualizar recursos de alerta provisionados no Grafana ](v10-alerting-setup-provision-view.md) # Criar e gerenciar recursos de alertas usando o Terraform Usar o Terraform **** 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](using-grafana-v9.md). Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md). Use o provedor do Grafana do Terraform para gerenciar os recursos de alerta e provisioná-los no sistema Grafana. A compatibilidade do provedor Terraform com o Grafana Alerting facilita a criação, o gerenciamento e a manutenção de toda a pilha do Grafana Alerting como código. Para obter mais informações sobre como gerenciar os recursos de alerta usando o Terraform, consulte a documentação do [provedor do Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs) na documentação do Terraform. Conclua as tarefas a seguir para criar e gerenciar os recursos de alerta usando o Terraform. 1. Crie uma chave de API para provisionamento. 1. Configure o provedor do Terraform. 1. Defina os recursos de alerta no Terraform. 1. Execute `terraform apply` para provisionar os recursos de alerta. ## Pré-requisitos + Certifique-se de ter o [provedor grafana/grafana Terraform](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 ou superior. + Certifique-se de usar o Grafana 9.1 ou superior. Se você criou a instância do Amazon Managed Grafana com o Grafana versão 9, isso será válido. ## Criar uma chave de API para provisionamento Você pode [criar uma chave de API normal do Grafana](Using-Grafana-APIs.md) para autenticar o Terraform com o Grafana. A maioria das ferramentas existentes que usam chaves de API deve funcionar automaticamente com o novo suporte do Grafana Alerting. Para obter informações específicas sobre a criação de chaves para uso com o Terraform, consulte [Using Terraform for Amazon Managed Grafana automation](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/). **Para criar uma chave de API para provisionamento** 1. Crie uma nova conta de serviço para o pipeline de CI. 1. Atribua o perfil “Acessar as regras de alerta da API de provisionamento”. 1. Criar um token de conta de serviço. 1. Nomeie e salve o token para uso no Terraform. Como alternativa, você pode usar uma autenticação básica. Para ver todos os formatos de autenticação compatíveis, consulte [Autenticação do Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication) na documentação do Terraform. ## Configurar o provedor do Terraform O suporte ao Grafana Alerting está incluído como parte do [provedor do Grafana do Terraform](https://registry.terraform.io/providers/grafana/grafana/latest/docs). Veja a seguir um exemplo que você pode usar para configurar o provedor do Terraform. ``` terraform { required_providers { grafana = { source = "grafana/grafana" version = ">= 1.28.2" } } } provider "grafana" { url = auth = } ``` ## Provisionar pontos de contato e modelos Os pontos de contato conectam uma pilha de alertas ao mundo exterior. Eles dizem ao Grafana como se conectar aos sistemas externos e onde entregar notificações. Há mais de quinze [integrações](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional) diferentes para você escolher. Este exemplo usa um ponto de contato do Slack. **Para provisionar pontos de contato e modelos** 1. Copie esse bloco de código em um arquivo .tf na máquina local. **Substitua pelo URL do webhook do Slack (ou outros detalhes do ponto de contato). Este exemplo cria um ponto de contato que envia notificações de alerta para o Slack. ``` resource "grafana_contact_point" "my_slack_contact_point" { name = "Send to My Slack Channel" slack { url = text = <