This is a translation of the original English documentation page. Help us make it better.

1 Exemples d'ús

Vista general

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

Filtrat dels registres d'esdeveniments de VMware

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.

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

Comprovant el tipus de valor recuperat

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:

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

Checking for not supported value

This example uses the Check for not supported value preprocessing step to check if the item value could not be retrieved.

When a Zabbix server/proxy poller process attempts to collect an item value, it may:

  • Return a valid result.
  • Return a result that initially seems valid but may become unsupported later (e.g., due to a value type mismatch after preprocessing).
  • Return an error of collecting the value, causing the item to become unsupported. Common causes include:
    • Unknown item key (for Zabbix agent, Simple check, or Zabbix internal items)
    • Unknown OID (SNMP agent), unknown sensor (IPMI agent), or no JMX metric (JMX agent)
    • Cannot read trap file (SNMP trap)
    • Script not found (External check)
    • No such URL (HTTP agent)
    • Login failed (SSH agent, TELNET agent)
    • Invalid formula syntax (Calculated), JavaScript syntax error (Script), or invalid SQL (Database monitor)

To detect and handle errors of collecting item values, you can use the "Check for not supported value" preprocessing step. Note that this step is always executed first and only detects errors that occur before preprocessing begins.

In the Preprocessing tab of an item, select the "Check for not supported value" preprocessing step.

Then, use the Custom on fail option to discard the value (in this case, the error), set a custom value, or return a custom error message. Please note that discarded values are not stored in the database; as a result, triggers are not evaluated and trend data is not generated.