12 Regulārās izteiksmes
Pārskats
Perl Compatible Regular Expressions (PCRE, PCRE2) tiek atbalstītas Zabbix.
Zabbix regulārās izteiksmes var izmantot divos veidos:
- manuāli ievadot regulāro izteiksmi
- izmantojot globālo regulāro izteiksmi, kas izveidota Zabbix
Regulārās izteiksmes
Atbalstītajās vietās varat manuāli ievadīt regulāro izteiksmi. Ņemiet vērā, ka izteiksme nedrīkst sākties ar @, jo šis simbols Zabbix tiek izmantots globālo regulāro izteiksmju atsaucēm.
Izmantojot regulārās izteiksmes, var beigties steks. Plašāku informāciju skatiet pcrestack man lapā.
Ņemiet vērā, ka vairākrindu atbilstības gadījumā enkuri ^ un $ atbilst attiecīgi katras rindas sākumam/beigām, nevis visas virknes sākumam/beigām.
Skatiet arī piemērus par pareizu atsoļošanu dažādos kontekstos.
Globālas regulārās izteiksmes
Zabbix lietotāja saskarnē ir pieejams paplašināts redaktors sarežģītu regulāro izteiksmju izveidei un testēšanai.
Kad regulārā izteiksme ir izveidota šādā veidā, to var izmantot vairākās lietotāja saskarnes vietās, atsaucoties uz tās nosaukumu ar prefiksu @, piemēram, \@mycustomregexp.
Lai izveidotu globālu regulāro izteiksmi:
- Dodieties uz: Administration > General
- Nolaižamajā sarakstā atlasiet Regular expressions
- Noklikšķiniet uz New regular expression
Cilne Expressions ļauj iestatīt regulārās izteiksmes nosaukumu un pievienot apakšizteiksmes.
Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti.
| Parameter | Description | |
|---|---|---|
| Name | Iestatiet regulārās izteiksmes nosaukumu. Ir atļautas jebkādas Unicode rakstzīmes. | |
| Expressions | Noklikšķiniet uz Add blokā Expressions, lai pievienotu jaunu apakšizteiksmi. | |
| Expression type | Atlasiet izteiksmes tipu: Character string included - atbilst apakšvirknei Any character string included - atbilst jebkurai apakšvirknei no norobežota saraksta. Norobežotajā sarakstā ietilpst komats (,), punkts (.) vai slīpsvītra (/). Character string not included - atbilst jebkurai virknei, izņemot apakšvirkni Result is TRUE - atbilst regulārajai izteiksmei Result is FALSE - neatbilst regulārajai izteiksmei |
|
| Expression | Ievadiet apakšvirkni/regulāro izteiksmi. | |
| Delimiter | Komats (,), punkts (.) vai slīpsvītra (/), lai atdalītu teksta virknes regulārajā izteiksmē. Šis parametrs ir aktīvs tikai tad, ja ir atlasīts izteiksmes tips "Any character string included". | |
| Case sensitive | Atzīmes rūtiņa, lai norādītu, vai regulārā izteiksme ir jutīga pret burtu reģistru. | |
Slīpsvītra (/) izteiksmē tiek apstrādāta burtiski, nevis kā norobežotājs. Tādējādi ir iespējams saglabāt izteiksmes, kas satur slīpsvītru, bez kļūdām.
Pielāgotas regulārās izteiksmes nosaukums Zabbix var saturēt komatus, atstarpes u. c.
Tajos gadījumos, kad tas var novest pie nepareizas interpretācijas, veicot atsauci (piemēram, komats vienuma atslēgas parametrā), visu atsauci var ievietot pēdiņās šādi: "\@My custom regexp for purpose1, purpose2".
Citās vietās regulāro izteiksmju nosaukumus pēdiņās neliek (piemēram, LLD noteikuma īpašībās).
Cilnē Test regulāro izteiksmi un tās apakšizteiksmes var testēt, ievadot testa virkni.
Rezultātos tiek parādīts katras apakšizteiksmes statuss un kopējais pielāgotās izteiksmes statuss.
Kopējais pielāgotās izteiksmes statuss tiek definēts kā Combined result. Ja ir definētas vairākas apakšizteiksmes, Zabbix izmanto loģisko operatoru AND, lai aprēķinātu Combined result. Tas nozīmē, ka, ja vismaz vienam Result ir False, arī Combined result statuss būs False.
Noklusējuma globālie regulārie izteicieni
Zabbix komplektā ir iekļauti vairāki globālie regulārie izteicieni tā noklusējuma datu kopā.
| Name | Expression | Matches |
|---|---|---|
| Failu sistēmas atklāšanai | ^(btrfs|ext2|ext3|ext4|jfs|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|refs|apfs|ntfs|fat32|zfs)$ |
"btrfs" vai "ext2" vai "ext3" vai "ext4" vai "jfs" vai "reiser" vai "xfs" vai "ffs" vai "ufs" vai "jfs" vai "jfs2" vai "vxfs" vai "hfs" vai "refs" vai "apfs" vai "ntfs" vai "fat32" vai "zfs" |
| Tīkla saskarnes atklāšanai | ^Software Loopback Interface |
Virknes, kas sākas ar "Software Loopback Interface". |
^lo$ |
"lo" | |
^(In)?[Ll]oop[Bb]ack[0-9._]*$ |
Virknes, kas pēc izvēles sākas ar "In", pēc tam satur "L" vai "l", tad "oop", pēc tam "B" vai "b", tad "ack", kam pēc izvēles var sekot jebkurš ciparu, punktu vai pasvītrojumu skaits. | |
^NULL[0-9.]*$ |
Virknes, kas sākas ar "NULL", kam pēc izvēles var sekot jebkurš ciparu vai punktu skaits. | |
^[Ll]o[0-9.]*$ |
Virknes, kas sākas ar "Lo" vai "lo" un kam pēc izvēles var sekot jebkurš ciparu vai punktu skaits. | |
^[Ss]ystem$ |
"System" vai "system" | |
^Nu[0-9.]*$ |
Virknes, kas sākas ar "Nu", kam pēc izvēles var sekot jebkurš ciparu vai punktu skaits. | |
| Krātuves ierīces SNMP atklāšanai | ^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$ |
"Physical memory" vai "Virtual memory" vai "Memory buffers" vai "Cached memory" vai "Swap space" |
| Windows pakalpojumu nosaukumi atklāšanai | ^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$ |
"MMCSS" vai "gupdate" vai "SysmonLog" vai virknes, piemēram, "clr_optimization_v2.0.50727_32" un "clr_optimization_v4.0.30319_32", kur punktu vietā var ievietot jebkuru rakstzīmi, izņemot jaunu rindu. |
| Windows pakalpojumu startēšanas stāvokļi atklāšanai | ^(automatic|automatic delayed)$ |
"automatic" vai "automatic delayed" |
Piemēri
Piemērs 1
Tālāk norādītās izteiksmes izmantošana zemā līmeņa atklāšanā, lai atklātu datubāzes, izņemot datubāzi ar noteiktu nosaukumu:
^TESTDATABASE$
Izvēlētais izteiksmes tips: "Rezultāts ir FALSE". Neatbilst nosaukumam, kas satur virkni "TESTDATABASE".
Piemērs ar iekļautu regulārās izteiksmes modifikatoru
Tālāk norādītās regulārās izteiksmes izmantošana, iekļaujot iekļautu modifikatoru (?i), lai atbilstu rakstzīmēm "error":
(?i)error
Izvēlētais Expression type: "Result is TRUE". Rakstzīmes "error" tiek atrastas.
Vēl viens piemērs ar iekļautu regulārās izteiksmes modifikatoru
Tālāk norādītās regulārās izteiksmes izmantošana, iekļaujot vairākus iekļautos modifikatorus, lai atrastu rakstzīmes aiz noteiktas rindas:
(?<=match (?i)everything(?-i) after this line\n)(?sx).*# we add s modifier to allow . match newline characters
Izvēlētais izteiksmes tips: "Result is TRUE". Rakstzīmes aiz noteiktas rindas tiek atrastas.
g modifikatoru nevar norādīt rindā. Pieejamo modifikatoru sarakstu var atrast pcresyntax man page. Plašāku informāciju par PCRE sintaksi skatiet PCRE HTML documentation.
Regulārās izteiksmes atbalsts pēc atrašanās vietas
| Atrašanās vieta | Regulārā izteiksme | Globālā regulārā izteiksme | Vairākrindu atbilstība | Komentāri | |
|---|---|---|---|---|---|
| Aģenta vienumi | |||||
| eventlog[] | Yes | Yes | Yes | regexp, severity, source, eventid parametri |
|
| eventlog.count[] | regexp, severity, source, eventid parametri |
||||
| log[] | regexp parametrs |
||||
| log.count[] | |||||
| logrt[] | Yes/No | regexp parametrs atbalsta abus, file_regexp parametrs atbalsta tikai neglobālās izteiksmes |
|||
| logrt.count[] | |||||
| proc.cpu.util[] | No | No | cmdline parametrs |
||
| proc.get[] | |||||
| proc.mem[] | |||||
| proc.num[] | |||||
| sensor[] | device un sensor parametri Linux 2.4 |
||||
| system.hw.macaddr[] | interface parametrs |
||||
| system.sw.packages[] | regexp parametrs |
||||
| system.sw.packages.get[] | regexp parametrs |
||||
| vfs.dir.count[] | regex_incl, regex_excl, regex_excl_dir parametri |
||||
| vfs.dir.get[] | regex_incl, regex_excl, regex_excl_dir parametri |
||||
| vfs.dir.size[] | regex_incl, regex_excl, regex_excl_dir parametri |
||||
| vfs.file.regexp[] | Yes | regexp parametrs |
|||
| vfs.file.regmatch[] | |||||
| web.page.regexp[] | |||||
| SNMP slazdi | |||||
| snmptrap[] | Yes | Yes | No | regexp parametrs |
|
| Vienuma vērtības pirmapstrāde | Yes | No | No | pattern parametrs |
|
| Funkcijas trigeriem/ aprēķinātajiem vienumiem | |||||
| count() | Yes | Yes | Yes | pattern parametrs, ja operator parametrs ir regexp vai iregexp |
|
| countunique() | Yes | Yes | |||
| find() | Yes | Yes | |||
| logeventid() | Yes | Yes | No | pattern parametrs |
|
| logsource() | |||||
| Zema līmeņa atklāšana | |||||
| Filtri | Yes | Yes | No | Lauks Regular expression | |
| Pārrakstīšanas | Yes | No | Opcijās matches, does not match nosacījumiem Operation | ||
| Darbību nosacījumi | Yes | No | No | Opcijās matches, does not match automātiskās reģistrācijas nosacījumiem Host name un Host metadata | |
| Skripti | Yes | Yes | No | Lauks Input validation rule | |
| Tīmekļa uzraudzība | Yes | No | Yes | Variables ar prefiksu regex: Lauks Required string |
|
| Lietotāja makro konteksts | Yes | No | No | Makro kontekstā ar prefiksu regex: | |
| Makro funkcijas | |||||
| regsub() | Yes | No | No | pattern parametrs |
|
| iregsub() | |||||
| Saišu indikatori kartēs | Yes | No | No | Lauks Pattern (teksta vienumiem) | |
| Ikonu kartēšana | Yes | Yes | No | Lauks Expression | |
| Vērtību kartēšana | Yes | No | No | Lauks Value, ja kartēšanas tips ir regexp |
|