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

# Configuració d'alertes

La secció **Configuració d'alertes** permet consultar, gestionar i crear alertes associades a esdeveniments del sistema d'un dispositiu. Des d'aquesta vista pots habilitar o deshabilitar una alerta, i vincular-la a un o diversos microserveis per a la seva resolució 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" />

## Vista de llista

Aquesta vista mostra un llistat amb les alertes registrades al dispositiu. Els camps de la taula inclouen:

* **Nom.** Nom de l'alerta.

* **Gravetat.** Nivell d'impacte de l'alerta al sistema.

* **Categoria.** Classificació de l'alerta.

* **Llindar.** Valor numèric que defineix l'antiguitat en minuts en què es buscarà l'existència de l'esdeveniment.
  El valor predeterminat és 720 minuts i el mínim permès és 60 minuts.

  Si el llindar és inferior a l'interval de 60 minuts, l'alerta podria no activar-se.

  El llindar defineix el valor numèric de l'antiguitat en minuts en què es buscarà l'existència de l'esdeveniment.

* **Unitat del llindar.** Minuts.

* **Temps autoritzat (minuts).** Temps màxim permès a una condició abans de considerar-se un esdeveniment anòmal.

* **Repetir cada (minuts).** Temps que transcorrerà abans d'enviar una nova alerta si la condició es manté.

* **Habilitat.** Indica si l'alerta està habilitada o deshabilitada.

<Info>
  FlexxAgent recopila esdeveniments del sistema, per defecte, cada 30 minuts. Aquest temps es pot definir a la configuració de FlexxAgent tant a nivell de Grup d'informe com de Producte.
</Info>

### Accions des de la vista de llista

Des de la vista de llista pots realitzar les accions següents:

<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ó                        | Acció                                                                                                                                         |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Nou                         | Permet crear una nova configuració d'alerta basada en un esdeveniment del sistema.                                                            |
| Exportar                    | Descarrega un fitxer Excel amb els registres de la taula.                                                                                     |
| Recarregar                  | Actualitza el llistat.                                                                                                                        |
| Veure registres d'auditoria | Permet accedir a la secció **Auditoria**, per veure els registres els tipus d'entitats dels quals corresponguin amb *Configuració d'alertes*. |

## Crear una configuració d'alerta

El botó **Nou**, ubicat a la part superior de la vista principal, permet definir una alerta basada en esdeveniments del 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" />

El formulari de creació sol·licita les dades següents:

* **Nom.** Nom de l'alerta.

* **Descripció.** Detall del significat de l'alerta.

* **Gravetat.** Nivell d'impacte de l'alerta al sistema.

* **Categoria.** Classificació de l'alerta.

* **Repetir cada (minuts).** Temps que transcorrerà abans d'enviar una nova alerta si la condició es manté.

* **Llindar.** Valor numèric que defineix l'antiguitat en minuts en què es buscarà l'existència de l'esdeveniment.
  El valor predeterminat és 720 minuts i el mínim permès és 60 minuts.

  Si el llindar és inferior a l'interval de 60 minuts, l'alerta podria no activar-se.

  El llindar defineix el valor numèric de l'antiguitat en minuts en què es buscarà l'existència de l'esdeveniment.

* **Unitat del llindar.** Minuts.

* **Temps autoritzat (minuts).** Temps màxim permès a una condició abans de considerar-se un esdeveniment anòmal.

* **Llista de destinataris de correu.** Adreces de correu electrònic (separades per comes) dels usuaris que rebran una notificació d'alerta.

* **Missatge d'alerta.** Notificació que rebran els destinataris quan es dispari l'alerta. Per exemple: *Ha sortit l'esdeveniment 786459*.

* **ID d'esdeveniment.** Identificador numèric de l'esdeveniment al Visor d'esdeveniments. Només accepta valor numèric. S'emetrà una alerta quan es generi un esdeveniment amb aquest ID.

* **Text de cerca.** Text total o fragment literal del missatge al Visor d'esdeveniments. És sempre una cadena de text.

* **Origen.** Valor de la columna Origen del Visor d'esdeveniments. Equival al camp `Provider Name` de l'XML de l'esdeveniment. Per exemple: *Microsoft Office 16 Alerts*.

* **Excloure de la puntuació UX.** Permet excloure l'alerta del càlcul del Workspace Reliability Index (WRI).

*

### Exemple de text de cerca

**Missatge d'alerta configurat:**

> *La resolució del nom \_ldap.\_tcp.Tullahoma.\_sites.FlexxLab.com ha esgotat el temps d'espera després que cap dels servidors DNS configurats respongués.*

**Textos de cerca vàlids:**

> * *La resolució del nom*
> * *Ha esgotat el temps d'espera després que cap dels servidors DNS configurats respongués*
> * *Cap dels servidors DNS configurats respongués*

**Text de cerca no vàlid:**

> * *La resolució del nom va esgotar el temps d'espera després que cap dels servidors DNS configurats respongués*.

### Gravetat de les alertes

Existeixen tres nivells:

* **Informatiu.** L'esdeveniment no és crític, però el funcionament del sistema podria optimitzar-se.
* **Advertència.** L'esdeveniment podria comprometre el funcionament del sistema si no s'atén.
* **Crític.** L'esdeveniment requereix atenció immediata perquè compromet el funcionament del 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" />

### Categories d'alertes

Les categories indiquen l'àmbit on s'origina l'esdeveniment:

* Connectivitat
* FlexxAgent
* Maquinari
* Rendiment
* Registres d'esdeveniments
* Seguretat
* Impressió
* Emmagatzematge

### Activació d'alertes

Les alertes configurades a partir d'esdeveniments del sistema es generen per detecció de l'esdeveniment al dispositiu, no per cada ocurrència individual de l'esdeveniment.

Això implica:

* Si un mateix esdeveniment es registra diverses vegades en un dispositiu, no es generaran múltiples alertes.
* Es generarà una única alerta per dispositiu en detectar la primera ocurrència dins del llindar definit.
* L'alerta romandrà activa mentre se segueixin detectant esdeveniments dins de l'interval configurat.
* L'alerta es desactivarà automàticament quan hagi transcorregut el temps definit al llindar, comptat des de l'última ocurrència registrada de l'esdeveniment.

<Note>
  Quan es busca detectar esdeveniments que no tenen nivell *Crític*, cal afegir el seu ID als ajustos de FlexxAgent com a esdeveniment addicional.
</Note>

## Vista de detall

En seleccionar una alerta de la taula principal s'accedeix a la seva vista de detall, dividida en les seccions següents: quatre seccions:

<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" />

* Visió general
* Alertes actives
* Microserveis
* Historial d'enviaments

### Visió general

Ofereix les dades principals de l'alerta, definides a l'inici d'aquest document.

* Nom
* Descripció
* Categoria
* Gravetat
* Llindar
* Temps autoritzat (minuts)
* Repetir cada (minuts)
* Excloure de la puntuació 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" />

Inclou, a més:

#### Webhooks

Mostra el llistat de les integracions Webhooks associades a l'alerta.

#### Notificacions

Mostra el llistat dels correus electrònics dels destinataris a qui s'informarà quan s'activi l'alerta.

### Alertes actives

Llista els dispositius on l'alerta està actualment activa.

* **Informació.** Descripció de l'alerta.
* **Data d'inici.** Dia i hora en què es registra l'alerta.
* **Data de notificació.** Dia i hora de la notificació d'alerta.
* **Element.** Tipus de dispositiu on es registra l'alerta.
* **Workspace.** Nom del dispositiu on es registra l'alerta.

<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" />

### Microserveis

Permet associar l'alerta a un o diversos microserveis per resoldre-les amb una execució automàtica.

El botó **Vincular** obre el formulari d'associació, on es defineix:

* A quin microservei es vol associar l'alerta.
* Ordre d'execució, útil quan es vol vincular més d'un microservei.

<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" />

### Historial d'enviaments

Mostra el registre de notificacions enviades:

* **Data.** Dia i hora de l'enviament de la notificació.
* **Fins a.** Correu electrònic del destinatari.
* **Assumpte.** Nom de l'alerta i del dispositiu on s'ha registrat.
* **Error.** Estat del dispositiu que va activar l'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" />

### Accions des de la vista de detall

<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ó                        | Acció                                                                                                                                                                     |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Habilitar / Deshabilitar    | Modifica l'estat de l'alerta. L'alerta s'habilitarà un minut després de fer clic sobre el botó **Habilitar**. El temps és de quatre minuts en el cas de **Deshabilitar**. |
| Editar                      | Obre un formulari per modificar la configuració existent.                                                                                                                 |
| Eliminar                    | Esborra la configuració d'una alerta.                                                                                                                                     |
| Veure registres d'auditoria | Permet accedir a la secció **Auditoria**, per veure el registre de l'alerta actual.                                                                                       |
