Aquesta secció proporciona detalls sobre les claus d'element que empren la comunicació amb l'agent Zabbix per a la recollida de dades.
Hi ha comprovacions d'agent passius i actius. Quan es configura un element, podeu triar el tipus desitjat:
Tingueu en compte que totes les claus d'elements admeses per l'agent Zabbix a Windows també són compatibles amb l'agent Zabbix 2. Consulteu les claus d'element addicionals que només podeu emprar amb l'agent 2.
Les claus d'element que podeu emprar amb l'agent Zabbix es mostren tot seguit.
Les claus d'element es llisten sense paràmetres ni informació addicional. Feu clic a la clau de l'element per veure'n tots els detalls.
Clau d'element | Descripció | Grup d'elements |
---|---|---|
kernel.maxfiles | Nombre màxim de fitxers oberts compatibles amb el sistema operatiu. | Nucli |
kernel.maxproc | Nombre màxim de processos suportats pel sistema operatiu. | |
kernel.openfiles | Nombre de descriptors de fitxers oberts actualment. | |
log | Monitoratge d'un fitxer de registre. | Supervisió de registre |
log.count | Recompte de línies coincidents en un fitxer de registre monitorat. | |
logrt | Monitoratge d'un fitxer de registre que es gira. | |
logrt.count | Recompte de línies coincidents en un fitxer de registre monitorat que es gira. | |
modbus.get | Llegeix dades Modbus. | Modbus |
net.dns | Comprova si el servei DNS és activat. | Xarxa |
net.dns.perf | Comprova el rendiment del servei DNS. | |
net.dns.record | Fa una consulta DNS. | |
net.if.collisions | Nombre de col·lisions fora de la finestra. | |
net.if.discovery | Llistat d'interfícies de xarxa. | |
net.if.in | Estadístiques de trànsit entrant en una interfície de xarxa. | |
net.if.out | Estadístiques de trànsit de sortida en una interfície de xarxa. | |
net.if.total | Suma de les estadístiques de trànsit entrant i sortint en una interfície de xarxa. | |
net.tcp.listen | Comprova si aquest port TCP és en estat LISTEN. | |
net.tcp.port | Comprova si és possible establir una connexió TCP al port especificat. | |
net.tcp.service | Comprova si un servei s'és executant i accepta connexions TCP. | |
net.tcp.service.perf | Comprova el rendiment d'un servei TCP. | |
net.tcp.socket.count | Retorna el nombre de sockets TCP que coincideixen amb els paràmetres. | |
net.udp.listen | Comprova si aquest port UDP és en estat LISTEN. | |
net.udp.service | Comprova si un servei s'és executant i respon a les sol·licituds UDP. | |
net.udp.service.perf | Comprova el rendiment d'un servei UDP. | |
net.udp.socket.count | Retorna el nombre de sòcols UDP que coincideixen amb els paràmetres. | |
proc.cpu.util | Percentatge d'ús de la CPU del procés. | Processos |
proc.get | Llistat de processos del sistema operatiu i els seus paràmetres. | |
proc.mem | Memòria emprada pel procés en bytes. | |
proc.num | Nombre de processos. | |
sensor | Lectura del sensor de maquinari. | Sensors |
system.boottime | Temps d'engegada del sistema. | System |
system.cpu.discovery | Llistat de CPU/nuclis de CPU detectats. | |
system.cpu.intr | El dispositiu s'interromp. | |
system.cpu.load | Càrrega de la CPU. | |
system.cpu.num | Nombre de CPU. | |
system.cpu.switches | Recompte de canvis de context. | |
system.cpu.util | Percentatge d'ús de la CPU. | |
system.hostname | Nom de l'equip del sistema. | |
system.hw.chassis | Informació del xassís. | |
system.hw.cpu | Informació de la CPU. | |
system.hw.devices | Llistat de dispositius PCI o USB. | |
system.hw.macaddr | Llistat d'adreces MAC. | |
system.localtime | Hora del sistema. | |
system.run | Executeu l'ordre especificada a l'equip. | |
system.stat | Estadístiques del sistema. | |
system.sw.arch | Informació de l'arquitectura del programari. | |
system.sw.os | Informació del sistema operatiu. | |
system.sw.os.get | Informació detallada sobre el sistema operatiu (versió, tipus, nom de distribució, versió menor i major, etc.). | |
system.sw.packages | Llistat de paquets instal·lats. | |
system.sw.packages.get | Llista detallada dels paquets instal·lats. | |
system.swap.in | Estadístiques d'intercanvi (del dispositiu a la memòria). | |
system.swap.out | Estadístiques d'intercanvi (de la memòria al dispositiu). | |
system.swap.size | Mida de l'espai d'intercanvi en octets o percentatge respecte al total. | |
system.uname | Identificació del sistema. | |
system.uptime | Temps de funcionament del sistema en segons. | |
system.users.num | Nombre d'usuaris connectats. | |
vfs.dev.discovery | Llistat de dispositius de bloc i el seu tipus. | Sistemes de fitxers virtuals |
vfs.dev.read | Estadístiques de lectura del disc. | |
vfs.dev.write | Estadístiques d'escriptura del disc. | |
vfs.dir.count | Recompte d'entrades del directori. | |
vfs.dir.get | Llistat d'entrades del directori. | |
vfs.dir.size | Mida del directori. | |
vfs.file.cksum | Suma de comprovació del fitxer, calculada per l'algoritme cksum de UNIX. | |
vfs.file.contents | Recuperació del contingut d'un fitxer. | |
vfs.file.exists | Comprova si el fitxer existeix. | |
vfs.file.get | Retorna informació sobre un fitxer. | |
vfs.file.md5sum | Suma de comprovació MD5 del fitxer. | |
vfs.file.owner | Recupera el propietari d'un fitxer. | |
vfs.file.permissions | Retorna una cadena de 4 dígits que conté el nombre octal amb permisos UNIX. | |
vfs.file.regexp | Recuperar una cadena al fitxer. | |
vfs.file.regmatch | Cerca una cadena al fitxer. | |
vfs.file.size | Mida del fitxer. | |
vfs.file.time | Informació de l'hora del fitxer. | |
vfs.fs.discovery | Llistat de sistemes de fitxers muntats amb les seves opcions de tipus i muntatge. | |
vfs.fs.get | Llistat de sistemes de fitxers muntats amb el seu tipus, espai disponible en disc, estadístiques d'inode i opcions de muntatge. | |
vfs.fs.inode | Nombre o percentatge d'inodes. | |
vfs.fs.size | L'espai de disc en octets o en percentatge del total. | |
vm.memory.size | Mida de la memòria en octets o en percentatge respecte al total. | Memòria virtual |
web.page.get | Obtindre el contingut d'una pàgina web. | Supervisió web |
web.page.perf | Temps de càrrega d'una pàgina web completa. | |
web.page.regexp | Cerca una cadena a la pàgina web. | |
agent.hostmetadata | Metadades de l'equip de l'agent. | Zabbix |
agent.hostname | Nom d'equip de l'agent. | |
agent.ping | Comprovació de la disponibilitat de l'agent. | |
agent.variant | Variant de l'agent Zabbix (agent Zabbix o agent Zabbix 2). | |
agent.version | Versió de l'agent Zabbix. | |
zabbix.stats | Retorna un conjunt de mètriques internes del servidor o proxy Zabbix de forma remota. | |
zabbix.stats | Retorna el nombre d'elements monitorats a la cua que s'endarrereixen al servidor Zabbix o al proxy de forma remota. |
Excepte quan s'especifiqui de manera diferent als detalls de l'element, els elements de l'agent (i tots els paràmetres) s'admeten a:
Molts elements d'agent també són compatibles amb Windows. Consulteu la pàgina Element de l'agent de Windows per obtindre més informació.
Els paràmetres sense claudàtors angulars són obligatoris. Els paràmetres marcats amb claudàtors angulars < > són opcionals.
El nombre màxim de fitxers oberts compatibles amb el sistema operatiu.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.
El nombre màxim de processos compatibles amb el sistema operatiu.
Valor de retorn: Enter.
Plataformes admeses: Linux 2.6 i posteriors, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.
Nombre de descriptors de fitxers oberts actualment.
Valor de retorn: Enter.
Plataformes admeses: Linux (l'element pot funcionar en altres plataformes semblants a UNIX).
El seguiment d'un fitxer de registre.
Valor de retorn: Log.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
output
es deixa buit, es retorna tota la línia que conté el text coincident. Tingueu en compte que tots els tipus d'expressions regulars globals excepte El resultat és CERT
sempre retornen tota la línia coincident i el paràmetre output
s'ignora.output
té lloc a l'agent.Exemples:
Exemple d'ús del paràmetre output
per extreure un nombre del registre de registre:
log[/app1/app.log,"execució de la tasca [0-9.]+ seg, registres processats ([0-9]+), [0-9]+ errors",,,,\1] #aquest element coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons, processats 6080 registres, 0 errors" i enviarà només "6080" al servidor. Com que s'envia un valor numèric, el "Tipus d'informació" d'aquest element es pot definir a "Numèric (sense signe)" i el valor es pot emprar en gràfics, triggers, etc.
Exemple d'ús del paràmetre output
per reescriure un registre de registre abans d'enviar-lo al servidor:
log[/app1/app.log,"([0-9 :-]+) tasca executada ([0-9.]+) segons, registres processats ([0-9]+), ([0-9] +) errors",,,,"\1 REGISTRES: \3, ERRORS: \4, DURADA: \2"] #aquest element coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons , processat 6080 registres, 0 errors" i enviar un registre modificat "2015-11-13 10:08:26 REGISTRES: 6080, ERRORS: 0, DURADA: 6.08" al servidor.
El recompte de línies coincidents en un fitxer de registre monitorat.
Valor de retorn: Enter.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
El seguiment d'un fitxer de registre que es gira.
Valor de retorn: Log.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
output
es deixa buit, es retorna tota la línia que conté el text coincident. Tingueu en compte que tots els tipus d'expressions regulars globals excepte El resultat és CERT
sempre retornen tota la línia coincident i el paràmetre output
s'ignora.output
té lloc a l'agent.Exemples:
logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] #aquest element coincidirà amb un fitxer com "logfile1" (no coincidirà amb ".logfile1")
logrt["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #aquest element recopilarà dades de fitxers com "logfile_abc_1" o "logfile__001"
Exemple d'ús del paràmetre "sortida" per extreure un nombre del registre de registre:
logrt[/app1/^test.*log$,"execució de la tasca [0-9.]+ s, registres processats ([0-9]+), [0-9]+ errors",,,,\1] #aquest element coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons, processat 6080 registres, 0 errors" i només enviarà "6080" al servidor. Com que s'envia un valor numèric, el "Tipus d'informació" d'aquest element es pot definir a "Numèric (sense signar)" i el valor es pot emprar en gràfics, triggers, etc.
Exemple d'ús del paràmetre output
per reescriure un registre de registre abans d'enviar-lo al servidor:
logrt[/app1/^test.*log$,"([0-9 :-]+) execució de tasques ([0-9.]+) segons, registres processats ([0-9]+), ([0 -9]+) errors",,,,"\1 REGISTRES: \3, ERRORS: \4, DURATION: \2"] #aquest element coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executar 6,08 segons, processar 6080 registres, 0 errors" i enviar un registre modificat "2015-11-13 10:08:26 REGISTRES: 6080, ERRORS: 0, DURADA: 6,08" al servidor.|
El recompte de línies coincidents en un fitxer de registre monitorat que rota.
Valor de retorn: Enter.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
Llegeix dades Modbus.
Valor de retorn: objecte JSON.
Plataformes admeses: Linux.
Paràmetres:
protocol://cadena_connexió
;Veieu una descripció detallada dels paràmetres.
Comprova si el servei DNS és actiu.
Valors de retorn: 0: el DNS és inactiu (el servidor no ha respost o la resolució del DNS ha fallat); 1 - El DNS és actiu.
Veieu les plataformes compatibles.
Paràmetres:
Comentaris:
type
són: ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (no és compatible amb l'agent Zabbix a Windows, l'agent Zabbix 2 a tots els sistemes operatius), HINFO, MINFO, TXT, SRVtipus
s'estableix en PTR), podeu proporcionar el nom DNS tant en format invertit com en format no invertit (veieu els exemples a continuació). Tingueu en compte que quan es demana un registre PTR, el nom DNS és en realitat una adreça IP.Exemples:
net.dns[198.51.100.1,example.com,MX,2,1]
net.dns[,198.51.100.1,PTR]
net.dns[,1.100.51.198.in-addr.arpa,PTR]
net.dns[,2a00:1450:400f:800::200e,PTR]
net.dns[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]
Comprova el rendiment d'un servei DNS.
Valor de retorn: Flotant (0: el servei està caigut; segons: el nombre de segons que s'han passat esperant una resposta del servei).
Veieu les plataformes compatibles.
Paràmetres:
Comentaris:
type
són:tipus
s'estableix en PTR), podeu proporcionar el nom DNS tant en format invertit com en format no invertit (veieu els exemples a continuació). Tingueu en compte que quan es demana un registre PTR, el nom DNS és en realitat una adreça IP.0
whan el servidor DNS contesti amb un codi d'error (com ara NXDOMAIN
o SERVFAIL
).Exemples:
net.dns.perf[198.51.100.1,example.com,MX,2,1]
net.dns.perf[,198.51.100.1,PTR]
net.dns.perf[,1.100.51.198.in-addr.arpa,PTR]
net.dns.perf[,2a00:1450:400f:800::200e,PTR]
net.dns.perf[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR ]
Comprova si el servei DNS és actiu.
Valors de retorn: 0: el DNS és inactiu (el servidor no ha respost o la resolució del DNS ha fallat); 1 - El DNS és actiu.
Veieu les plataformes compatibles.
Paràmetres:
Comentaris:
type
són: ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (no és compatible amb l'agent Zabbix a Windows, l'agent Zabbix 2 a tots els sistemes operatius), HINFO, MINFO, TXT, SRVtipus
s'estableix en PTR), podeu proporcionar el nom DNS tant en format invertit com en format no invertit (veieu els exemples a continuació). Tingueu en compte que quan es demana un registre PTR, el nom DNS és en realitat una adreça IP.Exemples:
net.dns[198.51.100.1,example.com,MX,2,1]
net.dns[,198.51.100.1,PTR]
net.dns[,1.100.51.198.in-addr.arpa,PTR]
net.dns[,2a00:1450:400f:800::200e,PTR]
net.dns[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]
Nombre de col·lisions fora de la finestra.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. Els privilegis d'arrel són necessaris a NetBSD.
Paràmetre:
Llistat d'interfícies de xarxa. S'empra per a la descoberta de baix nivell.
Valor de retorn: objecte JSON.
Plataformes admeses: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.
Estadístiques de trànsit entrant en una interfície de xarxa.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Els privilegis d'arrel són necessaris a NetBSD.
Paràmetres:
Comentaris:
Exemples:
Estadístiques de trànsit de sortida en una interfície de xarxa.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Els privilegis d'arrel són necessaris a NetBSD.
Paràmetres:
Comentaris:
Exemples:
Suma de les estadístiques de trànsit entrant i sortint en una interfície de xarxa.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Els privilegis d'arrel són necessaris a NetBSD.
Paràmetres:
Comentaris:
Exemples:
Comprova si aquest port TCP és en estat LISTEN.
Valors de retorn: 0 - no és en estat LISTEN; 1 - és en estat LISTEN.
Plataformes admeses: Linux, FreeBSD, Solaris, MacOS X.
Paràmetre:
Als nuclis Linux 2.6.14 i posteriors, la informació sobre l'escolta dels sòcols TCP s'obté de la interfície NETLINK del nucli, si és possible. En cas contrari, la informació es recupera dels fitxers /proc/net/tcp i /roc/net/tcp6.
Exemple:
Comprova si és possible establir una connexió TCP al port especificat.
Valors de retorn: 0 - no es pot connectar; 1 - es pot connectar.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
net.tcp.service.perf[tcp,<ip>,<port>]
;Exemple:
net.tcp.port[,80] #aquest element es pot emprar per provar la disponibilitat del servidor web que s'executa al port 80
Comprova si un servei s'executa i accepta connexions TCP.
Valors de retorn: 0 - el servei és caigut; 1: el servei s'executa.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
net.tcp.port[]
per a comprovacions com aquestes.Exemple:
net.tcp.service[ftp,,45] #aquest element es pot emprar per provar la disponibilitat del servidor FTP al port TCP 45
Comprova el rendiment d'un servei TCP.
Valors de retorn: Flotant (0: el servei és caigut; segons: el nombre de segons que ha passat esperant una resposta del servei).
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
net.tcp.service.perf[tcp,<ip>,<port>]
per a comprovacions com aquestes.Exemple:
net.tcp.service.perf[ssh] #aquest element es pot emprar per provar la velocitat de resposta inicial des del servidor SSH
Retorna el nombre de sòcols TCP que coincideixen amb els paràmetres.
Valor de retorn: Enter.
Plataformes admeses: Linux.
Paràmetres:
Exemple:
net.tcp.socket.count[,80,,,established] #nombre de connexions al port TCP local 80 en l'estat establert
Comprova si aquest port UDP és en estat LISTEN.
Valors de retorn: 0 - no és en estat LISTEN; 1 - és en estat ESCOLTA.
Plataformes admeses: Linux, FreeBSD, Solaris, MacOS X.
Paràmetre:
Exemple:
Comprova si un servei s'executa i respon a les peticions UDP.
Valors de retorn: 0 - el servei és caigut; 1: el servei s'executa.
Veieu les plataformes compatibles.
Paràmetres:
Exemple:
net.udp.service[ntp,,45] #aquest element es pot emprar per provar la disponibilitat del servei NTP al port UDP 45
Comprova el rendiment d'un servei UDP.
Valors de retorn: Flotant (0: el servei és caigut; segons: el nombre de segons que han passat esperant la resposta del servei).
Veieu plataformes compatibles.
Paràmetres:
Exemple:
net.udp.service.perf[ntp] #aquest element es pot emprar per provar el temps de resposta del servei NTP
Retorna el nombre de sòcols UDPque coincideixen amb els paràmetres.
Valor de retorn: Enter.
Plataformes admeses: Linux.
Paràmetres:
Exemple:
Percentatge d'ús de la CPU del procés.
Valor de retorn: Flotant.
Plataformes admeses: Linux, Solaris6.
Paràmetres:
Comentaris:
zone
a actual (o predeterminat) en cas que l'agent s'hagi compilat en un Solaris sense suport de zones, però que s'executi en un Solaris més nou on s'admeten zones, l'agent retornarà NOTSUPPORTED (l'agent no pot limitar els resultats només a la zona actual). Tanmateix, tot és compatible en aquest cas.Exemples:
proc.cpu.util[,root] #Ús de la CPU de tots els processos que s'executen sota l'usuari "arrel"
proc.cpu.util[zabbix_server,zabbix] #Ús de la CPU de tots els processos zabbix_server que s'executen sota l'usuari zabbix
Llistat de processos del sistema operatiu i els seus paràmetres. Es pot emprar per a la descoberta de baix nivell.
Valor de retorn: objecte JSON.
Plataformes admeses: Linux, FreeBSD, Windows, OpenBSD, NetBSD.
Paràmetres:
Comentaris:
-1
;name
i cmdline
(específics de Linux).Exemples:
proc.get[zabbix_server,zabbix,,process] #llistat de tots els processos Zabbix que fa córrer l'usuari Zabbix, retorna una entrada per PID
proc.get[java,,,thread] #llistat de tots els processos Java, retorna una entrada per fil
proc.get[,zabbix,,summary] #dades combinades per als processos Zabbix de cada tipus, retorna una entrada per nom de procés
Memòria emprada pel procés en octets.
Valor de retorn: Enter - amb mode
com a max, min, sum; Float - amb mode
com a mitjana
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.
Paràmetres:
Comentaris:
memtype
només és compatible amb Linux, FreeBSD, Solaris6, AIX;name
i paràmetres cmdline
(específics de Linux).zabbix_agentd -t proc.mem[,,,apache2]
), es comptarà un procés addicional, ja que l'agent es comptarà a ell mateix.Exemples:
proc.mem[,root] #la memòria emprada per tots els processos que s'executen sota l'usuari "arrel".
proc.mem[zabbix_server,zabbix] #la memòria emprada per tots els processos zabbix_server que s'executen sota l'usuari zabbix
proc.mem[,oracle,max,oracleZABBIX] #la memòria emprada pel procés amb més memòria que s'executa sota Oracle amb oracleZABBIX a la seva línia d'ordres
Nombre de processos.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris6, HP-UX, AIX, OpenBSD, NetBSD.
Paràmetres:
Comentaris:
zabbix_agentd -t proc.num[,,,apache2]
), es comptarà un procés addicional, com a agent es comptarà a si mateix;zone
a actual (o predeterminat) en cas que l'agent s'hagi compilat en un Solaris sense suport de zones, però que s'executi en un Solaris més nou on s'admeten zones, l'agent retornarà NOTSUPPORTED (l'agent no pot limitar els resultats només a la zona actual). Tanmateix, tot és compatible en aquest cas.name
i cmdline
(específics de Linux).Exemples:
proc.num[,mysql] #el nombre de processos que s'executen sota l'usuari mysql
proc.num[apache2,www-data] #el nombre de processos apache2 que s'executen sota l'usuari www-data
proc.num[,oracle,sleep,oracleZABBIX] #el nombre de processos en estat de repòs que s'executen sota Oracle amb oracleZABBIX a la seva línia d'ordres
Lectura del sensor de maquinari.
Valor de retorn: Flotant.
Plataformes admeses: Linux, OpenBSD.
Paràmetres:
Comentaris:
Exemple:
sensor[w83781d-i2c-0-2d,temp1]
sensor[cpu0,temp0] #la temperatura d'una CPU
sensor["cpu[0-2]$",temp,avg] #la temperatura mitjana de les tres primeres CPUs
Hora d'inici del sistema.
Valor de retorn: Enter (marca de temps Unix).
Plataformes admeses: Linux, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.
Llistat dels nuclis de CPUs/CPU detectats. Emprat per descobertes de baix nivell.
Valor de retorn: objecte JSON.
Veieu les plataformes admeses.
Interrupcions del dispositiu.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.
La càrrega de la CPU.
Valor de retorn: Flotant.
Veieu plataformes compatibles.
Paràmetres:
Exemple:
El nombre de CPU.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.
Paràmetre:
El paràmetre de tipus max només és compatible amb Linux, FreeBSD, Solaris i MacOS X.
Exemple:
Recompte de switxos de context.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.
El percentatge d'ús de la CPU.
Valor de retorn: Flotant.
Plataformes admeses: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.
Paràmetres:
Comentaris:
Exemple:
El nom d'equip del sistema.
Valor de retorn: Cadena.
Veieu plataformes compatibles.
Paràmetres:
El valor s'adquireix prenent "nodename" de la sortida de l'API del sistema uname().
Exemples de valors retornats:
system.hostname → linux-w7x1
system.hostname → exemple.cat
system.hostname[shorthost] → exemple
system.hostname → WIN-SERV2008-I6
system.hostname[host] → Win-Serv2008-I6LonG
system.hostname[host,lower] → win-serv2008-i6long
system.hostname[fqdn,lower] → blog.zabbix.com
Informació del xassís.
Valor de retorn: String.
Plataformes admeses: Linux.
Paràmetre:
Comentaris:
Exemple:
Informació de la CPU.
Valor de retorn: Cadena o Enter.
Plataformes admeses: Linux.
Paràmetres:
Comentaris:
/proc/cpuinfo
i /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq
;Exemple:
Llistat de dispositius PCI o USB.
Valor de retorn: Text.
Plataformes admeses: Linux.
Paràmetre:
Retorna la sortida de la utilitat lspci o lsusb (executa sense cap paràmetre).
Exemple:
Llistat d'adreces MAC.
Valor de retorn: Cadena.
Plataformes admeses: Linux.
Paràmetres:
Comentaris:
interfície
donada (/manual/regular_expressions#overview) (totes llistes per a totes les interfícies);format
com a curt, els noms d'interfície i les adreces MAC idèntiques no apareixen a la llista.Exemple:
Hora del sistema.
Valor de retorn: Enter - amb type
com a utc; Cadena - amb type
com a local.
Veieu plataformes compatibles.
Paràmetres:
S'ha d'emprar només com a comprovació passiva.
Exemple:
system.localtime[local] #creeu un element amb aquesta clau i, a continuació, empreu-lo per mostrar l'hora de l'equip al giny del tauler *Rellotge*.
Executeu l'ordre especificada a l'equip.
Valor de retorn: Text resultat de l'ordre o 1 - amb `mode' com a nowait (independentment del resultat de l'ordre).
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
text
. També es permet un resultat buit;Exemple:
Estadístiques del sistema.
Valor de retorn: Enter o flotant.
Plataformes admeses: AIX.
Paràmetres:
Comentaris:
system.stat[cpu,app]
- només és compatible amb AIX LPAR de tipus "Compartit"system.stat[cpu,ec]
- compatible amb AIX LPAR de tipus "Compartit" i "Dedicat" ("Dedicat" sempre retorna 100 (per cent))system.stat[cpu,lbusy]
- només és compatible amb AIX LPAR de tipus "Compartit"system.stat[cpu,pc]
- compatible amb AIX LPAR de tipus "Compartit" i "Dedicat"system.stat[ent]
- compatible amb AIX LPAR de tipus "Compartit" i "Dedicat"
Informació de l'arquitectura del programari.
Valor de retorn: Cadena.
Veieu plataformes compatibles.
La informació s'obté de la funció uname()
.
Exemple:
Informació del sistema operatiu.
Valor de retorn: Cadena.
Plataformes admeses: Linux, Windows.
Paràmetre:
La informació s'obté de (tingueu en compte que no tots els fitxers i opcions són presents a totes les distribucions):
/proc/version
(complet) a Linux;/proc/version_signature
(curt) a Linux;/etc/os-release
a sistemes Linux que el suporten o /etc/issue.net
(nom);HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion
a Windows.Exemples:
system.sw.os[short] → Ubuntu 2.6.35-28.50-generic 2.6.35.11
system.sw.os[full] → [s|Windows 10 Enterprise 22621.1.asd64fre.ni_release.220506-1250 Build 22621.963]
Informació detallada sobre el sistema operatiu (versió, tipus, nom de distribució, versió menor i major, etc.).
Valor de retorn: objecte JSON.
Plataformes admeses: Linux, Windows.
Llistat dels paquets instal·lats.
Valor de retorn: Text.
Plataformes admeses: Linux.
Paràmetres:
Comentaris:
format
s'especifica com a sencer, els paquets s'agrupen per gestors de paquets (cada gestor en una línia separada que comença amb el seu nom entre claudàtors);format
s'especifica com a curt, els paquets no s'agrupen i es mostren en una sola línia.Exemple:
Llistat detallat dels paquets instal·lats.
Valor de retorn: objecte JSON.
Plataformes admeses: Linux.
Paràmetres:
Comentaris:
Estadístiques d'intercanvi (del dispositiu a la memòria).
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, OpenBSD.
Paràmetres:
Comentaris:
Exemple:
Estadístiques d'intercanvi (de la memòria cap al dispositiu).
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, OpenBSD.
Paràmetres:
Comentaris:
/proc/swap
, /proc/partitions
, /proc/stat
(Linux 2.4)/proc/swaps
, /proc/diskstats
, /proc/vmstat
(Linux 2.6)Exemple:
Mida de l'espai d'intercanvi en octets o percentatge del total.
Valor de retorn: Enter - per a octets; Flotant - per percentatge.
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, OpenBSD.
Paràmetres:
Comentaris:
swap -s
inclou una part de la memòria física i els dispositius d'intercanvi (a diferència de swap -l
).Exemple:
Identificació del sistema.
Valor de retorn: Cadena.
Veieu plataformes compatibles.
Comentaris:
Exemple (UNIX):
Temps de funcionament del sistema en segons.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD.
A configuració de l'element, empreu unitats s o uptime per obtindre valors llegibles.|
Nombre d'usuaris que han iniciat sessió.
Valor de retorn: Enter.
Veieu plataformes compatibles.
L'ordre who s'empra al costat de l'agent per obtenir el valor.
Llistat dels dispositius bloquejats i el seu tipus. Emprat per descobertes de baix nivell.
Valor de retorn: objecte JSON.
Plataformes admeses: Linux.
Estadístiques de lectura de disc.
Valor de retorn: Enter - amb tipus
a sectors, operacions, octets; flotant: amb tipus
a sps, ops, bps.
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, OpenBSD.
Paràmetres:
Comentaris:
mode
només és compatible amb Linux, FreeBSD;sda
) així com un prefix opcional /dev/ (per exemple, /dev/sda
);Exemple:
Estadístiques d'escriptura a disc.
Valor de retorn: Enter - amb tipus
a sectors, operacions, octets; flotant: amb tipus
a sps, ops, bps.
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, OpenBSD.
Paràmetres:
Comentaris:
mode
només és compatible amb Linux, FreeBSD;sda
) així com un prefix opcional /dev/ (per exemple, /dev/sda
);Exemple:
Recompte d'entrades del directori.
Valor de retorn: Enter.
Veieu plataformes compatibles.
Paràmetres:
types incl
) NO es comptabilitzen. Si algun tipus d'entrada és tant en types incl
com en types excl
, les entrades de directori d'aquest tipus NO es compten.Comentaris:
max depth
no estan establerts, aleshores es recorreran tots els subdirectoris, però només es comptaran els fitxers de tipus zip).<min_size>
i <max_size>
, és recomanable especificar <types_incl>
com a "fitxer", per evitar sorpreses.Exemples:
Llistat d'entrades del directori.
Valor de retorn: objecte JSON.
Veieu plataformes compatibles.
Paràmetres:
types incl
) a la llista NO. Si algun tipus d'entrada és tant en types incl
com en types excl
, les entrades de directori d'aquest tipus NO apareixen a la llista.Comentaris:
regex incl
com regex excl
s'apliquen als fitxers i directoris en generar la llista d'entrades, però s'ignoren quan es trien subdirectoris per recórrer (si regex incl
és “(?i)^.+\ .zip$” i max depth
no estan establerts, aleshores es recorreran tots els subdirectoris, però només es comptaran els fitxers de tipus zip).mida mínima
i mida màxima
, és recomanable especificar tipus incl
com a "fitxer", per evitar sorpreses.Exemples:
Mida del directori (en octets).
Valor de retorn: Enter.
Plataformes admeses: Linux. L'element pot funcionar en altres plataformes semblants a UNIX.
Paràmetres:
du -sb dir
), disk - obté l'ús del disc (actua com a du -s -B1 dir
). A diferència de l'ordre du
, l'element vfs.dir.size té en compte els fitxers ocults quan es calcula la mida del directori (actua com du -sb .[^.]* *
dins de dir).Comentaris:
Exemples:
vfs.dir.size[/tmp,log] #calcula la mida de tots els fitxers a /tmp que contenen 'log' en els seus noms
vfs.dir.size[/tmp,log,^.+\.old$] #calcula la mida de tots els fitxers de /tmp que contenen 'log' en els seus noms, excloent els fitxers amb noms que acaben en '.old'
Suma de comprovació del fitxer, calculada per l'algoritme cksum de UNIX.
Valor de retorn: Enter - amb mode
com a crc32, String - amb mode
com a md5, sha256.
Veieu plataformes admeses.
Paràmetres:
El límit de mida del fitxer depèn de suport per a fitxers grans.
Exemple:
Exemple de valors retornats (crc32/md5/sha256 respectivament):
675436101
9845acf68b73991eb7fd7ee0ded23c44
ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc
Recupera el contingut d'un fitxer7.
Valor de retorn: Text.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
Exemple:
Comprova si el fitxer existeix.
Valor de retorn: 0 - no trobat; 1: existeix un fitxer del tipus especificat.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
Exemples:
vfs.file.exists[/tmp/application.pid]
vfs.file.exists[/tmp/application.pid,"file,dir,sym"]
vfs.file.exists[/tmp/application_dir,dir]
Retorna informació sobre un fitxer.
Valor de retorn: objecte JSON.
Veieu plataformes compatibles.
Paràmetre:
Comentaris:
Exemple:
vfs.file.get[/etc/passwd] #retorna un JSON amb informació sobre el fitxer /etc/passwd (tipus, usuari, permisos, SID, uid, etc.)
Suma de comprovació MD5 del fitxer.
Valor de retorn: cadena de caràcters (hash MD5 del fitxer).
Veieu plataformes compatibles.
Paràmetre:
El límit de mida del fitxer depèn de suport per a fitxers grans.
Exemple:
Exemple de valor retornat:
Recupera el propietari d'un fitxer.
Valor de retorn: Cadena.
Veieu plataformes compatibles.
Paràmetres:
El límit de mida del fitxer depèn de suport per a fitxers grans.
Exemple:
vfs.file.owner[/tmp/zabbix_server.log] #return the file owner of /tmp/zabbix_server.log
vfs.file.owner[/tmp/zabbix_server.log,,id] #return the file owner ID of /tmp/zabbix_server.log
Retorna una cadena de 4 dígits que conté el nombre octal amb permisos UNIX.
Valor de retorn: Cadena.
Plataformes admeses: Linux. L'element pot funcionar en altres plataformes semblants a UNIX.
Paràmetres:
El límit de mida del fitxer depèn de suport per a fitxers grans.
Exemple:
Recupera una cadena al fitxer7.
Valor de retorn: la línia que conté la cadena coincident, o tal com s'especifica pel paràmetre opcional output
.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
output
té lloc a l'agent.Exemples:
vfs.file.regexp[/etc/passwd,zabbix]
vfs.file.regexp[/path/to/some/file,"([0-9]+)$",,3,5,\1]
vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] → obtenció de l'ID de l'usuari *zabbix*
Cerca una cadena al fitxer7.
Valors de retorn: 0 - no s'ha trobat la coincidència; 1 - trobat.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
Exemple:
Mida del fitxer (en octets).
Valor de retorn: Enter.
Vegeu plataformes compatibles.
Paràmetres:
Comentaris:
Exemple:
Informació de l'hora del fitxer.
Valor de retorn: Enter (marca de temps Unix).
Veieu plataformes compatibles.
Paràmetres:
El límit de mida del fitxer depèn de suport per a fitxers grans.
Exemple:
Llistat de sistemes de fitxers muntats amb el seu tipus i opcions de muntatge. S'empra per a la descoberta de baix nivell.
Valor de retorn: objecte JSON.
Plataformes admeses: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.
Llistat de sistemes de fitxers muntats amb el seu tipus, espai disponible en disc, estadístiques d'inode i opcions de muntatge. Es pot emprar per a la descoberta de baix nivell.
Valor de retorn: objecte JSON.
Plataformes admeses: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.
Comentaris:
Nombre o percentatge d'inodes.
Valor de retorn: Enter - per al nombre; Flotant - per percentatge.
Veieu plataformes compatibles.
Paràmetres:
Si el recompte d'inodes és igual a zero, cosa que pot ser el cas dels sistemes de fitxers amb inodes dinàmics (per exemple, btrfs), els valors pfree/pused s'informaran com a "100" i "0" respectivament.
Exemple:
Espai de disc en octets o en percentatge del total.
Valor de retorn: Enter - per a octets; Flotant - per percentatge.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
Exemple:
La mida de la memòria en octets o en percentatge del total.
Valor de retorn: Enter - per a octets; Flotant - per percentatge.
Veieu plataformes compatibles.
Paràmetre:
Comentaris:
Exemple:
Obtindre el contingut d'una pàgina web.
Valor de retorn: font de la pàgina web com a text (incloses les capçaleres).
Veieu plataformes compatibles.
Paràmetres:
scheme://host:port/path
, on només equip és obligatori). Esquemes d'URL permesos: http, https4. Un esquema que manqui es tractarà com a http. Si s'especifica un URL, camí
i port
han de ser buits. Especificar el nom d'usuari/mot de pas quan es connecta a servidors que requereixen autenticació, per exemple: http://usuari:[email protected]
només és possible amb el suport de cURL 4 . Punycode és compatible amb els noms d'equip.Comentaris:
equip
pot ser un nom d'equip, un nom de domini, una adreça IPv4 o IPv6. Però per a l'adreça IPv6, l'agent Zabbix s'ha de compilar amb el suport IPv6 habilitat.Exemple:
web.page.get[www.exemple.cat,index.php,80]
web.page.get[https://www.exemple.cat]
web.page.get[https://blog.exemple.cat/?s=zabbix]
web.page.get[localhost:80]
web.page.get["[::1]/server-status"]
El temps de càrrega d'una pàgina web completa (en segons).
Valor de retorn: Flotant.
Veieu plataformes compatibles.
Paràmetres:
scheme://host:port/path
, on només equip és obligatori). Esquemes d'URL permesos: http, https4. Un esquema que manqui es tractarà com a http. Si s'especifica un URL, camí
i port
han d'estar buits. Especificar el nom d'usuari/mot de pas quan es connecta a servidors que requereixen autenticació, per exemple: http://usuari:[email protected]
només és possible amb el suport de cURL 4 . Punycode és compatible amb els noms d'equip.Comentaris:
Exemple:
Cerca una cadena a la pàgina web.
Valor de retorn: la cadena coincident, o tal com s'especifica pel paràmetre opcional output
.
Veieu plataformes compatibles.
Paràmetres:
scheme://host:port/path
, on només equip és obligatori). Esquemes d'URL permesos: http, https4. Un esquema que manqui es tractarà com a http. Si s'especifica un URL, camí
i port
han de ser buits. Especificar el nom d'usuari/mot de pas quan es connecta a servidors que requereixen autenticació, per exemple: http://usuari:[email protected]
només és possible amb el suport de cURL 4 . Punycode és compatible amb els noms d'equip.Comentaris:
output
té lloc a l'agent.Exemple:
Metadades de l'equip de l'agent.
Valor de retorn: Cadena.
Veieu plataformes compatibles.
Retorna el valor dels paràmetres HostMetadata o HostMetadataItem, o una cadena buida si no n'hi ha cap definit.
Nom d'equip de l'agent.
Valor de retorn: Cadena.
Veieu plataformes compatibles.
Devolucions:
Comprovació de la disponibilitat de l'agent.
Valor de retorn: Res - no disponible; 1 - disponible.
Veieu plataformes compatibles.
Empreu la funció trigger nodata() per comprovar la indisponibilitat de l'equip.
Variant de l'agent Zabbix (agent Zabbix o agent Zabbix 2).
Valor de retorn: 1 - agent Zabbix; 2 - Agent Zabbix 2.
Veieu plataformes compatibles.
Versió de l'agent Zabbix.
Valor de retorn: String.
Veieu plataformes compatibles.
Exemple de valor retornat:
Retorna un conjunt de mètriques internes del servidor Zabbix o del proxy de forma remota.
Valor de retorn: objecte JSON.
Veieu plataformes compatibles.
Paràmetres:
Comentaris:
Retorna el nombre d'elements monitorats a la cua que s'endarrereixen al servidor Zabbix o al proxy de forma remota.
Valor de retorn: objecte JSON.
Veieu plataformes compatibles.
Paràmetres:
Tingueu en compte que la petició d'estadístiques només s'admetrà des de les adreces que figuren al paràmetre 'StatsAllowedIP' servidor/proxy a la instància destí.
^1^Una nota específica de Linux. L'agent Zabbix ha de tindre accés només de lectura al sistema de fitxers /proc*. Els pedaços del nucli de www.grsecurity.org limiten l'accés dels usuaris no privilegiats.
2 vfs.dev.read[]
, vfs.dev.write[]
: l'agent de Zabbix tancarà connexions de dispositius "obsoletes" si no s'accedeix als valors de l'element per a més de 3 hores. Això pot passar si un sistema té dispositius amb dinàmica canviant els camins o si un dispositiu s'esborra manualment. Tingueu en compte també que aquests elements, si s'empren un interval d'actualització de 3 hores o més, sempre ho retornaran '0'.
3 vfs.dev.read[]
, vfs.dev.write[]
: si s'empra all per defecte al primer paràmetre, la clau retornarà estadístiques de resum, incloent tots els dispositius de bloc com sda, sdb i les seves particions (sda1, sda2, sdb3...) i diversos dispositius (MD raid) basats en aquests dispositius/particions i volums lògics (LVM) basats en aquests dispositius/particions. En aquests casos, s'ha de tindre en compte els valors retornats només com a valor relatiu (dinàmic en el temps) però no com a valors absoluts.
4 SSL (HTTPS) només és compatible si l'agent es compila amb suport de cURL. En cas contrari, l'element no serà compatible.
5 Els valors octets
i errors
no s'admeten per a les interfícies de bucle invers als sistemes Solaris fins a Solaris 10 6/06 inclòs, ja que les estadístiques d'octets, errors i ús no s'emmagatzemen ni informen al nucli. Tanmateix, si sou monitorant un sistema Solaris mitjançant net-snmp, es poden retornar valors, ja que net-snmp porta codi heretat del cmu-snmp datat de l'any 1997 que, en no llegir els valors en octets de les estadístiques de la interfície, retorna el comptador de paquets (que existeix a les interfícies de loopback) multiplicat per un valor arbitrari de 308. Això suposa que l'allargada mitjana d'un paquet és de 308 octets, la qual cosa és una estimació molt aproximada ja que el límit de MTU en sistemes Solaris per a interfícies de bucle és 8892 octets. No s'ha de suposar que aquests valors són correctes ni tan sols exactes: són estimats. L'agent Zabbix no fa cap feina d'endevinar, però net-snmp retornarà un valor per a aquests camps.
6 La línia d'ordres de Solaris, obtinguda de /proc/pid/psinfo, és limitada a 80 octets i conté la línia d'ordres tal com era quan es va iniciar el procés.
7 Els elements vfs.file.contents[]
, vfs.file.regexp[]
, vfs.file.regmatch[]
es poden emprar per recuperar el contingut del fitxer. Si voleu restringir l'accés a fitxers específics amb informació sensible, executeu l'agent Zabbix amb un usuari que no tingui permisos d'accés per veure aquests fitxers.
Tingueu en compte que quan feu proves o empreu claus d'element amb zabbix_agentd o zabbix_get des de la línia de comandes també hauríeu de tindre en compte la sintaxi de l'intèrpret d'ordres.
Per exemple, si un paràmetre determinat de la clau s'ha de tancar entre cometes dobles, heu d'escapar explícitament de cometes dobles; en cas contrari, seran retallades per l'intèrpret d'ordres com a caràcters especials i no es passaran pas a la utilitat Zabbix. Exemples:
zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'
zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]
Per assegurar-vos que les dades adquirides no siguin malmeses, podeu especificar la codificació correcta per al processament de verificació (per exemple, "vfs.file.contents") al paràmetre "encoding". La llista de codificacions admeses (identificadors de pàgines de codi) es pot trobar a la documentació de libiconv (Projecte GNU) o a la documentació de l'SDK de Microsoft Windows per a "Codi Identificadors de pàgina".
Si no s'especifica cap codificació al paràmetre "codificació", s'apliquen les estratègies de resolució següents:
En cas de comprovacions passives, per evitar que aquest element no obtingui cap valor perquè la petició del servidor a l'agent s'espera primer, cal tindre en compte el següent:
Timeout
a l'agent fitxer de configuració.Timeout
del servidor fitxer de configuració hagi de ser superior al valor Timeout
de l'agent configuració fitxer.