> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração de alertas

A seção **Configuração de alertas** permite consultar, gerenciar e criar alertas associados a eventos do sistema de um dispositivo. A partir desta visualização é possível habilitar ou desabilitar um alerta, e vinculá-lo a um ou vários microsserviços para sua resolução automática.

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/monitor-alertsettings1.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=bedae54b5a5c8611a8f8a5d2f74fb16a" alt="monitor-alertsettings1" width="1000" height="616" data-path="images/features/monitor-alertsettings1.png" />

## Visualização de lista

Esta visualização exibe uma listagem com os alertas registrados no dispositivo. Os campos da tabela incluem:

* **Nome.** Nome do alerta.

* **Gravidade.** Nível de impacto do alerta no sistema.

* **Categoria.** Classificação do alerta.

* **Limite.** Valor numérico que define a antiguidade em minutos na qual se buscará a existência do evento.
  O valor padrão é 720 minutos e o mínimo permitido é 60 minutos.

  Se o limite for inferior ao intervalo de 60 minutos, o alerta pode não ser ativado.

  O limite define o valor numérico da antiguidade em minutos na qual se buscará a existência do evento.

* **Unidade do limite.** Minutos.

* **Tempo autorizado (minutos).** Tempo máximo permitido a uma condição antes de ser considerada um evento anômalo.

* **Repetir a cada (minutos).** Tempo que transcorrerá antes de enviar um novo alerta se a condição for mantida.

* **Habilitado.** Indica se o alerta está habilitado ou desabilitado.

<Info>
  O FlexxAgent coleta eventos do sistema, por padrão, a cada 30 minutos. Este tempo pode ser definido na configuração do FlexxAgent tanto em nível de Grupo de relatório quanto de Produto.
</Info>

### Ações a partir da visualização de lista

A partir da visualização de lista é possível realizar as seguintes ações:

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/alert-actions.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=b1c6d31a89f7c46366101491c25e7657" alt="alert-actions" width="436" height="66" data-path="images/features/alert-actions.png" />

| Botão                      | Ação                                                                                                                            |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Novo                       | Permite criar uma nova configuração de alerta baseada em um evento do sistema.                                                  |
| Exportar                   | Baixa um arquivo Excel com os registros da tabela.                                                                              |
| Recarregar                 | Atualiza a listagem.                                                                                                            |
| Ver registros de auditoria | Permite acessar a seção **Auditoria**, para ver os registros cujos tipos de entidades correspondam a *Configuração de alertas*. |

## Criar uma configuração de alerta

O botão **Novo**, localizado na parte superior da visualização principal, permite definir um alerta baseado em eventos do sistema.

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/create-alertsetting.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=5d9be96d6c3fac67b965df72743357a6" alt="create-alertsetting" width="1000" height="453" data-path="images/features/create-alertsetting.png" />

O formulário de criação solicita os seguintes dados:

* **Nome.** Nome do alerta.

* **Descrição.** Detalhe do significado do alerta.

* **Gravidade.** Nível de impacto do alerta no sistema.

* **Categoria.** Classificação do alerta.

* **Repetir a cada (minutos).** Tempo que transcorrerá antes de enviar um novo alerta se a condição for mantida.

* **Limite.** Valor numérico que define a antiguidade em minutos na qual se buscará a existência do evento.
  O valor padrão é 720 minutos e o mínimo permitido é 60 minutos.

  Se o limite for inferior ao intervalo de 60 minutos, o alerta pode não ser ativado.

  O limite define o valor numérico da antiguidade em minutos na qual se buscará a existência do evento.

* **Unidade do limite.** Minutos.

* **Tempo autorizado (minutos).** Tempo máximo permitido a uma condição antes de ser considerada um evento anômalo.

* **Lista de destinatários de e-mail.** Endereços de e-mail (separados por vírgulas) dos usuários que receberão uma notificação de alerta.

* **Mensagem de alerta.** Notificação que os destinatários receberão quando o alerta for disparado. Por exemplo: *Foi emitido o evento 786459*.

* **ID de evento.** Identificador numérico do evento no Visualizador de eventos. Só aceita valor numérico. Será emitido um alerta quando for gerado um evento com esse ID.

* **Texto de busca.** Texto total ou fragmento literal da mensagem no Visualizador de eventos. É sempre uma cadeia de texto.

* **Origem.** Valor da coluna Origem do Visualizador de eventos. Equivale ao campo `Provider Name` do XML do evento. Por exemplo: *Microsoft Office 16 Alerts*.

* **Excluir da pontuação UX.** Permite excluir o alerta do cálculo do Workspace Reliability Index (WRI).

*

### Exemplo de texto de busca

**Mensagem de alerta configurada:**

> *A resolução do nome \_ldap.\_tcp.Tullahoma.\_sites.FlexxLab.com esgotou o tempo de espera após nenhum dos servidores DNS configurados ter respondido.*

**Textos de busca válidos:**

> * *A resolução do nome*
> * *Esgotou o tempo de espera após nenhum dos servidores DNS configurados ter respondido*
> * *Nenhum dos servidores DNS configurados ter respondido*

**Texto de busca não válido:**

> * *A resolução do nome esgotou o tempo de espera após nenhum dos servidores DNS configurados ter respondido*.

### Gravidade dos alertas

Existem três níveis:

* **Informativo.** O evento não é crítico, mas o funcionamento do sistema poderia ser otimizado.
* **Aviso.** O evento poderia comprometer o funcionamento do sistema se não for atendido.
* **Crítico.** O evento requer atenção imediata porque compromete o funcionamento do sistema.

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/alert-severity.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=0c8a523b10cc90ff5a46a4a89e53c103" alt="alert-severity" width="334" height="250" data-path="images/features/alert-severity.png" />

### Categorias de alertas

As categorias indicam o âmbito onde se origina o evento:

* Conectividade
* FlexxAgent
* Hardware
* Desempenho
* Registros de eventos
* Segurança
* Impressão
* Armazenamento

### Ativação de alertas

Os alertas configurados a partir de eventos do sistema são gerados por detecção do evento no dispositivo, não por cada ocorrência individual do evento.

Isso implica:

* Se um mesmo evento é registrado várias vezes em um dispositivo, não serão gerados múltiplos alertas.
* Será gerado um único alerta por dispositivo ao detectar a primeira ocorrência dentro do limite definido.
* O alerta permanecerá ativo enquanto continuarem sendo detectados eventos dentro do intervalo configurado.
* O alerta será desativado automaticamente quando tiver transcorrido o tempo definido no limite, contado a partir da última ocorrência registrada do evento.

<Note>
  Quando você busca detectar eventos que não têm nível *Crítico*, é necessário adicionar seu ID nos ajustes do FlexxAgent como evento adicional.
</Note>

## Visualização de detalhe

Ao selecionar um alerta da tabela principal, você acessa sua visualização de detalhe, dividida nas seguintes seções: quatro seções:

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/alert-detail1.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=166cbdd1e8bfb5cd7793713c88924f0e" alt="alert-detail1" width="999" height="316" data-path="images/features/alert-detail1.png" />

* Visão geral
* Alertas ativos
* Microsserviços
* Histórico de envios

### Visão geral

Oferece os dados principais do alerta, definidos no início deste documento.

* Nome
* Descrição
* Categoria
* Gravidade
* Limite
* Tempo autorizado (minutos)
* Repetir a cada (minutos)
* Excluir da pontuação UX

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/alertsettings-overview.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=af12701d5558968791f399ca7ee94542" alt="alertsettings-overview" width="995" height="458" data-path="images/features/alertsettings-overview.png" />

Inclui, além disso:

#### Webhooks

Exibe a listagem das integrações Webhooks associadas ao alerta.

#### Notificações

Exibe a listagem dos e-mails dos destinatários que serão informados quando o alerta for ativado.

### Alertas ativos

Lista os dispositivos onde o alerta está atualmente ativo.

* **Informação.** Descrição do alerta.
* **Data de início.** Dia e hora em que o alerta é registrado.
* **Data de notificação.** Dia e hora da notificação do alerta.
* **Elemento.** Tipo de dispositivo em que o alerta é registrado.
* **Workspace.** Nome do dispositivo em que o alerta é registrado.

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/alertsettings-activeal.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=5587593c03b38d460a45a6ad4f845f0c" alt="alertsettings-activeal" width="842" height="285" data-path="images/features/alertsettings-activeal.png" />

### Microsserviços

Permite associar o alerta a um ou vários microsserviços para resolvê-los com uma execução automática.

O botão **Vincular** abre o formulário de associação, onde se define:

* A qual microsserviço você deseja associar o alerta.
* Ordem de execução, útil quando você deseja vincular mais de um microsserviço.

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/link-ms-order1.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=ec97f2eb5bcf133e7e9949d184a41d31" alt="link-ms-order1" width="350" height="176" data-path="images/features/link-ms-order1.png" />

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/link-ms-order2.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=b3f2dd19200a9a8877cb285d189985c5" alt="link-ms-order2" width="352" height="94" data-path="images/features/link-ms-order2.png" />

### Histórico de envios

Exibe o registro de notificações enviadas:

* **Data.** Dia e hora do envio da notificação.
* **Para.** E-mail do destinatário.
* **Assunto.** Nome do alerta e do dispositivo onde foi registrado.
* **Erro.** Status do dispositivo que ativou o alerta.

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/mailing-history.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=83ab4d8a5536ab066d568f1bb7dd70ed" alt="mailing-history" width="980" height="465" data-path="images/features/mailing-history.png" />

### Ações a partir da visualização de detalhe

<img src="https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/alert-actions2.png?fit=max&auto=format&n=SlGXA3JTqSPrj5Ic&q=85&s=d47f094ef802d85f0407338a58da717f" alt="alert-actions2" width="351" height="48" data-path="images/features/alert-actions2.png" />

| Botão                      | Ação                                                                                                                                                             |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Habilitar / Desabilitar    | Modifica o status do alerta. O alerta será habilitado um minuto após clicar sobre o botão **Habilitar**. O tempo é de quatro minutos no caso de **Desabilitar**. |
| Editar                     | Abre um formulário para modificar a configuração existente.                                                                                                      |
| Excluir                    | Apaga a configuração de um alerta.                                                                                                                               |
| Ver registros de auditoria | Permite acessar a seção **Auditoria**, para ver o registro do alerta atual.                                                                                      |