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. Šādā gadījumā 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 parametram ir šāda sintakse:
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 liels datu apjoms.
UNIX sistēmās aģents izpilda lietotāja parametru komandas, izmantojot /bin/sh, ar operētājsistēmas kontu, ar kuru darbojas aģents (parasti zabbix).
Šim kontam ir 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īgi 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ā var izmantot pozicionālās atsauces $1…$9, lai atsauktos uz attiecīgo parametru vienuma atslēgā. Zabbix parsē vienuma atslēgas [ ] ietvertos parametrus un attiecīgi aizstāj komandā $1,...,$9. $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 izmantotu pozicionālās atsauces nemainītā veidā, norādiet divas dolāra zīmes, piemēram, awk '{print $$2}'. Šajā gadījumā $$2 komandas izpildes laikā faktiski tiks pārveidots par $2. |
Pozicionālās atsauces ar dolāra zīmi Zabbix aģents meklē un aizstāj tikai elastīgajiem lietotāja parametriem. Vienkāršiem lietotāja parametriem šāda atsauču apstrāde tiek izlaista, tāpēc dolāra zīmes maskēšana nav nepieciešama.
Pēc noklusējuma lietotāja parametros nav atļautas noteiktas rakstzīmes. Pilnu rakstzīmju sarakstu skatiet UnsafeUserParameters.
Elastīgu lietotāja parametru piemēri
Tālāk sniegtie piemēri ir paredzēti demonstrēšanai, un tos nedrīkst 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 injicēšanas risku.
1. piemērs: parametra atgriešana
UserParameter=ping[*],echo $1
Izmantojot šo lietotāja parametru, varat 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ā, kas ir pieejams šim kontam.
3. piemērs: Rindu skaitīšana, kas atbilst paraugam
Š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 faila /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, 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.