

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á.

# Gerenciar os alertas
<a name="v10-alerting-manage"></a>

****  
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).

Depois de configurar as regras de alerta, os pontos de contato e as políticas de notificação, você pode usar o Grafana Alerting para gerenciar os alertas na prática.

**Topics**
+ [Personalizar notificações](v10-alerting-manage-notifications.md)
+ [Gerenciar pontos de contato](v10-alerting-manage-contactpoints.md)
+ [Silenciar notificações de alerta](v10-alerting-silences.md)
+ [Visualizar e filtrar regras de alerta](v10-alerting-manage-rules-viewfilter.md)
+ [Tempos de desativação de áudio](v10-alerting-manage-muting.md)
+ [Visualize o estado e a integridade das regras de alerta](v10-alerting-manage-rulestate.md)
+ [Visualizar e filtrar por grupos de alertas](v10-alerting-manage-viewfiltergroups.md)
+ [Visualizar erros de notificação](v10-alerting-manage-viewnotificationerrors.md)

# Personalizar notificações
<a name="v10-alerting-manage-notifications"></a>

****  
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).

Personalize suas notificações com modelos de notificações.

Você pode usar modelos de notificação para alterar o título, a mensagem e o formato da mensagem em suas notificações.

Os modelos de notificação não estão vinculados a integrações específicas de pontos de contato, como o Amazon SNS ou Slack. Porém, você pode optar por criar modelos de notificação separados para diferentes integrações de pontos de contato.

Você pode usar modelos de notificação para:
+ Adicionar, remover ou reordenar informações na notificação, incluindo o resumo, a descrição, os rótulos e anotações, os valores e os links
+ Formatar texto em negrito e itálico e adicionar ou remover quebras de linha

Você não pode não usar modelos de notificação para:
+ Alterar o design das notificações em serviços de mensagens instantâneas, como o Slack e o Microsoft Teams

**Topics**
+ [Usar a linguagem de modelos do Go](v10-alerting-notifications-go-templating.md)
+ [Criar modelos de notificações](v10-alerting-create-templates.md)
+ [Usar modelos de notificações](#v10-alerting-use-notification-templates)
+ [Referência do modelo](v10-alerting-template-reference.md)

# Usar a linguagem de modelos do Go
<a name="v10-alerting-notifications-go-templating"></a>

****  
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).

Você escreve modelos de notificação na linguagem de modelos do Go, [texto/modelo](https://pkg.go.dev/text/template).

Esta seção fornece uma visão geral da linguagem de modelos e dos modelos de escrita do Go em texto/modelo.

## Ponto
<a name="v10-go-dot"></a>

 text/template Há um cursor especial chamado ponto e é escrito como`.`. Você pode pensar nesse cursor como uma variável cujo valor muda dependendo de onde ele é usado no modelo. Por exemplo, no início de um modelo de notificação, `.` refere-se ao objeto `ExtendedData`, que contém vários campos, incluindo `Alerts`, `Status`, `GroupLabels`, `CommonLabels`, `CommonAnnotations` e `ExternalURL`. No entanto, ponto pode se referir a outra coisa quando usado em um `range` em uma lista, quando usado dentro de um `with` ou ao escrever modelos de recursos para serem usados em outros modelos. Você pode ver exemplos disso em [Criar modelos de notificações](v10-alerting-create-templates.md), e todos os dados e funções na [Referência do modelo](v10-alerting-template-reference.md).

## Tags de abertura e fechamento
<a name="v10-go-openclosetags"></a>

Em texto/modelo, os modelos começam com `{{` e terminam com `}}`, independentemente de o modelo imprimir uma variável ou executar estruturas de controle, como instruções if. Isso é diferente de outras linguagens de modelos, como Jinja, em que a impressão de uma variável usa `{{` e `}}` e as estruturas de controle usam `{%` e `%}`.

## Print (Imprimir)
<a name="v10-go-print"></a>

Para imprimir o valor de algo, use `{{` e `}}`. Você pode imprimir o valor do ponto, um campo do ponto, o resultado de uma função e o valor de uma [variável](#v10-go-variables). Por exemplo, para imprimir o campo `Alerts` em que o ponto se refere a `ExtendedData`, você escreve o seguinte:

```
{{ .Alerts }}
```

## Iterar em alertas
<a name="v10-go-iterate-alerts"></a>

Para imprimir apenas os rótulos de cada alerta, em vez de todas as informações sobre o alerta, você pode usar um `range` para iterar os alertas em`ExtendedData`:

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

Dentro do intervalo, o ponto não mais se refere a `ExtendedData`, mas a um `Alert`. Você pode usar `{{ .Labels }}` para imprimir os rótulos de cada alerta. Isso funciona porque `{{ range .Alerts }}` altera o ponto para se referir ao alerta atual na lista de alertas. Quando o intervalo termina, o ponto é redefinido para o valor que tinha antes do início do intervalo, que neste exemplo é `ExtendedData`:

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## Iterar em anotações e rótulos
<a name="v10-go-iterate-labels"></a>

Vamos escrever um modelo para imprimir os rótulos de cada alerta no formato `The name of the label is $name, and the value is $value`, em que `$name` e `$value` contêm o nome e o valor de cada rótulo.

Como no exemplo anterior, use um intervalo para iterar nos alertas em `.Alerts` de forma que o ponto se refira ao alerta atual na lista de alertas e, em seguida, use um segundo intervalo nos rótulos classificados para que o ponto seja atualizado uma segunda vez para se referir ao rótulo atual. Dentro do segundo intervalo, use `.Name` e `.Value` para imprimir o nome e o valor de cada rótulo:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## As funções de índice
<a name="v10-go-index"></a>

Para imprimir uma anotação ou rótulo específico, use a função `index`.

```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```

## Instruções If
<a name="v10-go-if"></a>

Você pode usar instruções if em modelos. Por exemplo, para imprimir `There are no alerts` se não houver alertas em `.Alerts`, você escreve o seguinte:

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## With
<a name="v10-go-with"></a>

With é semelhante às instruções if, porém, diferentemente das instruções if, o `with` atualiza o ponto para se referir ao valor do with:

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## Variáveis
<a name="v10-go-variables"></a>

As variáveis em text/template devem ser criadas dentro do modelo. Por exemplo, para criar uma variável chamada `$variable` com o valor atual de ponto, você escreve o seguinte:

```
{{ $variable := . }}
```

Você pode usar `$variable` dentro de um intervalo ou `with` e vai se referir ao valor do ponto no momento em que a variável foi definida, não ao valor atual do ponto.

Por exemplo, você não pode escrever um modelo que use `{{ .Labels }}` no segundo intervalo porque aqui o ponto se refere ao rótulo atual, não ao alerta atual:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

Você pode corrigir isso definindo uma variável chamada `$alert` no primeiro intervalo e antes do segundo intervalo:

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## Intervalo com índice
<a name="v10-go-rangeindex"></a>

Você pode obter o índice de cada alerta em um intervalo definindo variáveis de índice e valor no início do intervalo:

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## Definir modelos
<a name="v10-go-define"></a>

Você pode definir modelos que podem ser usados em outros modelos, usando `define` e o nome do modelo entre aspas duplas. Você não deve definir modelos com o mesmo nome de outros modelos, incluindo modelos padrão, como `__subject`, `__text_values_list`, `__text_alert_list`, `default.title` e `default.message`. Quando um modelo foi criado com o mesmo nome de um modelo padrão, ou um modelo em outro modelo de notificação, o Grafana pode usar qualquer um dos modelos. O Grafana não impossibilita nem mostra uma mensagem de erro quando há dois ou mais modelos com o mesmo nome.

```
{{ define "print_labels" }}
{{ end }}
```

## Executar modelos
<a name="v10-go-execute"></a>

Você pode executar um modelo definido no seu modelo usando `template`, o nome do modelo entre aspas duplas e o cursor que deve ser passado para o modelo:

```
{{ template "print_labels" . }}
```

## Passar dados para modelos
<a name="v10-go-passdata"></a>

Em um modelo, o ponto refere-se ao valor que é passado para o modelo.

Por exemplo, se um modelo receber uma lista de alertas disparados, o ponto então vai se referir a essa lista de alertas disparados:

```
{{ template "print_alerts" .Alerts }}
```

Se o modelo receber os rótulos classificados para um alerta, o ponto então vai se referir à lista de rótulos classificados:

```
{{ template "print_labels" .SortedLabels }}
```

Isso é útil ao escrever modelos reutilizáveis. Por exemplo, para imprimir todos os alertas, você pode escrever o seguinte:

```
{{ template "print_alerts" .Alerts }}
```

Depois, para imprimir apenas os alertas disparados, você pode escrever o seguinte:

```
{{ template "print_alerts" .Alerts.Firing }}
```

Isso funciona porque tanto `.Alerts` como `.Alerts.Firing` são listas de alertas.

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## Comentários
<a name="v10-go-comments"></a>

Você pode adicionar comentários com `{{/*` e `*/}}`:

```
{{/* This is a comment */}}
```

Para evitar que comentários adicionem quebras de linha, use:

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## Recuo
<a name="v10-go-indentation"></a>

Você pode usar recuo, tabs e espaços e quebras de linha para tornar os modelos mais legíveis:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

No entanto, o recuo no modelo também estará presente no texto. A seguir, veremos como removê-lo.

## Remover espaços e quebras de linha
<a name="v10-go-removespace"></a>

Em text/template uso `{{-` e `-}}` para remover espaços à esquerda e à direita e quebras de linha.

Por exemplo, ao usar recuo e quebras de linha para tornar um modelo mais legível:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

O recuo e as quebras de linha também estarão presentes no texto:

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

Você pode remover o recuo e as quebras de linha do texto, alterando `}}` para `-}}` no início de cada intervalo:

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

O recuo e as quebras de linha no modelo agora estão ausentes do texto:

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# Criar modelos de notificações
<a name="v10-alerting-create-templates"></a>

****  
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).

Crie modelos de notificação reutilizáveis para enviar aos pontos de contato.

Você pode adicionar um ou mais modelos ao modelo de notificação.

O nome do modelo de notificação deve ser exclusivo. Você não pode ter dois modelos com o mesmo nome no mesmo modelo de notificação ou em modelos de notificação diferentes. Evite definir modelos com o mesmo nome dos modelos padrão, como: `__subject`, `__text_values_list`, `__text_alert_list`, `default.title` e `default.message`.

Na guia Pontos de contato, você pode ver uma lista dos modelos de notificação.

## Criar modelos de notificação
<a name="v10-alerting-creating-templates"></a>

**Para criar um modelo de notificação**

1. Escolha **Alertas**, **Pontos de contato**.

1. Escolha a guia **Modelos de notificação** e, em seguida, **\$1 Adicionar modelo de notificação**.

1. Escolha um nome para o modelo de notificação, como `email.subject`.

1. Escreva o conteúdo do modelo no campo de conteúdo.

   Por exemplo:

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

1. Salve as alterações.

   `{{ define "email.subject" }}` (em que `email.subject` é o nome do seu modelo) e `{{ end }}` é automaticamente adicionado ao início e ao final do conteúdo.

**Para criar um modelo de notificação que contenha mais de um modelo**

1. Escolha **Alertas**, **Pontos de contato**.

1. Escolha a guia **Modelos de notificação** e, em seguida, **\$1 Adicionar modelo de notificação**.

1. Insira um nome para o modelo geral de notificação. Por exemplo, .`email`

1. Escreva cada modelo no campo Conteúdo, incluindo `{{ define "name-of-template" }}` e `{{ end }}` no início e no final de cada modelo. Você pode usar nomes descritivos para cada um dos modelos no modelo de notificação, por exemplo, `email.subject` ou `email.message`. Nesse caso, não reutilize o nome do modelo de notificação inserido acima.

   As seções posteriores mostram exemplos detalhados de modelos que você pode criar.

1. Clique em Salvar.

## Pré-visualização dos modelos de notificações
<a name="v10-alerting-preview-templates"></a>

Pré-visualize seus modelos de notificação antes de usá-los nos pontos de contato, ajudando você a entender o resultado do modelo que está criando e dando a chance de corrigir quaisquer erros antes de salvá-lo.

**nota**  
As pré-visualizações de notificações estão disponíveis apenas para o Grafana Alertmanager.

**Para pré-visualizar os modelos de notificação**

1. Escolha **Alertas**, **Pontos de contato**.

1. Escolha a guia **Modelos de notificação** e, em seguida, **\$1 Adicionar modelo de notificação**, ou edite um modelo existente.

1. Adicione ou atualize o conteúdo do modelo.

   Os dados padrão são fornecidos e você pode adicionar ou editar dados de alerta a eles, bem como às instâncias de alerta. Você pode adicionar dados de alerta diretamente na própria janela de dados da carga útil ou clicar em **Selecionar instâncias de alerta** ou **Adicionar alertas personalizados**.

1. [Opcional] Para adicionar dados de alerta de instâncias de alerta existentes:

   1. Escolha **Selecionar instâncias de alerta**.

   1. Passe o mouse sobre as instâncias de alerta para ver mais informações sobre cada instância de alerta.

   1. Escolha **Confirmar** para adicionar a instância de alerta à carga útil.

1. [Opcional] Para adicionar dados de alerta usando o editor de dados de alertas, escolha **Adicionar dados personalizados**:

   1. Adicione anotações, rótulos personalizados ou defina um dashboard ou painel.

   1. Alterne entre Disparado ou Resolvido, dependendo se você deseja adicionar alertas disparados ou resolvidos à sua notificação.

   1. Escolha **Adicionar dados de alertas**.

   1. Escolha **Atualizar pré-visualização** para ver como ficará o conteúdo do seu modelo e os dados de carga útil correspondentes.

   Se houver algum erro em seu modelo, ele será exibido na pré-visualização e você poderá corrigi-lo antes de salvá-lo.

1. Salve as alterações.

## Criar um modelo para o assunto da mensagem
<a name="v10-alerting-create-template-subject"></a>

Crie um modelo para o assunto de um e-mail que contenha o número de alertas disparados e resolvidos, como neste exemplo:

```
1 firing alerts, 0 resolved alerts
```

**Para criar um modelo para o assunto de um e-mail**

1. Crie um arquivo denominado `email.subject` com o seguinte conteúdo:

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Use o modelo ao criar sua integração de ponto de contato, colocando-a no campo **Assunto** com a palavra-chave `template`.

   ```
   {{ template "email.subject" . }}
   ```

## Criar um modelo para a mensagem de um e-mail
<a name="v10-alerting-create-template-message"></a>

Crie um modelo para a mensagem de um e-mail que contenha um resumo de todos os alertas disparados e resolvidos, como neste exemplo:

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**Para criar um modelo para a mensagem de um e-mail**

1. Crie um modelo de notificação denominado `email` com dois modelos no conteúdo: `email.message_alert` e `email.message`.

   O modelo `email.message_alert` é usado para imprimir os rótulos e os valores de cada alerta disparado e resolvido, enquanto o modelo `email.message` contém a estrutura do e-mail.

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. Use o modelo ao criar a integração de ponto de contato, colocando-a no campo **Corpo do texto** com a palavra-chave `template`.

   ```
   {{ template "email.message" . }}
   ```

## Criar um modelo para o título de uma mensagem do Slack
<a name="v10-alerting-create-template-slack-title"></a>

Crie um modelo para o título de uma mensagem do Slack que contenha o número de alertas disparados e resolvidos, como no seguinte exemplo:

```
1 firing alerts, 0 resolved alerts
```

**Para criar um modelo para o título de uma mensagem do Slack**

1. Crie um arquivo denominado `slack.title` com o seguinte conteúdo:

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Execute o modelo no campo de título na integração do ponto de contato.

   ```
   {{ template "slack.title" . }}
   ```

## Criar um modelo para o conteúdo de uma mensagem do Slack
<a name="v10-alerting-create-template-slack-message"></a>

Crie um modelo para o conteúdo de uma mensagem do Slack que contenha uma descrição de todos os alertas disparados e resolvidos, incluindo seus rótulos, anotações e URL do dashboard.

**nota**  
Este modelo é apenas para alertas gerenciados pelo Grafana. Para usar o modelo para alertas gerenciados pela fonte de dados, exclua as referências a DashboardURL e SilenceURL. Para obter mais informações sobre como configurar as notificações do Prometheus, consulte a [documentação do Prometheus sobre notificações](https://prometheus.io/docs/alerting/latest/notifications/).

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Para criar um modelo para o conteúdo de uma mensagem do Slack**

1. Crie um modelo denominado `slack` com dois modelos no conteúdo: `slack.print_alert` e `slack.message`.

   O modelo `slack.print_alert` é usado para imprimir os rótulos, as anotações e o DashboardURL, enquanto o modelo `slack.message` contém a estrutura da notificação.

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. Execute o modelo no campo do corpo do texto na integração do ponto de contato:

   ```
   {{ template "slack.message" . }}
   ```

## Criar modelos para o e-mail e Slack com modelos compartilhados
<a name="v10-alerting-create-shared-templates"></a>

Em vez de criar modelos de notificação separados para cada ponto de contato, como e-mail e Slack, você pode compartilhar o mesmo modelo.

Por exemplo, se você quiser enviar um e-mail com esse assunto e uma mensagem do Slack com este título `1 firing alerts, 0 resolved alerts`, você pode criar um modelo compartilhado.

**Para criar um modelo compartilhado**

1. Crie um arquivo denominado `common.subject_title` com o seguinte conteúdo:

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Para e-mail, execute o modelo no campo de assunto na integração do ponto de contato de e-mail:

   ```
   {{ template "common.subject_title" . }}
   ```

1. Para o Slack, execute o modelo no campo de título na integração do ponto de contato do Slack:

   ```
   {{ template "common.subject_title" . }}
   ```

## Usar modelos de notificações
<a name="v10-alerting-use-notification-templates"></a>

Use modelos em pontos de contato para personalizar as notificações.

**Para usar um modelo ao criar um ponto de contato**

1. No menu **Alertas**, escolha a guia **Pontos de contato** para ver uma lista dos pontos de contato existentes.

1. Escolha **Novo**. Como alternativa, você pode editar um ponto de contato existente escolhendo o ícone de **Editar**.

1. Insira os modelos que você deseja usar em um campo, como **Mensagem** ou **Assunto**. Para inserir um modelo, use o formulário`{{ template "template_name" . }}`, *template\$1name* substituindo-o pelo nome do modelo que você deseja usar.

1. Escolha **Salvar ponto de contato**.

# Referência do modelo
<a name="v10-alerting-template-reference"></a>

****  
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).

Esta seção fornece informações de referência para criar os modelos.

**Alerta (tipo)**

O tipo de alerta contém os dados a seguir.


| Nome | Tipo | Description | Exemplo | 
| --- | --- | --- | --- | 
|  Status  |  string  |  `firing` ou `resolved`.  | \$1\$1 .Status \$1\$1 | 
|  Rótulos  |  KeyValue  |  Um conjunto de rótulos anexados ao alerta.  | \$1\$1 .Labels \$1\$1 | 
|  Anotações  |  KeyValue  |  Um conjunto de anotações anexadas ao alerta.  | \$1\$1 .Annotations \$1\$1 | 
| Valores | KeyValue | Os valores de todas as expressões, incluindo as condições clássicas | \$1\$1 .Values \$1\$1 | 
|  StartsAt  |  time.Time  |  Hora em que o alerta começou a disparar.  | \$1\$1 .StartsAt \$1\$1 | 
|  EndsAt  |  time.Time  |  Definido somente se a hora de término de um alerta for conhecida. Caso contrário, defina um período de tempo limite configurável a partir do momento em que o último alerta foi recebido.  | \$1\$1 .EndsAt \$1\$1 | 
|  GeneratorURL  |  string  |  Um link de retorno para o Grafana ou para o Alertmanager externo.  | \$1\$1 .GeneratorURL \$1\$1 | 
|  SilenceURL  |  string  |  Um link para silenciar o alerta (com rótulos para esse alerta pré-preenchidos). Somente para alertas gerenciados pelo Grafana.  | \$1\$1 .SilenceURL\$1\$1 | 
|  DashboardURL  |  string  |  Link para o dashboard do Grafana, se a regra de alerta pertencer a um. Somente para alertas gerenciados pelo Grafana.  | \$1\$1 .DashboardURL \$1\$1 | 
|  PanelURL  |  string  |  Link para o painel do dashboard do Grafana, se a regra de alerta pertencer a um. Somente para alertas gerenciados pelo Grafana.  | \$1\$1 .PanelURL \$1\$1 | 
|  Impressão digital  |  string  |  Impressão digital que pode ser usada para identificar o alerta.  | \$1\$1 .Fingerprint \$1\$1 | 
|  ValueString  |  string  |  Uma string que contém os rótulos e o valor de cada expressão reduzida no alerta.  | \$1\$1 .ValueString \$1\$1 | 

 **ExtendedData**

O ExtendedData objeto contém as seguintes propriedades.


| Nome | Tipo | Description | Exemplo | 
| --- | --- | --- | --- | 
|  Receptor  |  `string`  |  O nome do ponto de contato que envia a notificação.  |  `{{ .Receiver }}`  | 
|  Status  |  `string`  |  O status será `firing` se pelo menos um alerta estiver sendo disparado, do contrário, `resolved`.  |  `{{ .Status }}`  | 
|  Alertas  |  `[]Alert`  |  Lista de todos os alertas disparados e resolvidos nesta notificação.  |  `There are {{ len .Alerts }} alerts`  | 
|  Alertas disparados  |  `[]Alert`  |  Lista de todos os alertas disparados nesta notificação.  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  Alertas resolvidos  |  `[]Alert`  |  Lista de todos os alertas resolvidos nesta notificação.  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  Os rótulos que agrupam esses alertas nesta notificação.  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  Os rótulos comuns a todos os alertas nesta notificação.  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  As anotações comuns a todos os alertas nesta notificação.  |  `{{ .CommonAnnotations }}`  | 
|  ExternalURL  |  `string`  |  Um link para o espaço de trabalho do Grafana ou para o Alertmanager que enviou esta notificação.  |  `{{ .ExternalURL }}`  | 

**KeyValue tipo**

O `KeyValue` tipo é um conjunto de pares de key/value strings que representam rótulos e anotações.

Além do acesso direto aos dados armazenados como um `KeyValue`, também existem métodos para classificar, remover e transformar os dados.


| Nome | Argumentos | Retornos | Observações | Exemplo | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  Lista ordenada de pares de strings de chave e valor  |    | `{{ .Annotations.SortedPairs }}` | 
|  Remover  |  []string  |  KeyValue  |  Retorna uma cópia do Key/Value mapa sem as chaves fornecidas.  | `{{ .Annotations.Remove "summary" }}` | 
|  Nomes  |    |  []string  |  Lista de nomes  | `{{ .Names }}` | 
|  Valores  |    |  []string  |  Lista de valores  | `{{ .Values }}` | 

**Tempo**

A hora vem do pacote [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time) do Go. Você pode imprimir uma hora em vários formatos diferentes. Por exemplo, para imprimir a hora em que um alerta foi disparado no formato `Monday, 1st January 2022 at 10:00AM`, você escreve o seguinte modelo:

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

Você pode encontrar uma referência para o formato de hora do Go [aqui](https://pkg.go.dev/time#pkg-constants).

# Gerenciar pontos de contato
<a name="v10-alerting-manage-contactpoints"></a>

****  
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 visualização da lista **Pontos de contato** lista todos os pontos de contato e modelos de notificação existentes.

Na guia **Pontos de contato**, você pode:
+ Pesquisar nomes e tipos de pontos de contato e integrações.
+ Visualizar todos os pontos de contato e integrações existentes.
+ Visualizar para quantas políticas de notificação cada ponto de contato está sendo usado e navegar diretamente até as políticas de notificação vinculadas.
+ Visualizar o status das entregas de notificações.
+ Exportar pontos de contato individuais ou todos os pontos de contato no formato JSON, YAML ou Terraform.
+ Excluir pontos de contato que não estão sendo usados por uma política de notificação.

Na guia **Modelos de notificação**, você pode:
+ Visualizar, editar, copiar ou excluir modelos de notificações existentes.

# Silenciar notificações de alerta
<a name="v10-alerting-silences"></a>

****  
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).

Você pode suprimir as notificações de alerta com um *silêncio*. Um silêncio só impede a criação de notificações: os silêncios não impedem que as regras de alerta sejam avaliadas e não impedem que as instâncias de alerta sejam mostradas na interface do usuário. Ao silenciar um alerta, você especifica uma janela de tempo para que ele seja suprimido.

**nota**  
Para suprimir as notificações de alerta em intervalos regulares, por exemplo, durante períodos regulares de manutenção, use [Tempos de desativação de áudio](v10-alerting-manage-muting.md) em vez de silêncios.

**Para adicionar um silêncio**

1. No console do Grafana, no menu Grafana, escolha **Alertas**.

1. Escolha **Silêncios**.

1. Escolha um Alertmanager no menu suspenso **Alertmanager**.

1. Escolha **Criar silêncio**.

1. Selecione a data de início e de término em **Início e término do silêncio** para indicar quando o silêncio deve entrar em vigor e quando deve terminar.

1. Como alternativa à definição de um horário de término, em **Duração**, especifique por quanto tempo o silêncio será aplicado. Isso atualiza automaticamente a hora de término no campo **Início e término do silêncio**.

1. Nos campos **Rótulo** e **Valor**, insira um ou mais *Rótulos correspondentes*. Os matchers determinam a quais regras o silêncio se aplica. Todos os alertas correspondentes (no estado disparado) serão exibidos no campo **Instâncias de alertas afetadas**.

1. Opcionalmente, adicione um **Comentário** descrevendo o silêncio.

1. Selecione **Enviar**.

**Para editar um silêncio**

1. No console do Grafana, no menu Grafana, escolha **Alertas**.

1. Escolha **Silêncios** para ver a lista de silêncios existentes.

1. Encontre o silêncio que você deseja editar e escolha **Editar** (ícone da caneta).

1. Faça as alterações desejadas e, em seguida, escolha **Enviar** para salvar as alterações.

Você pode editar um silêncio existente escolhendo o ícone de **Editar** (caneta).

**Para criar um link de URL para um formulário de silêncio**

Ao vincular a um formulário de silêncio, forneça o comentário e os rótulos correspondentes padrão por meio dos parâmetros de consulta `matcher` e `comment`. O parâmetro `matcher` deve estar no formato `[label][operator][value]`, em que o parâmetro `operator` pode ser um dos seguintes: `=` (equals, not regex), `!=` (not equals, not regex), `=~` (equals, regex), `!~` (not equals, regex). O URL pode conter vários parâmetros de consulta com a chave `matcher`. Por exemplo, para criar um link para um formulário de silêncio com os rótulos `severity=critical` e `cluster!~europe-.*` e o comentário `Silence critical EU alerts` correspondentes, crie um URL `https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`.

Para vincular a uma nova página de silêncio de um Alertmanager externo, adicione um parâmetro de consulta `alertmanager`.

**Para remover um silêncio**

1. No console do Grafana, no menu Grafana, escolha **Alertas**.

1. Escolha **Silêncios** para ver a lista de silêncios existentes.

1. Selecione o silêncio que você deseja encerrar e escolha **Cancelar silêncio**. Isso encerra a supressão do alerta.
**nota**  
O cancelamento do silêncio encerra a supressão do alerta, como se o horário de término estivesse definido para o horário atual. Os silêncios que terminaram (automática ou manualmente) são retidos e listados por cinco dias. Você não pode remover um silêncio da lista manualmente.

# Visualizar e filtrar regras de alerta
<a name="v10-alerting-manage-rules-viewfilter"></a>

****  
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 página **Alertas** lista as regras de alerta. Por padrão, as regras são agrupadas por tipos de fontes de dados. A seção **Grafana** lista as regras gerenciadas pelo Grafana. As regras de alerta para fontes de dados Prometheus compatíveis também estão listadas aqui. Você pode visualizar as regras de alerta para fontes de dados compatíveis com o Prometheus, mas não pode editá-las.

A seção de Mimir/Cortex/Loki regras lista todas as regras para fontes de dados Mimir, Cortex ou Loki. As regras de alerta na nuvem também estão listadas nesta seção.

Ao gerenciar grandes volumes de alertas, você pode usar recursos estendidos de pesquisa de regras de alerta para filtrar pastas, grupos de avaliação e regras. Além disso, você pode filtrar as regras de alerta por suas propriedades, como rótulos, estado, tipo e integridade.

## Visualizar regras de alerta
<a name="v10-alerting-manage-rules-view"></a>

Ao usar o Grafana Alerting, você pode visualizar todos os alertas em uma página.

**Para visualizar detalhes de alertas**

1. No console do Grafana, no menu Grafana, escolha **Alertas**, **Regras de alerta**. Por padrão, a visualização de lista é exibida.

1. Em **Visualizar como**, você pode alternar entre as visualizações Agrupado, Lista e Estado ao escolher a opção de sua preferência.

1. Expanda a linha de regras para visualizar os rótulos das regras, as anotações, as fontes de dados, as consultas de regras e uma lista de instâncias de alerta resultantes da regra.

Nessa página, você também pode fazer cópias de uma regra de alerta para ajudar a reutilizar as regras existentes.

## Exportar regras de alertas
<a name="v10-alerting-manage-rules-export"></a>

Você pode exportar regras para YAML ou JSON na área de trabalho do Grafana.
+ Escolha o ícone de **Exportar grupo de regras** ao lado de cada grupo de regras de alerta para exportar para YAML, JSON ou Terraform.
+ Escolha **Exportar regras** para exportar todas as regras de alerta gerenciadas pelo Grafana para YAML, JSON ou Terraform.
+ Escolha **Mais**, **Modificar exportação** ao lado de cada regra de alerta individual em um grupo para editar as regras de alerta provisionadas e exportar uma versão modificada.

## Visualizar definições de consulta de alertas provisionados
<a name="v10-alerting-manage-rules-querydef"></a>

Visualize definições de consulta somente leitura de alertas provisionados. Verifique rapidamente se as consultas de regras de alerta estão corretas, sem precisar recorrer ao repositório “as-code” para ver as definições de regras.

**Visualização agrupada**

A visualização agrupada mostra as regras de alerta do Grafana agrupadas por pasta e as regras de alerta do Loki ou Prometheus agrupadas por `namespace` \$1 `group`. Esta é a visualização padrão da lista de regras, destinada ao gerenciamento de regras. Você pode expandir cada grupo para ver uma lista de regras dele. Expanda ainda mais uma regra para visualizar os detalhes. Você também pode expandir os botões de ação e os alertas resultantes da regra para ver os detalhes.

**Visualização Estado**

A visualização Estado mostra as regras de alerta agrupadas por estado. Use essa visualização para ter uma visão geral de quais regras estão em qual estado. Cada regra pode ser expandida para visualizar seus detalhes. Botões de ação e quaisquer alertas gerados por essa regra, e cada alerta pode ser expandido ainda mais para exibir seus detalhes.

## Filtrar regras de alerta
<a name="v10-alerting-manage-rules-filter"></a>

Você pode filtrar as regras de alerta que aparecem na página **Alertas** de diversas formas.

**Para filtrar regras de alerta**

1. Em **Selecionar fontes de dados**, selecione uma fonte de dados. Você pode ver as regras de alerta que consultam a fonte de dados selecionada.

1. Em **Pesquisar por rótulo**, insira os critérios de pesquisa usando seletores de rótulos. Por exemplo, .`environment=production;region=~US|EU,severity!=warning`

1. Em **Filtrar alertas por estado**, selecione um estado de alerta que você deseja ver. Você pode ver as regras de alerta que correspondem a esse estado. As regras que correspondem a outros estados estão ocultas.

# Tempos de desativação de áudio
<a name="v10-alerting-manage-muting"></a>

****  
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).

O tempo de desativação de áudio é um intervalo de tempo recorrente em que nenhuma nova notificação de uma política é gerada ou enviada. Use-o para evitar que os alertas sejam disparados por um período específico e recorrente, por exemplo, um período de manutenção regular.

Assim como os silêncios, os tempos de desativação de áudio não impedem que as regras de alerta sejam avaliadas nem impedem que as instâncias de alerta sejam mostradas na interface do usuário. Eles apenas impedem que as notificações sejam criadas.

Você pode configurar os tempos de desativação de áudio gerenciados do Grafana bem como os horários de desativação de áudio para uma fonte de dados externa do Alertmanager.

## Tempos de desativação de áudio versus silêncios
<a name="v10-alerting-manage-muting-compare"></a>

A tabela a seguir destaca as diferenças entre tempos de silêncio e de desativação de áudio.


| Tempo de desativação de áudio | Silêncio | 
| --- | --- | 
| Usa definições de intervalo de tempo que podem ocorrer novamente. | Tem um horário de início e término fixo. | 
| É criado e, em seguida, adicionado às políticas de notificação. | Usa rótulos para fazer correspondência com um alerta para determinar se deve ser silenciado ou não. | 

## Adicionar um tempo de desativação de áudio
<a name="v10-alerting-manage-muting-add"></a>

Você pode criar tempos de desativação de áudio no seu espaço de trabalho do Grafana.

**Para adicionar um tempo de desativação de áudio**

1. No console do Grafana, no menu Grafana, escolha **Alertas**.

1. Escolha **Políticas de notificação** e, em seguida, selecione a guia **Tempos de desativação de áudio**.

1. No menu suspenso do **Alertmanager**, selecione o Alertmanager que deseja editar.

1. Escolha o botão **\$1 Adicionar tempo de desativação de áudio**.

1. Preencha o formulário para criar um [intervalo de tempo](#v10-alerting-manage-muting-interval) para corresponder ao tempo de desativação de áudio.

1. Salve o tempo de desativação de áudio.

## Adicionar um tempo de desativação de áudio a uma política de notificação
<a name="v10-alerting-manage-muting-add-notif"></a>

Depois de definir um tempo de desativação de áudio, você o adiciona à política de notificação da qual você deseja desativar o áudio em intervalos regulares.

**Para adicionar um tempo de desativação de áudio a uma política de notificação**

1. No console do Grafana, no menu Grafana, escolha **Alertas**.

1. Escolha **Políticas de notificação** e depois selecione a guia **Políticas de notificação**.

1. Selecione a política de notificação à qual você gostaria de adicionar o tempo de desativação de áudio e escolha **...**, **Editar**.

1. No menu suspenso **Tempos de desativação de áudio**, selecione os tempos de desativação de áudio que você gostaria de adicionar à política.

1. Salve as alterações.

## Intervalos de tempo
<a name="v10-alerting-manage-muting-interval"></a>

Um intervalo de tempo é uma duração específica durante a qual os alertas são suprimidos. A duração geralmente consiste em um intervalo de tempo específico e nos dias da semana, mês ou ano. 

As opções de intervalo de tempo compatíveis são:
+ **Intervalo de tempo**: o tempo incluindo a hora de início, mas não a hora de término (em UTC, se nenhum local tiver sido selecionado, será usado o horário local).
+ **Localização**: define a localização do tempo; o intervalo de tempo é exibido na hora local do local.
+ **Dias da semana**: o dia ou o intervalo de dias da semana. Por exemplo, .`monday:thursday`
+ **Dias do mês**: as datas em um mês. Os valores de podem variar de `1` a `31`. Valores negativos especificam os dias do mês na ordem inversa, então `-1` representa o último dia do mês.
+ **Meses**: os meses do ano no formato numérico ou de nome completo do mês do calendário. Por exemplo, .`1, may:august`
+ **Anos**: o ano ou os anos do intervalo. Por exemplo, .`2023:2024`

Cada um desses elementos pode ser uma lista, e pelo menos um item no elemento deve ser satisfeito para corresponder. Os campos também são compatíveis com intervalos, usando `:`. Por exemplo, .`monday:thursday`

Se um campo for deixado em branco, qualquer instante de tempo corresponderá ao campo. Para que um instante corresponda a um intervalo de tempo completo, todos os campos devem corresponder. Um tempo de desativação de áudio pode conter vários intervalos de tempo.

Se você quiser especificar uma duração exata, especifique todas as opções necessárias para essa duração. Por exemplo, se você quiser criar um intervalo de tempo para a primeira segunda-feira do mês, para março, junho, setembro e dezembro, entre 12:00 e 24:00 UTC, a especificação de intervalo de tempo poderá ser:
+ Intervalo de tempo:
  + Horário de início: `12:00`
  + Horário de término: `24:00`
+ Dia da semana: `monday`
+ Meses: `3, 6, 9, 12`
+ Dias do mês: `1:7`

# Visualize o estado e a integridade das regras de alerta
<a name="v10-alerting-manage-rulestate"></a>

****  
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).

O estado e a integridade das regras de alerta fornecem vários indicadores-chave de status sobre os alertas.

Existem três componentes:
+ [Estado da regra de alerta](#v10-alerting-manage-rulestate-state)
+ [Estado da instância de alerta](#v10-alerting-manage-rulestate-instance)
+ [Integridade da regra de alerta](#v10-alerting-manage-rulestate-health)

Embora relacionado, cada componente transmite informações sutilmente diferentes.

**Para visualizar o estado e a integridade das regras de alerta**

1. No console do Grafana, no menu Grafana, escolha **Alertas**.

1. Escolha **Regras de alerta** para visualizar a lista de alertas existentes.

1. Escolha uma regra de alerta para visualizar seu estado e integridade.

## Estado da regra de alerta
<a name="v10-alerting-manage-rulestate-state"></a>

Uma regra de alerta pode estar em um dos seguintes estados:


| Estado | Description | 
| --- | --- | 
| Normal | Nenhuma das séries temporais retornadas pelo mecanismo de avaliação está em um estado pending ou firing. | 
| Pendente | Pelo menos uma série temporal retornada pelo mecanismo de avaliação é pending. | 
| Disparar | Pelo menos uma série temporal retornada pelo mecanismo de avaliação é firing. | 

**nota**  
Os alertas mudam primeiro para `pending` e depois para `firing`, portanto, são necessários pelo menos dois ciclos de avaliação antes que um alerta seja disparado.

## Estado da instância de alerta
<a name="v10-alerting-manage-rulestate-instance"></a>

Uma instância de alerta pode estar em um dos seguintes estados:


| Estado | Description | 
| --- | --- | 
| Normal | O estado de um alerta que não é nem pending nem firing. Tudo está funcionando conforme o esperado. | 
| Pendente | O estado de um alerta que esteve ativo por menos tempo do que a duração do limite configurado. | 
| Geração de alertas | O estado de um alerta que esteve ativo por mais tempo do que a duração do limite configurado. | 
| Nenhum dado | Nenhum dado foi recebido para a janela de tempo configurada. | 
| Geração de alertas | Ocorreu um erro ao tentar avaliar uma regra de alerta. | 

## Manter o último estado
<a name="v10-alerting-manage-rulestate-keepstate"></a>

Uma regra de alerta pode ser configurada para manter o último estado quando o estado `NoData` ou `Error` foi encontrado. Isso evitará que os alertas sejam disparados e que sejam resolvidos e disparados novamente. Assim como na avaliação normal, a regra de alerta mudará de `pending` para `firing` após o término do período de pendência.

## Integridade da regra de alerta
<a name="v10-alerting-manage-rulestate-health"></a>

Uma regra de alerta pode ter um dos status de integridade a seguir.


| Estado | Description | 
| --- | --- | 
| Ok | Nenhum erro ao avaliar a regra de alerta. | 
| Erro | Ocorreu um erro ao avaliar a regra de alerta. | 
| NoData | A ausência de dados em pelo menos uma série temporal retornada durante a avaliação de uma regra. | 
| \$1status\$1, KeepLast | A regra recebeu outro status, mas foi configurada para manter o último estado da regra de alerta. | 

## Alertas especiais para NoData erros
<a name="v10-alerting-manage-rulestate-special"></a>

Quando a avaliação de uma regra de alerta produz o estado `NoData` ou `Error`, o Grafana Alerting gera instâncias de alerta com os rótulos adicionais a seguir.


| Rótulo | Description | 
| --- | --- | 
| alertname | DatasourceNoData ou DatasourceError, dependendo do estado. | 
| datasource\$1uid | O UID da fonte de dados que causou o estado. | 

**nota**  
Você precisará definir o tratamento de erros e ausência de dados como `NoData` e `Error` na regra de alerta, conforme descrito no tópico [Configurar as regras de alertas gerenciados pelo Grafana](v10-alerting-configure-grafanamanaged.md), para gerar os rótulos adicionais.

Você pode lidar com esses alertas da mesma forma como os alertas regulares, incluindo a adição de silêncios, roteamento para um ponto de contato etc.

# Visualizar e filtrar por grupos de alertas
<a name="v10-alerting-manage-viewfiltergroups"></a>

****  
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 grupos de alertas mostram alertas agrupados de uma instância do Alertmanager. Por padrão, as regras de alerta são agrupadas pelas chaves de rótulo da política padrão nas políticas de notificação. O agrupamento de regras de alerta comuns em um único grupo de alerta evita que regras de alerta duplicadas sejam disparadas.

Você pode visualizar grupos de alertas e também filtrar as regras de alerta que correspondam a critérios específicos.

**Para visualizar grupos de alertas**

1. No console do Grafana, no menu Grafana, escolha **Alertas**.

1. Escolha **Grupos** para visualizar os grupos existentes.

1. No menu suspenso **Alertmanager**, selecione um Alertmanager externo como sua fonte de dados.

1. No menu suspenso **Personalizar agrupar por**, selecione uma combinação de rótulos para visualizar um agrupamento diferente do padrão. Isso é útil para depurar e verificar o agrupamento de políticas de notificação.

Se um alerta não contiver rótulos especificados no agrupamento da política raiz ou no agrupamento personalizado, então o alerta será adicionado a um grupo universal com o cabeçalho de `No grouping`.

Você pode filtrar alertas por rótulo ou estado dos alertas.

**Para filtrar por rótulo**
+ Em **Pesquisar**, insira um rótulo existente para visualizar os alertas que correspondam ao rótulo.

  Por exemplo, .`environment=production,region=~US|EU,severity!=warning`

**Para filtrar por estado**
+ Em **Estados**, selecione entre os estados Ativo, Suprimido ou Não processado para visualizar alertas que correspondam ao estado selecionado. Todos os outros alertas estão ocultos.

# Visualizar erros de notificação
<a name="v10-alerting-manage-viewnotificationerrors"></a>

****  
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).

Visualize os erros de notificação e saiba por que eles não foram enviados ou não foram recebidos.

**nota**  
Esse recurso é compatível apenas com o Grafana Alertmanager.

**Para visualizar os erros de notificação**

1. No menu à esquerda, escolha **Alertas** e depois **Pontos de contato**.

   Se algum ponto de contato estiver com falha, uma mensagem no canto direito do espaço de trabalho informará que há erros e a quantidade de erros.

1. Selecione um ponto de contato para visualizar os detalhes dos erros dele.

   Os detalhes do erro são exibidos se você passar o mouse sobre o ícone de erro.

   Se um ponto de contato tiver mais de uma integração, você verá todos os erros de cada uma das integrações listadas.

1. Na coluna Integridade, verifique o status da notificação.

   Pode estar OK, Nenhuma tentativa ou Erro.