5 Lietotāja parametri
Pārskats
Dažkārt var būt nepieciešams palaist aģenta pārbaudi, kas nav iepriekš definēta Zabbix. Šādos gadījumos noder lietotāja parametri.
Varat uzrakstīt komandu, kas izgūst nepieciešamos datus, un iekļaut to lietotāja parametrā aģenta konfigurācijas failā (konfigurācijas parametrs UserParameter).
Lietotāja parametra sintakse ir šāda:
UserParameter=<key>,<command>
Kā redzams, lietotāja parametrs satur arī atslēgu. Atslēga būs nepieciešama, konfigurējot vienumu. Ievadiet paša izvēlētu atslēgu, uz kuru būs viegli atsaukties (tai jābūt unikālai konkrētā host ietvaros).
Restartējiet aģentu vai izmantojiet aģenta izpildlaika vadības opciju, lai ielādētu jauno parametru, piemēram:
zabbix_agentd -R userparameter_reload
Pēc tam, konfigurējot vienumu, ievadiet atslēgu, lai atsauktos uz komandu no lietotāja parametra, kuru vēlaties izpildīt.
Lietotāja parametri ir komandas, ko izpilda Zabbix aģents. Ņemiet vērā, ka pirms vienuma vērtības priekšapstrādes darbībām var tikt atgriezts līdz 16 MB datu.
UNIX sistēmās aģents izpilda lietotāja parametru komandas, izmantojot /bin/sh, ar operētājsistēmas kontu, kurā darbojas aģents (parasti zabbix).
Šim kontam jābūt pietiekamām atļaujām, lai izpildītu komandu un piekļūtu visiem tās izmantotajiem failiem, ligzdām vai akreditācijas datiem.
Uz lietotāja parametriem attiecas aģenta pārbaudes taimauts; ja taimauts tiek sasniegts, atdalītais lietotāja parametra process tiek pārtraukts.
Skatiet arī:
- Soli pa solim pamācību par lietotāja parametru izmantošanu
- Komandu izpilde
Vienkāršu lietotāja parametru piemēri
1. piemērs: konstanta vērtība
UserParameter=ping,echo 1
Vienums ar atslēgu ping vienmēr atgriež 1.
2. piemērs: MySQL servera pieejamība
UserParameter=mysql.ping,mysqladmin ping 2>/dev/null | grep -c alive
Atgriež 1, ja MySQL serveris atbild, un 0 pretējā gadījumā.
Novirzīšana 2>/dev/null atmet standarta kļūdu izvadi no mysqladmin.
Bez tās kopā ar 0 varētu tikt atgriezts kļūdas ziņojums, kā rezultātā vienums ar informācijas tipu Numeric kļūtu neatbalstīts (skatiet Komandas rezultāts).
Šajā piemērā tiek pieņemts, ka MySQL savienojuma akreditācijas dati ir konfigurēti operētājsistēmas kontam, kurā darbojas Zabbix aģents, piemēram, MySQL opciju failā, kuram šim kontam ir piekļuve.
Elastīgie lietotāja parametri
Elastīgie lietotāja parametri pieņem parametrus kopā ar atslēgu. Tādējādi elastīgs lietotāja parametrs var būt pamats vairāku vienumu izveidei.
Elastīgajiem lietotāja parametriem ir šāda sintakse:
UserParameter=key[*],command
| Parameter | Description |
|---|---|
| Key | Unikāla vienuma atslēga. [*] norāda, ka šī atslēga pieņem parametrus iekavās. Parametri tiek norādīti, konfigurējot vienumu. |
| Command | Izpildāmā komanda atslēgas vērtības novērtēšanai. Tikai elastīgajiem lietotāja parametriem: Komandā varat izmantot pozicionālās atsauces $1…$9, lai atsauktos uz attiecīgo parametru vienuma atslēgā. Zabbix parsē vienuma atslēgas [ ] iekavās ietvertos parametrus un attiecīgi aizstāj $1,...,$9 komandā. $0 tiks aizstāts ar sākotnējo komandu (pirms $0,...,$9 izvēršanas), kas jāizpilda. Pozicionālās atsauces tiek interpretētas neatkarīgi no tā, vai tās ir ietvertas dubultajās (") vai vienkāršajās (') pēdiņās. Lai pozicionālās atsauces izmantotu nemainītas, norādiet divas dolāra zīmes, piemēram, awk '{print $$2}'. Šādā gadījumā $$2 komandas izpildes laikā faktiski tiks pārveidots par $2. |
Pozicionālās atsauces ar $ zīmi Zabbix aģents meklē un aizstāj tikai elastīgajiem lietotāja parametriem. Vienkāršajiem lietotāja parametriem šāda atsauču apstrāde tiek izlaista, tāpēc jebkāda $ zīmes ekranēšana nav nepieciešama.
Pēc noklusējuma lietotāja parametros nav atļautas noteiktas rakstzīmes. Pilnu rakstzīmju sarakstu skatiet sadaļā UnsafeUserParameters.
Elastīgu lietotāja parametru piemēri
Tālāk sniegtie piemēri ir paredzēti demonstrēšanai, un tos nevajadzētu izmantot produkcijas vidē bez atbilstošiem drošības pasākumiem.
Elastīgi lietotāja parametri, kas definēti, izmantojot [*], pieņem argumentus, kuri, ja netiek droši apstrādāti, var radīt komandu injekcijas risku.
1. piemērs: parametra atgriešana
UserParameter=ping[*],echo $1
Izmantojot šo lietotāja parametru, var definēt vairākus vienumus ar atslēgām formātā ping[parameter]:
ping[0]- atgriež0.ping[hello]- atgriežhello.
2. piemērs: MySQL pieejamība norādītajā hostā
Šo parametru var izmantot, lai pārraudzītu MySQL servera pieejamību norādītajā hostā.
UserParameter=mysql.ping[*],mysqladmin -h "$1" ping 2>/dev/null | grep -c alive
Vienums ar atslēgu mysql.ping[db1.example.com] atgriež 1, ja MySQL serveris šajā hostā atbild, un 0 pretējā gadījumā.
Šajā piemērā tiek pieņemts, ka MySQL savienojuma akreditācijas dati ir konfigurēti operētājsistēmas kontam, kurā darbojas Zabbix aģents, piemēram, MySQL opciju failā, kuram šim kontam ir piekļuve.
3. piemērs: Rindas, kas atbilst paraugam, skaitīšana
Šo parametru var izmantot, lai saskaitītu rindu skaitu failā.
UserParameter=grep.count[*],grep -c "$2" "$1"
Atgriež to faila rindu skaitu, kas norādīts ar pirmo argumentu un atbilst ar otro argumentu norādītajai regulārajai izteiksmei.
Piemēram, grep.count[/etc/passwd,root] atgriež to /etc/passwd rindu skaitu, kas atbilst regulārajai izteiksmei root.
Komandas rezultāts
Komandas atgrieztā vērtība ir standarta izvade kopā ar standarta kļūdu, ko ģenerē komanda.
Vienums, kas atgriež tekstu (rakstzīmju, žurnāla vai teksta tipa informāciju), nekļūs neatbalstīts standarta kļūdas izvades gadījumā.
Atgrieztās vērtības apjoms ir ierobežots līdz 16 MB (ieskaitot beigu atstarpes rakstzīmes, kas tiek saīsinātas); datubāzes ierobežojumi arī ir spēkā.
Lietotāja parametri, kas atgriež tekstu (rakstzīmju, žurnāla vai teksta tipa informāciju), var atgriezt arī atstarpi. Nederīga rezultāta gadījumā vienums kļūs neatbalstīts.