[comment]: # ({1a3ec895-1a3ec895})
# 1 Exemples d'ús

[comment]: # ({/1a3ec895-1a3ec895})

[comment]: # ({c85251c8-f4923ce3})
#### Vista general

Aquesta secció presenta exemples d'ús de les passes de preprocessament per dur a terme algunes tasques pràctiques.

[comment]: # ({/c85251c8-f4923ce3})

[comment]: # ({44d7e637-6c9dfb09})
#### Filtrat dels registres d'esdeveniments de VMware

Aquest exemple empra la passa de preprocessament [Coincideix amb l'expressió regular](/manual/config/items/preprocessing#configuration) per filtrar els esdeveniments innecessaris del registre d'esdeveniments de VMware.

1\. En un equip de VMware Hypervisor que funcioni, comproveu que l'element del registre d'esdeveniments [vmware.eventlog](/manual/config/items/itemtypes/simple_checks/vmware_keys) estigui present i funcioni correctament.
Tingueu en compte que l'element del registre d'esdeveniments ja podria estar present a l'hipervisor si s'ha enllaçat una plantilla [VMware](/manual/vm_monitoring#ready-to-use-templates) durant la creació de l'equip.

2\. A l'equip de VMware Hypervisor, creeu un [element dependent](/manual/config/items/itemtypes/dependent_items) del tipus "Registre" i configureu l'element del registre d'esdeveniments com a mestre.

3\. A la pestanya *Preprocessament* de l'element dependent, seleccioneu la passa de preprocessament "Coincideix amb l'expressió regular" i especifiqueu, per exemple, un dels paràmetres següents:

```bash
# Filtra tots els esdeveniments de registre:
patró: .* iniciat sessió .*

# Filtra les línies que contenen noms d'usuari després de "Usuari":
patró: \bUsuari\s+\K\S+
```

::: noteimportant
Si l'expressió regular no coincideix, l'element dependent no s'admet amb un missatge d'error corresponent.
Per evitar-ho, marqueu la casella de selecció "Personalitzat en cas d'error" i seleccioneu una opció, com ara descartar el valor o establir-ne un de personalitzat.
Tingueu en compte que els valors [descartats](/manual/config/items/preprocessing#configuration) no s'emmagatzemen a la base de dades; com a resultat, els triggers no s'avaluen i no es generen dades de tendència.
:::

Alternativament, podeu emprar la passa de preprocessament [Expressió regular](/manual/config/items/preprocessing#configuration) per extreure grups coincidents i controlar la sortida. Per exemple:

```bash
# Extreu i genera tot l'esdeveniment de registre que conté "iniciat sessió":
patró: .*ha iniciat sessió.*
sortida: \0

# Extreu i emet noms d'usuari després d'"Usuari":
patró: Usuari (.*?)(?=\ )
sortida: \1
```

[comment]: # ({/44d7e637-6c9dfb09})

[comment]: # ({11aeda61-561b422b})
#### Comprovant el tipus de valor recuperat

Aquest exemple empra la passa de preprocessament [Multiplicador personalitzat](/manual/config/items/preprocessing#configuration) per comprovar si el tipus de valor de l'element recuperat és numèric.

A la pestanya *Preprocessament* d'un element, seleccioneu la passa de preprocessament "Multiplicador personalitzat" i configureu el paràmetre següent:

```bash
# Multiplica el valor recuperat per 1:
number: 1
```

::: nota important
Si el preprocessament falla (p. ex., l'entrada no és numèrica), l'element no s'admet amb un missatge d'error corresponent.
Per evitar-ho, marqueu la casella de selecció "Personalitzat en cas d'error" i seleccioneu una opció, com ara descartar el valor o establir-ne un de personalitzat.
Tingueu en compte que els valors [descartats](/manual/config/items/preprocessing#configuration) no s'emmagatzemen a la base de dades; com a resultat, els triggers no s'avaluen i no es generen dades de tendència.
:::

[comment]: # ({/11aeda61-561b422b})

[comment]: # ({6c4d73ae-b8a4a171})
#### Comprovació de valors no compatibles

Aquest exemple utilitza la passa de preprocessament [Comprovació de valors no compatibles](/manual/config/items/preprocessing#configuration) per comprovar si no s'ha pogut recuperar el valor de l'element.

Quan un procés de sondeig de servidor/proxy Zabbix intenta recopilar un valor d'element, pot:

- Retornar un resultat vàlid.

- Retornar un resultat que inicialment sembla vàlid però que pot deixar de ser compatible més endavant (per exemple, a causa d'una discrepància del tipus de valor després del preprocessament).

- Retornar un error de recopilació del valor, cosa que fa que l'element deixi de ser compatible. Les causes comunes inclouen:

- Clau d'element desconeguda (per a l'agent Zabbix, la comprovació simple o els elements interns de Zabbix)

- OID desconegut (agent SNMP), sensor desconegut (agent IPMI) o cap mètrica JMX (agent JMX)

- No es pot llegir el fitxer de trap (trap SNMP)

- No s'ha trobat l'script (comprovació externa)

- No hi ha aquesta URL (agent HTTP)

- Error d'inici de sessió (agent SSH, agent TELNET)

- Sintaxi de fórmula no vàlida (calculada), error de sintaxi de JavaScript (script) o SQL no vàlid (monitor de base de dades)

Per detectar i gestionar errors de recopilació de valors d'elements, podeu utilitzar la passa de preprocessament "Comprova si hi ha valors no compatibles".

Tingueu en compte que aquesta passa sempre s'executa primer i només detecta errors que es produeixen abans que comenci el preprocessament.

A la pestanya *Preprocessament* d'un element, trieu la passa de preprocessament "Comprovar si hi ha valors no compatibles".

A continuació, utilitzeu l'opció *Personalitzat en cas d'error* per descartar el valor (en aquest cas, l'error), definir un valor personalitzat o retornar un missatge d'error personalitzat.
Tingueu en compte que els valors [descartats](/manual/config/items/preprocessing#discardunchanged) no s'emmagatzemen a la base de dades; per tant, els triggers no s'avaluen i no es generen dades de tendència.

[comment]: # ({/6c4d73ae-b8a4a171})