12. Expressions regulars

Vista general

Les Expressions regulars compatibles amb Perl (PCRE, PCRE2) són compatibles amb Zabbix.

Hi ha dues maneres d'emprar expressions regulars a Zabbix:

• Introduïnt manualment d'una expressió regular
• emprant una expressió regular global creada a Zabbix

Expressions regulars

Podeu introduir manualment una expressió regular a les ubicacions admeses. Tingueu en compte que l'expressió no pot començar amb @ perquè aquest símbol s'empra a Zabbix per fer referència a expressions regulars globals.

Tingueu en compte que a la concordança multilínia, les àncores ^ i $ coincideixen amb l'inici/final de cada línia, respectivament, en lloc de l'inici/final de tota la cadena.

Veieu exemples d'escapada correcta a diferents contexts.

Expressions regulars globals

Hi ha un editor avançat per crear i provar expressions regulars complexes a la interfície Zabbix.

Un cop s'ha creat una expressió regular d'aquesta manera, es pot emprar a diversos llocs de la interfície fent referència al seu nom amb el prefix @, per exemple, @mycustomregexp.

Per crear una expressió regular global:

• Aneu a: Administració → General
• Seleccioneu Expressions regulars al menú desplegable
• Feu clic a Nova expressió regular

La pestanya Expressions us permet definir el nom de l'expressió regular i afegir subexpressions.

Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.

|Paràmetre|<|Descripció| |-|-----------|-------------------------------------- ----| |Nom|<|Definiu el nom de l'expressió regular. Es permeten tots els caràcters Unicode.| |Expressions|<|Feu clic a Afegir al bloc Expressions per afegir una subexpressió nova.| | |Tipus d'expressió|Trieu el tipus d'expressió:
Cadena inclosa - coincideix amb la subcadena
Qualsevol cadena inclosa - coincideix amb totes les subcadenes d'una llista delimitada. La llista delimitada inclou una coma (,), un punt (.) o una barra inclinada (/).
La cadena no s'inclou - coincideix amb qualsevol cadena excepte la subcadena
El resultat és CERT - coincideix amb l'expressió regular
El resultat és FALS - no coincideix amb l'expressió regular| |^|Expressió|Introduïu una subcadena/expressió regular.| |Delimitador|<|Una coma (,), punt (.) o barra inclinada (/) per separar cadenes de text en una expressió regular. Aquest paràmetre només és actiu quan es tria el tipus d'expressió "Qualsevol cadena de caràcters inclosa".| |Distingeix entre majúscules i minúscules|<|Una casella de selecció per especificar si una expressió regular distingeix entre majúscules i minúscules.|

Una barra inclinada (/) a l'expressió es tracta literalment, en lloc d'un delimitador. D'aquesta manera és possible desar expressions que contenen una barra, sense errors.

A la pestanya Provar, l'expressió regular i les seves subexpressions es poden provar proporcionant una cadena de prova.

Els resultats mostren l'estat de cada subexpressió i l'estat total de l'expressió personalitzada.

L'estat total de l'expressió personalitzada s'estableix a Resultat combinat. Si es defineixen diverses subexpressions, Zabbix empra l'operador I lògic per calcular el resultat combinat. Això vol dir que si almenys un resultat és Fals, el Resultat combinat també té l'estat Fals.

Expressions regulars globals per defecte

Zabbix conté per defecte diverses expressions regulars globals.

Exemples

Exemple 1

Ús de l'expressió següent a la descoberta de baix nivell per trobarbases de dades, excepte una base de dades amb un nom específic:

  ^ BASE DE DADES DE TEST$

Tipus d'expressió triada: "El resultat és FALS". No coincideix amb el nom, que conté la cadena "TESTDATABASE".

Exemple amb un modificador de regex en línia

Ús de l'expressió regular següent, inclòs un modificador en línia (?i) per fer coincidir els caràcters d'"error":

  (?i)error

Tipus d'expressió triat: "El resultat és CERT". Els caràcters d'"error" coincideixen.

Un altre exemple amb un modificador d'expressió regular en línia

Ús de l'expressió regular següent, inclosos diversos modificadors en línia per fer coincidir caràcters després d'una línia específica:

  (?<=match (?i)tot(?-i) després d'aquesta línia\n)(?sx).*# afegim el modificador s per permetre . per fer coincidir els caràcters de nova línia

Tipus d'expressió triada: "El resultat és CERT". Els caràcters després d'una línia específica coincideixen.

Suport de les expressions regulars per ubicació

|Ubicació|<|Expressió regular|Expressió regular global|Concordança multilínia|Comentaris| |-|----------|----------|----------|----------|------- ---------------| |Elements de l'agent|<|<|<|<|<| |<|eventlog[]|Sí|Sí|Sí|Paràmetres regexp, severity, source, eventid| |^|log[]||^||paràmetre regexp| |^{|log.count[]|}|^||^| |^|logrt[]||Sí/No|^|El paràmetre regexp admet totes dues, el paràmetre file_regexp només admet expressions no globals| |^{|logrt.count[]|}|^||^ |^{|proc.cpu.util[]|}|No|No|paràmetre cmdline| |^|proc.mem[]||^||^| |^|proc.num[]||^||^| |^|sensor[]||^||paràmetres dispositiu i sensor a Linux 2.4| |^{|system.hw.macaddr[]|}|^||paràmetre interface| |^{|system.sw.packages[]|}|^||paràmetre package| |^{|vfs.dir.count[]|}|^||Paràmetres regex_incl, regex_excl, regex_excl_dir| |^{|vfs.dir.get[]|}|^||Paràmetres regex_incl, regex_excl, regex_excl_dir| |^{|vfs.dir.size[]|}|^||Paràmetres regex_incl, regex_excl, regex_excl_dir| |^{|vfs.file.regexp[]|}|^|Sí|paràmetre regexp| |^{|vfs.file.regmatch[]|}|^||^| |^{|web.page.regexp[]|}|^||^| |Traps SNMP|<|<|<|<|<| |<|snmptrap[]|Sí|Sí|No|paràmetre regexp| |Preprocessament del valor de l'element|<|Sí|No|No|paràmetre pattern| |Funcions per a triggers/elements calculats|<|<|<|<|<| |<|count()|Yes|Yes|Yes|paràmetre pattern si el paràmetre operator és regexp o iregexp| |<|countunique()|sí|sí|^|| |<|find()|Sí|Sí|^|| |^|logeventid()|Sí|Sí|No|paràmetre patró| |^{|logsource()|}|^||^| |Descoberta de baix nivell|<|<|<|<|<| |<|Filters|Sí|Sí|No|Camp Expressió regular| |^{|Overrides|Sí|No|}|A les opcions coincideix, no coincideix per a les condicions de operació| |Condicions d'acció|<|Sí|No|No|A les opcions coincideix, no coincideix per a Nom d'equip i Metadades de l'equip de condicions d'autoinscripció| |Monitoratge web|<|Sí|No|Sí|Variables amb un prefix regex:
Camp String required| |Context de macro d'usuari|<|Sí|No|No|En un context de macro amb un prefix regex:| |Funcions de macro|<|<|<|<|<| |<|regsub()|Sí|No|No|paràmetre pattern| |^|iregsub()||^||^| |Mapatge d'icones|<|Sí|Sí|No|Camp Expressió| |Mapatge de valors|<|Sí|No|No|Camp Valor si el tipus de mapatge és regexp|