Aquesta secció presenta exemples d'ús de les passes de preprocessament per dur a terme algunes tasques pràctiques.
Aquest exemple empra la passa de preprocessament Coincideix amb l'expressió regular 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 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 durant la creació de l'equip.
2. A l'equip de VMware Hypervisor, creeu un element dependent 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:
# 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+
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 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 per extreure grups coincidents i controlar la sortida. Per exemple:
# 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
Aquest exemple empra la passa de preprocessament Multiplicador personalitzat 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:
::: 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 no s'emmagatzemen a la base de dades; com a resultat, els triggers no s'avaluen i no es generen dades de tendència. :::
Aquest exemple utilitza la passa de preprocessament Comprovació de valors no compatibles 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 no s'emmagatzemen a la base de dades; per tant, els triggers no s'avaluen i no es generen dades de tendència.