1 Agent Zabbix

Vista general

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:

• Agent Zabbix - per a comprovacions passives
• Agent Zabbix (actiu) - per a comprovacions actives

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.

Claus d'elements admeses

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.

Plataformes compatibles

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:

• Linux
• FreeBSD
• Solaris
• HP-UX
• AIX
• Tru64
• MacOS X
• OpenBSD
• NetBSD

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ó.

Detalls clau de l'article

Els paràmetres sense claudàtors angulars són obligatoris. Els paràmetres marcats amb claudàtors angulars < > són opcionals.

kernel.maxfiles

El nombre màxim de fitxers oberts compatibles amb el sistema operatiu.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.

kernel.maxproc

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.

kernel.openfiles

Nombre de descriptors de fitxers oberts actualment.
Valor de retorn: Enter.
Plataformes admeses: Linux (l'element pot funcionar en altres plataformes semblants a UNIX).

log[file,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>]

El seguiment d'un fitxer de registre.
Valor de retorn: Log.
Veieu plataformes compatibles.

Paràmetres:

• fitxer - camí complet i el nom d'un fitxer de registre;
  
• regexp - una expressió que descriu el patró necessari;
  
• encoding - pàgina de codis identificador;
  
• maxlines - nombre màxim de línies noves per segon que l'agent enviarà al servidor o proxy Zabbix. Aquest paràmetre anul·la el valor de 'MaxLinesPerSecond' a zabbix_agentd.conf;
  
• mode - valors possibles: all (per defecte) o skip - omet el processament de dades més antigues (afecta només els elements de creació recent);
  
• sortida - una plantilla de format de sortida opcional. La seqüència d'escapada \0 es substitueix per la part del text coincident (des del primer caràcter on comença la coincidència fins al caràcter on acaba la coincidència), mentre que un \N (on N=1... 9) la seqüència d'escapada es substitueix per N grup coincident (o una cadena buida si la N supera el nombre de grups capturats).
  
• maxdelay - endarreriment màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) mai ignoreu les línies del fitxer de registre; > 0.0: ignora les línies més antigues per analitzar les línies més recents en "maxdelay" segons. Llegeix les notes de maxdelay abans d'utilitzar-lo!
  
• opcions - opcions addicionals:
  mtime-noreread - registres no únics, rellegit només si la mida del fitxer canvia (ignora el canvi d'hora de modificació). (Aquest paràmetre és obsolet des de la 5.0.2, perquè ara s'ignora mtime.)
  
• director persistent (només a zabbix_agentd en sistemes Unix; no és compatible amb l'agent Zabbix 2) - la ruta absoluta del directori on s'emmagatzemen els fitxers persistents. Veieu també notes addicionals sobre fitxers persistents.

Comentaris:

• L'element s'ha de configurar com a comprovació activa;
• Si manca el fitxer o els permisos no permeten l'accés, l'element no s'admet;
• Si 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.
• L'extracció de contingut mitjançant el paràmetre output té lloc a l'agent.

Exemples:

 log[/var/log/syslog]
        log[/var/log/syslog,error]
        log[/home/zabbix/logs/logfile,,,100]

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.

log.count[file,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]

El recompte de línies coincidents en un fitxer de registre monitorat.
Valor de retorn: Enter.
Veieu plataformes compatibles.

Paràmetres:

• fitxer - camí complet i el nom del fitxer de registre;
  
• regexp - una expressió que descriu el patró necessari;
  
• encoding - pàgina de codis identificador;
  
• maxproclines - nombre màxim de línies noves per segon que analitzarà l'agent (no pot superar les 10.000). El valor predeterminat és 10*'MaxLinesPerSecond' a zabbix_agentd.conf.
  
• mode - valors possibles: all (predeterminat) o skip - saltar el processament de dades més antigues (afecta només els elements de nova creació).
  
• maxdelay: endarreriment màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) mai ignoreu les línies del fitxer de registre; > 0.0: ignora les línies més antigues per analitzar les línies més recents en "maxdelay" segons. Llegeix les notes de maxdelay abans d'emprar-lo!
  
• opcions - opcions addicionals:
  mtime-noreread - registres no únics, rellegit només si la mida del fitxer canvia (ignora el canvi d'hora de modificació). (Aquest paràmetre és obsolet des de la 5.0.2, perquè ara s'ignora mtime.)
  
• director persistent (només a zabbix_agentd en sistemes Unix; no és compatible amb l'agent Zabbix 2) - la ruta absoluta del directori on s'emmagatzemen els fitxers persistents. Veieu també notes addicionals sobre fitxers persistents.

Comentaris:

• L'element s'ha de configurar com a comprovació activa;
• Les línies coincidents es compten a les noves línies des de la darrera comprovació del registre per part de l'agent i, per tant, depenen de l'interval d'actualització de l'element;
• Si falta el fitxer o els permisos no permeten l'accés, l'element no s'admet.

logrt[file regexp,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>]

El seguiment d'un fitxer de registre que es gira.
Valor de retorn: Log.
Veieu plataformes compatibles.

Paràmetres:

• file regexp - camí absolut al fitxer i el nom del fitxer descrit per una [expression] regular (/manual/regular_expressions#overview). Tingueu en compte que només el nom del fitxer és una expressió regular.
  
• regexp - una expressió que descriu el patró de contingut necessari;
  
• encoding - pàgina de codis identificador;
  
• maxlines: nombre màxim de línies noves per segon que l'agent enviarà al servidor o proxy Zabbix. Aquest paràmetre anul·la el valor de "MaxLinesPerSecond" a zabbix_agentd.conf.
  
• mode - valors possibles: all (predeterminat) o skip - saltar el processament de dades més antigues (afecta només els elements de nova creació).
  
• sortida - una plantilla de format de sortida opcional. La seqüència d'escapada \0 es substitueix per la part del text coincident (des del primer caràcter on comença la coincidència fins al caràcter on acaba la coincidència), mentre que un \N (on N=1... 9) la seqüència d'escapada es substitueix per Nè grup coincident (o una cadena buida si la N supera el nombre de grups capturats).
  
• maxdelay - endarreriment màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) mai ignoreu les línies del fitxer de registre; > 0.0: ignora les línies més antigues per analitzar les línies més recents en "maxdelay" segons. Llegeix les notes de maxdelay abans d'emprar-lo!
  
• opcions - el tipus de rotació del fitxer de registre i altres opcions. Valors possibles:
  rotate (per defecte),
  copytruncate: tingueu en compte que copytruncate no es pot emprar juntament amb maxdelay. En aquest cas, maxdelay ha de ser 0 o no especificat; veieu copytruncate notes,
  mtime-reread - registres no únics, rellegiu si el temps de modificació o la mida canvia (per defecte),
  mtime-noreread - registres no únics, tornar a llegir només si la mida canvia (ignora el canvi d'hora de modificació).
  
• director persistent (només a zabbix_agentd en sistemes Unix; no és compatible amb l'agent Zabbix 2) - la ruta absoluta del directori on s'emmagatzemen els fitxers persistents. Veieu també notes addicionals sobre fitxers persistents.

Comentaris:

• L'element s'ha de configurar com a comprovació activa;
• La rotació del registre es basa en la darrera modificació dels fitxers;
• Tingueu en compte que logrt és dissenyat per funcionar amb un fitxer de registre actiu actualment, amb diversos altres fitxers inactius coincidents girats. Si, per exemple, un directori té molts fitxers de registre actius, s'hauria de crear un element de registre separat per a cadascun. En cas contrari, si un ítem de logrt recull massa fitxers, pot ser que s'esgoti la memòria i s'interrompi el monitoratge.
• Si 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.
• L'extracció de contingut mitjançant el paràmetre 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.|

logrt.count[file regexp,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]

El recompte de línies coincidents en un fitxer de registre monitorat que rota.
Valor de retorn: Enter.
Veieu plataformes compatibles.

Paràmetres:

• file regexp - camí absolut al fitxer i [expressió] regular (/manual/regular_expressions#overview) que descriu el patró del nom del fitxer;
  
• regexp - una expressió que descriu el patró necessari;
  
• encoding - pàgina de codis identificador;
  
• maxproclines - el nombre màxim de línies noves per segon que analitzarà l'agent (no pot superar les 10.000). El valor predeterminat és 10*'MaxLinesPerSecond' a zabbix_agentd.conf.
  
• mode - valors possibles: all (predeterminat) o skip - saltar el processament de dades més antigues (afecta només els elements de nova creació).
  
• maxdelay - endarreriment màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) mai ignoreu les línies del fitxer de registre; > 0.0: ignora les línies més antigues per analitzar les línies més recents en "maxdelay" segons. Llegeix les notes de maxdelay abans d'emprar-lo!
  
• opcions - tipus de rotació del fitxer de registre i altres opcions. Valors possibles:
  rotate (per defecte),
  copytruncate: tingueu en compte que copytruncate no es pot emprar juntament amb maxdelay. En aquest cas, maxdelay ha de ser 0 o no especificat; veieu copytruncate notes,
  mtime-reread - registres no únics, rellegiu si el temps de modificació o la mida canvia (per defecte),
  mtime-noreread - registres no únics, tornar a llegir només si la mida canvia (ignora el canvi d'hora de modificació).
  
• director persistent (només a zabbix_agentd en sistemes Unix; no és compatible amb l'agent Zabbix 2) - la ruta absoluta del directori on s'emmagatzemen els fitxers persistents. Veieu també notes addicionals sobre fitxers persistents.

Comentaris:

• L'element s'ha de configurar com a comprovació activa;
• Les línies coincidents es compten a les noves línies des de la darrera comprovació del registre per part de l'agent i, per tant, depenen de l'interval d'actualització de l'element;
• La rotació del registre es basa en la darrera modificació dels fitxers.

modbus.get[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>]

Llegeix dades Modbus.
Valor de retorn: objecte JSON.
Plataformes admeses: Linux.

Paràmetres:

• punt final - punt final definit com a protocol://cadena_connexió;
  
• identificador de l'esclau - identificador de l'esclau;
  
• funció - funció Modbus;
  
• adreça - adreça del primer registre, bobina o entrada;
  
• compte - nombre de registres a llegir;
  
• tipus: tipus de dades;
  
• endianness - configuració de l'endianness;
  
• offset - nombre de registres, començant per 'adreça', els resultats dels quals es descartaran.

Veieu una descripció detallada dels paràmetres.

net.dns[<ip>,name,<type>,<timeout>,<count>,<protocol>]

Comprova si el servei DNS és activat.
Valors de retorn: 0: el DNS és inactiu (el servidor no ha respost o la resolució del DNS ha fallat); 1 - El DNS està activat.
Veieu plataformes compatibles.

Paràmetres:

• ip - adreça IP del servidor DNS (deixeu buit per al servidor DNS predeterminat, ignorat a Windows tret que empreu l'agent Zabbix 2);
• nom - nom DNS a consultar;
• tipus - tipus de registre que s'ha de consultar (el valor per defecte és SOA);
• timeout (ignorat a Windows tret que empreu l'agent Zabbix 2) - temps d'espera de la petició en segons (per defecte és 1 segon);
• compte (ignorat a Windows tret que s'empri l'agent Zabbix 2) - el nombre d'intents de la petició (el valor per defecte és 2);
• protocol - el protocol emprat per realitzar consultes DNS: udp (per defecte) o tcp.

Comentaris:

• Els valors possibles per a "tipus" 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, SRV
• No s'admeten els noms de domini internacionalitzats, si us plau, empreu noms codificats amb IDNA.

Exemple:

net.dns[198.51.100.1,exemple.cat,MX,2,1]

net.dns.record[<ip>,name,<type>,<timeout>,<count>,<protocol>]

Fa una consulta DNS.
Valor de retorn: una cadena de caràcters amb el tipus d'informació requerit.
Veieu plataformes compatibles.

Paràmetres:

• ip - adreça IP del servidor DNS (deixeu buit per al servidor DNS predeterminat, ignorat a Windows tret que empreu l'agent Zabbix 2);
• nom - nom DNS a consultar;
• tipus - tipus de registre que s'ha de consultar (el valor per defecte és SOA);
• timeout (ignorat a Windows tret que empreu l'agent Zabbix 2) - temps d'espera de la petició en segons (per defecte és 1 segon);
• compte (ignorat a Windows tret que s'empri l'agent Zabbix 2) - nombre d'intents de la petició (el valor per defecte és 2);
• protocol - protocol emprat per realitzar consultes DNS: udp (per defecte) o tcp.

Comentaris:

• Els valors possibles per a 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, SRV
• No s'admeten els noms de domini internacionalitzats, si us plau, empreu noms codificats amb IDNA.

Exemple:

net.dns.record[198.51.100.1,exemple.cat,MX,2,1]

net.if.collisions[if]

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:

• if - nom de la interfície de xarxa

net.if.discovery

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.

net.if.in[if,<mode>]

Estadístiques de trànsit entrant en una interfície de xarxa.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Els privilegis d'arrel són necessaris a NetBSD.

Paràmetres:

• if - nom de la interfície de xarxa (Unix); descripció completa de la interfície de xarxa o adreça IPv4; o, si és entre claus, GUID de la interfície de xarxa (Windows);
• mode - valors possibles:
  octets - nombre d'octets (per defecte)
  paquets - nombre de paquets
  errors - nombre d'errors
  esborrat - nombre de paquets abandonats
  sobrepasses (fifo) - el nombre d'errors de memòria intermèdia FIFO
  frame - el nombre d'errors d'enquadrament de paquets
  comprimit - el nombre de paquets comprimits rebuts pel controlador del dispositiu
  multicast - el nombre de fotogrames de multidifusió rebudes pel controlador del dispositiu

Comentaris:

• Podeu emprar aquesta clau amb la passa de preprocessament Canvi per segon per obtenir les estadístiques d'octets per segon;
• El mode dropped només és compatible amb Linux, FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD;
• Els modes overruns, frame, compressed, multicast només són compatibles amb Linux;
• A l'HP-UX, aquest element no proporciona detalls sobre les interfícies de loopback (per exemple, lo0).

Exemples:

net.if.in[eth0]
       net.if.in[eth0,errors]

net.if.out[if,<mode>]

Estadístiques de trànsit de sortida en una interfície de xarxa.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Els privilegis d'arrel són necessaris a NetBSD.

Paràmetres:

• if - nom de la interfície de xarxa (Unix); descripció completa de la interfície de xarxa o adreça IPv4; o, si és entre claus, GUID de la interfície de xarxa (Windows);
• mode - valors possibles:
  octets - nombre d'octets (per defecte)
  paquets - nombre de paquets
  errors - nombre d'errors
  esborrat - nombre de paquets deixats caigut
  desbordaments (fifo) - el nombre d'errors de memòria intermèdia FIFO
  col·lisions (colls) - el nombre de col·lisions detectades a la interfície
  portador - el nombre de pèrdues de transportista detectat pel controlador del dispositiu
  comprimit - el nombre de paquets comprimits transmesos pel controlador del dispositiu

Comentaris:

• Podeu emprar aquesta clau amb la passa de preprocessament Canvi per segon per obtenir les estadístiques d'octets per segon;
• El mode dropped només és compatible amb Linux, HP-UX;
• Els modes desbordaments, col·lisió, portador, comprimit només són compatibles amb Linux;
• A l'HP-UX, aquest element no proporciona detalls sobre les interfícies de loopback (per exemple, lo0).

Exemples:

net.if.out[eth0]
       net.if.out[eth0,errors]

net.if.total[if,<mode>]

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, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Els privilegis d'arrel són necessaris a NetBSD.

Paràmetres:

• if - nom de la interfície de xarxa (Unix); descripció completa de la interfície de xarxa o adreça IPv4; o, si és entre claus, GUID de la interfície de xarxa (Windows);
• mode - valors possibles:
  octets - nombre d'octets (per defecte)
  paquets - nombre de paquets
  errors - nombre d'errors
  eliminat - nombre de paquets abandonats
  desbordaments (fifo) - nombre d'errors de memòria intermèdia FIFO
  col·lisions (colls) - nombre de col·lisions detectades a la interfície
  comprimit - nombre de paquets comprimits transmès o rebut pel controlador del dispositiu

Comentaris:

• Podeu emprar aquesta clau amb la passa de preprocessament Canvi per segon per obtenir les estadístiques d'octets per segon;
• El mode dropped només és compatible amb Linux, HP-UX. Els paquets abandonats només s'admeten si tant "net.if.in" com "net.if.out" funcionen per als paquets abandonats a la vostra plataforma.
• Els modes desbordaments, col·lisió, comprimit només són compatibles amb Linux;
• A l'HP-UX, aquest element no proporciona detalls sobre les interfícies de loopback (per exemple, lo0).

Exemples:

net.if.total[eth0]
       net.if.total[eth0,errors]

net.tcp.listen[port]

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:

• port - Nombre de port TCP

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:

net.tcp.listen[80]

net.tcp.port[<ip>,port]

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:

• ip - adreça IP o el nom DNS (per defecte és 127.0.0.1);
• port - nombre de port.

Comentaris:

• Per a proves de rendiment TCP senzilles, empreu net.tcp.service.perf[tcp,<ip>,<port>];
• Aquestes comprovacions poden donar lloc a missatges addicionals als fitxers de registre del dimoni del sistema (normalment es registren sessions SMTP i SSH).

Exemple:

 net.tcp.port[,80] #aquest element es pot emprar per provar la disponibilitat del servidor web que s'executa al port 80

net.tcp.service[service,<ip>,<port>]

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:

• servei - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https o telnet (veieu detalls);
• ip - adreça IP o el nom DNS (per defecte és 127.0.0.1);
• port - nombre de port (per defecte s'empra el nombre de port de servei estàndard).

Comentaris:

• Aquestes comprovacions poden donar lloc a missatges addicionals als fitxers de registre del dimoni del sistema (normalment es registren sessions SMTP i SSH);
• Actualment no s'admet la comprovació de protocols xifrats (com IMAP al port 993 o POP al port 995). Com a solució alternativa, empreu net.tcp.port[] per a comprovacions com aquestes.
• La comprovació de LDAP i HTTPS a Windows només és compatible amb l'agent Zabbix 2;
• La comprovació de telnet cerca un indicador d'inici de sessió (':' al final).

Exemple:

 net.tcp.service[ftp,,45] #aquest element es pot emprar per provar la disponibilitat del servidor FTP al port TCP 45

net.tcp.service.perf[service,<ip>,<port>]

Comprova el rendiment d'un servei TCP.
Valors de retorn: Flotant (0: el servei és caigut; segons: el nombre de segons que s'han passat en connectar-se al servei).
Veieu plataformes compatibles.

Paràmetres:

• servei - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https o telnet (veieu detalls);
• ip - adreça IP o el nom DNS (per defecte és 127.0.0.1);
• port - nombre de port (per defecte s'empra el nombre de port de servei estàndard).

Comentaris:

• Actualment no s'admet la comprovació de protocols xifrats (com IMAP al port 993 o POP al port 995). Com a solució alternativa, empreu net.tcp.service.perf[tcp,<ip>,<port>] per a comprovacions com aquestes.
• La comprovació de telnet cerca un indicador d'inici de sessió (':' al final).

Exemple:

 net.tcp.service.perf[ssh] #aquest element es pot emprar per provar la velocitat de resposta inicial des del servidor SSH

net.tcp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]

Retorna el nombre de sòcols TCP que coincideixen amb els paràmetres.
Valor de retorn: Enter.
Plataformes admeses: Linux.

Paràmetres:

• laddr - adreça IPv4/6 local o la subxarxa CIDR;
• lport - nombre de port local o el nom del servei;
• raddr: adreça IPv4/6 remota o la subxarxa CIDR;
• rport - nombre de port remot o el nom del servei;
• estat - estat de connexió (established, syn_sent, syn_recv, fin_wait1, fin_wait2, time_wait, close, close_wait, last_ack, listen, closing).

Exemple:

 net.tcp.socket.count[,80,,,established] #nombre de connexions al port TCP local 80 en l'estat establert

net.udp.listen[port]

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:

• port - Nombre de port UDP

Exemple:

net.udp.listen[68]

net.udp.service[service,<ip>,<port>]

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:

• servei - ntp (veieu detalls);
• ip - adreça IP o el nom DNS (per defecte és 127.0.0.1);
• port - nombre de port (per defecte s'empra el nombre de port de servei estàndard).

Exemple:

 net.udp.service[ntp,,45] #aquest element es pot emprar per provar la disponibilitat del servei NTP al port UDP 45

net.udp.service.perf[service,<ip>,<port>]

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:

• servei - ntp (veieu detalls);
• ip - adreça IP o el nom DNS (per defecte és 127.0.0.1);
• port - nombre de port (per defecte s'empra el nombre de port de servei estàndard).

Exemple:

 net.udp.service.perf[ntp] #aquest element es pot emprar per provar el temps de resposta del servei NTP

net.udp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]

Retorna el nombre de sòcols UDPque coincideixen amb els paràmetres.
Valor de retorn: Enter.
Plataformes admeses: Linux.

Paràmetres:

• laddr - adreça IPv4/6 local o la subxarxa CIDR;
• lport - nombre de port local o el nom del servei;
• raddr: adreça IPv4/6 remota o la subxarxa CIDR;
• rport - nombre de port remot o el nom del servei;
• estat - estat de connexió (established, unconn).

Exemple:

 net.udp.socket.count[,,,,established] #retorna el nombre de sockets UDP en estat connectat

proc.cpu.util[<name>,<user>,<type>,<cmdline>,<mode>,<zone>]

Percentatge d'ús de la CPU del procés.
Valor de retorn: Flotant.
Plataformes admeses: Linux, Solaris⁶.

Paràmetres:

• nom - nom del procés (per defecte és tots els processos);
• usuari - nom d'usuari (el valor per defecte és tots els usuaris);
• tipus - tipus d'ús de la CPU: total (per defecte), usuari o sistema;
• cmdline - filtra per línia d'ordres (és una [expressió] regular (/manual/regular_expressions#overview));
• mode - mode de recollida de dades: avg1 (per defecte), avg5 o avg15;
• zona - zona objectiu: actual (per defecte) o tot. Aquest paràmetre només és compatible amb Solaris.

Comentaris:

• El valor retornat es basa en un únic percentatge d'ús del nucli de la CPU. Per exemple, l'ús de la CPU d'un procés que empra completament dos nuclis és del 200%.
• Les dades d'ús de la CPU del procés són recopilades per un col·lector que admet un màxim de 1024 consultes úniques (per nom, usuari i línia d'ordres). Les consultes a les quals no s'ha accedit durant les últimes 24 hores s'eliminen del col·lector.
• Quan s'estableix el paràmetre 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

proc.get[<name>,<user>,<cmdline>,<mode>]

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:

• nom - nom del procés (per defecte tots els processos);
• usuari - nom d'usuari (per defecte tots els usuaris);
• cmdline - filtra per línia d'ordres (és una expressió regular). Aquest paràmetre no és compatible amb Windows; en altres plataformes no s'admet si el mode és configurat com a 'resum'.
• mode - valors possibles:
  procés (per defecte), fil (no compatible amb NetBSD), resum. Veieu una llista de paràmetres de procés retornats per a cada mode i sistema operatiu.

Comentaris:

• Si no es pot recuperar un valor, per exemple, a causa d'un error (procés ja mort, falta de permisos, fallada de la trucada del sistema), es retornarà -1;
• Veieu notes sobre la selecció de processos amb paràmetres 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

proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>]

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, Tru64, OpenBSD, NetBSD.

Paràmetres:

• nom - nom del procés (per defecte és tots els processos);
• usuari - nom d'usuari (el valor per defecte és tots els usuaris);
• mode - valors possibles: mitjana, max, min o sum (per defecte);
• cmdline - filtra per línia d'ordres (és una [expressió] regular (/manual/regular_expressions#overview));
• memtype - tipus de memòria emprada pel procés

Comentaris:

• El paràmetre memtype només és compatible amb Linux, FreeBSD, Solaris⁶, AIX;
• Quan diversos processos empren memòria compartida, la suma de memòria emprada pels processos pot donar lloc a valors grans i poc realistes.
  
  Veieu notes sobre la selecció de processos amb name i paràmetres cmdline (específics de Linux).
  
  Quan aquest element s'invoca des de la línia d'ordres i conté un paràmetre de línia d'ordres (p. ex., emprant el mode de prova de l'agent: 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

proc.num[<name>,<user>,<state>,<cmdline>,<zone>]

Nombre de processos.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris⁶, HP-UX, AIX, Tru64, OpenBSD, NetBSD.

Paràmetres:

• nom - nom del procés (per defecte és tots els processos);
• usuari - nom d'usuari (el valor per defecte és tots els usuaris);
• estat - valors possibles:
  tot (per defecte),
  disc - repòs ininterromput,
  executar - en execució,
  sleep - son interrompible,< br>trace - aturat,
  zomb - zombi;
• cmdline - filtra per línia d'ordres (és una [expressió] regular (/manual/regular_expressions#overview));
• zona - zona objectiu: actual (per defecte), o tot. Aquest paràmetre només és compatible amb Solaris.

Comentaris:

• Els paràmetres d'estat disk i trace només són compatibles amb Linux, FreeBSD, OpenBSD, NetBSD;
• Quan aquest element es crida des de la línia d'ordres i conté un paràmetre de línia d'ordres (per exemple, emprant el mode de prova de l'agent: zabbix_agentd -t proc.num[,,,apache2]), es comptarà un procés addicional, com a agent es comptarà a si mateix;
• Quan s'estableix el paràmetre 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.
• Veieu notes sobre la tria de processos amb paràmetres 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

sensor[device,sensor,<mode>]

Lectura del sensor de maquinari.
Valor de retorn: Flotant.
Plataformes admeses: Linux, OpenBSD.

Paràmetres:

• dispositiu - nom del dispositiu, pot ser una expressió regular si s'omet el mode;
• sensor - nom del sensor, pot ser una expressió regular si s'omet el mode;
• mode - valors possibles: mitjana, max o min (si s'omet aquest paràmetre, el dispositiu i el sensor es tracten textualment).

Comentaris:

• Llegeix /proc/sys/dev/sensors a Linux 2.4;
• Llegeix /sys/class/hwmon a Linux 2.6+. Veieu una descripció més detallada de l'element sensor a Linux.
• Llegeix el hw.sensors MIB a OpenBSD.

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

system.boottime

Hora d'inici del sistema.
Valor de retorn: Enter (marca de temps Unix).
Plataformes admeses: Linux, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

system.cpu.discovery

Llistat dels nuclis de CPUs/CPU detectats. Emprat per descobertes de baix nivell.
Valor de retorn: objecte JSON.
Veieu les plataformes admeses.

system.cpu.intr

Interrupcions del dispositiu.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

system.cpu.load[<cpu>,<mode>]

La càrrega de la CPU.
Valor de retorn: Flotant.
Veieu plataformes compatibles.

Paràmetres:

• cpu - valors possibles: all (per defecte) o percpu (la càrrega total dividida pel recompte de CPU en línia);
• mode - valors possibles: avg1 (mitjana d'un minut, per defecte), avg5 o avg15.

El paràmetre percpu no és compatible amb Tru64.

Exemple:

system.cpu.load[,avg5]

system.cpu.num[<type>]

El nombre de CPU.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.

Paràmetre:

• tipus - valors possibles: en línia (per defecte) o max

El paràmetre de tipus max només és compatible amb Linux, FreeBSD, Solaris i MacOS X.

Exemple:

system.cpu.num

system.cpu.switches

Recompte de switxos de context.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

system.cpu.util[<cpu>,<type>,<mode>,<logical or physical>]

El percentatge d'ús de la CPU.
Valor de retorn: Flotant.
Plataformes admeses: Linux, FreeBSD, Solaris, HP-UX, AIX, Tru64, OpenBSD, NetBSD.

Paràmetres:

• cpu - <nombre de CPU> o tot (per defecte);
• type - valors possibles: usuari (predeterminat), idle, nice, system, iowait, interrupt, softirq, steal, guest (activat Nuclis de Linux 2.6.24 i posteriors), o guest_nice (en nuclis de Linux 2.6.33 i posteriors);
• mode - valors possibles: avg1 (mitjana d'un minut, per defecte), avg5 o avg15;
• lògic o físic - valors possibles: lògic (per defecte) o físic. Aquest paràmetre només és compatible amb AIX.

Comentaris:

• El paràmetre de tipus nice només és compatible amb Linux, FreeBSD, HP-UX, Tru64, OpenBSD, NetBSD.
• El paràmetre de tipus iowait només és compatible amb Linux 2.6 i posteriors, Solaris, AIX.
• El paràmetre de tipus interrupt només és compatible amb Linux 2.6 i posteriors, FreeBSD, OpenBSD.
• Els paràmetres de tipus softirq, steal, guest, guest_nice només són compatibles amb Linux 2.6 i posteriors.
• Els paràmetres de mode avg5 i avg15 són compatibles amb Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.

Exemple:

system.cpu.util[0,user,avg5]

system.hostname[<type>,<transform>]

El nom d'equip del sistema.
Valor de retorn: Cadena.
Veieu plataformes compatibles.

Paràmetres:

• type - valors possibles: netbios (per defecte a Windows), host (per defecte a Linux) o shorthost (des de la versió 5.4.7; retorna part del nom d'equip abans del primer punt, un cadena per a noms sense punts);
• transformar - valors possibles: cap (per defecte) o inferior (convertir a minúscules).

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.hw.chassis[<info>]

Informació del xassís.
Valor de retorn: String.
Plataformes admeses: Linux.

Paràmetre:

• informació - valors possibles: complet (per defecte), model, sèrie, tipus o proveïdor

Comentaris:

• Aquesta clau d'element depèn de la disponibilitat de la taula SMBIOS;
• Intentarà llegir la taula DMI des de sysfs, si l'accés sysfs falla, intenteu llegir directament des de la memòria;
• Es requereixen permisos arrel perquè el valor s'agafi llegint des de sysfs o memòria.

Exemple:

system.hw.chassis[full] → Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop

system.hw.cpu[<cpu>,<info>]

Informació de la CPU.
Valor de retorn: Cadena o Enter.
Plataformes admeses: Linux.

Paràmetres:

• cpu - <nombre de CPU> o tot (per defecte);
• info - valors possibles: tot (per defecte), curfreq, maxfreq, model o vendor.

Comentaris:

• Reuneix informació de /proc/cpuinfo i /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq;
• Si s'especifica un nombre de CPU i curfreq o maxfreq, es retorna un valor numèric (Hz).

Exemple:

system.hw.cpu[0,vendor] → AuthenticAMD

system.hw.devices[<type>]

Llistat de dispositius PCI o USB.
Valor de retorn: Text.
Plataformes admeses: Linux.

Paràmetre:

• tipus - pci (per defecte) o usb

Retorna la sortida de la utilitat lspci o lsusb (executa sense cap paràmetre).

Exemple:

system.hw.devices → 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge

system.hw.macaddr[<interface>,<format>]

Llistat d'adreces MAC.
Valor de retorn: Cadena.
Plataformes admeses: Linux.

Paràmetres:

• interfície - tot (per defecte) o una [expressió] regular (/manual/regular_expressions#overview);
• format - sencer (per defecte) o curt

Comentaris:

• Llista les adreces MAC de les interfícies el nom de les quals coincideix amb l'expressió regular interfície donada (/manual/regular_expressions#overview) (totes llistes per a totes les interfícies);
• Si s'especifica format com a curt, els noms d'interfície i les adreces MAC idèntiques no apareixen a la llista.

Exemple:

system.hw.macaddr["eth0$",full] → [eth0] 00:11:22:33:44:55

system.localtime[<type>]

Hora del sistema.
Valor de retorn: Enter - amb type com a utc; Cadena - amb type com a local.
Veieu plataformes compatibles.

Paràmetres:

• tipus - valors possibles: utc - (per defecte) l'hora des de l'Època (00:00:00 UTC, 1 de gener de 1970), mesurada en segons o local - l'hora en el 'yyyy -mm-dd,hh:mm:ss.nnn,+hh:mm'

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*.

system.run[command,<mode>]

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:

• ordre - ordre per a l'execució;
  
• mode - valors possibles: wait - esperar el final de l'execució (per defecte) o nowait - no esperar.

Comentaris:

• Aquest element és desactivat per defecte. Apreneu a habilitar-los;
• El valor de retorn de l'element és una sortida estàndard juntament amb un error estàndard produït per l'ordre. No es fa pas comprovació del codi de sortida;
• Per processar-se correctament, la sortida de l'ordre ha de ser de tipus text. També es permet un resultat buit;
• El valor de retorn és limitat a 16Mo (incloent els espais en blanc al final truncats); també s'apliquen els límits de la base de dades;
• Veieu també: Execució d'ordres.

Exemple:

 system.run[ls -l /] #retorna una llista detallada de fitxers del directori arrel

system.stat[resource,<type>]

Estadístiques del sistema.
Valor de retorn: Enter o flotant.
Plataformes admeses: AIX.

Paràmetres:

• ent - nombre d'unitats de processador que aquesta partició té dret a rebre (flotant);
• kthr,<tipus> - informació sobre els estats del fil del nucli:
  r - nombre mitjà de fils del nucli que es poden executar (flotant)
  b - nombre mitjà de fils del nucli col·locats a la memòria virtual de la cua d'espera del gestor (flotant)
• memòria,<tipus> - informació sobre l'ús de la memòria virtual i real:
  avm - pàgines virtuals actives (enter)
  fre - mida de la llista lliure (nombre enter)
• pàgina,<tipus> - informació sobre errors de pàgina i activitat de paginació:
  fi - entrades de pàgina per segon (flotant)
  fo - sortides de pàgina per segon (flotant) )
  pi - pàgines entrades des de l'espai de paginació (flotant)
  po - pàgines enviades a l'espai de paginació (flotant)
  fr - pàgines alliberades (substitució de pàgina) (flotant)< br>sr - pàgines escanejades per algorisme de substitució de pàgines (flotant)
• errors,<tipus> - velocitat de trampes i interrupcions:
  in - interrupcions del dispositiu (flotant)
  sy - crides al sistema (flotant)
  cs - context del fil del nucli interruptors (flotant)
• cpu,<tipus> - desglossament del percentatge d'ús del temps del processador:
  us - temps de l'usuari (flotant)
  sy - temps del sistema (flotant)
  id - temps d'inactivitat (flotant)
  wa - temps d'inactivitat durant el qual el sistema tenia peticions pendents d'E/S de disc/NFS (flotant)
  pc - nombre de processadors físics consumits (flotant)<br >ec: el percentatge de la capacitat titular consumida (flotant)
  lbusy - indica el percentatge d'ús de processadors lògics que es va produir durant l'execució a nivell d'usuari i sistema (flotant)
  app - indica els processadors físics disponibles a l'agrupació compartida (flotant)
• disc,<tipus> - estadístiques de disc:
  bps - indica la quantitat de dades transferides (llegida o escrita) a la unitat en octets per segon (nombre enter)
  tps - indica el nombre de transferències per segon que es van emetre al disc/cinta físic (flotant)|

Comentaris:

• Tingueu en compte les limitacions següents en aquests elements:
  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"

system.sw.arch

Informació de l'arquitectura del programari.
Valor de retorn: Cadena.
Veieu plataformes compatibles.

La informació s'obté de la funció uname().

Exemple:

system.sw.arch → i686

system.sw.os[<info>]

Informació del sistema operatiu.
Valor de retorn: Cadena.
Plataformes admeses: Linux, Windows. Compatible amb Windows des de Zabbix 6.4.

Paràmetre:

• informació - valors possibles: complet (per defecte), curt o nom

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;
• el paràmetre PRETTY_NAME de /etc/os-release a sistemes Linux que el suporten o /etc/issue.net (nom);
• la clau de registre 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.amd64fre.ni_release.220506-1250 Build 22621.963]

system.sw.os.get

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. Admès des de Zabbix 6.4.

system.sw.packages[<regexp>,<manager>,<format>]

Llistat dels paquets instal·lats.
Valor de retorn: Text.
Plataformes admeses: Linux.

Paràmetres:

• regexp - tot (per defecte) o una [expressió] regular (/manual/regular_expressions#overview);
• manager - tot (per defecte) o un gestor de paquets;
• format - sencer (per defecte) o curt.

Comentaris:

• Llista (alfabèticament) els paquets instal·lats el nom dels quals coincideix amb l'expressió regular donada (all els enumera tots);
• Gestors de paquets admesos (ordre executada):
  dpkg (dpkg --get-selections)
  pkgtool (ls /var/log/packages)
  rpm (rpm -qa)
  pacman (pacman - Q)
• Si 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);
• Si format s'especifica com a curt, els paquets no s'agrupen i es mostren en una sola línia.

Exemple:

system.sw.packages[mini,dpkg,short] → python-minimal, python2.6-minimal, ubuntu-minimal

system.sw.packages.get[<regexp>,<manager>]

Llistat detallat dels paquets instal·lats.
Valor de retorn: objecte JSON.
Plataformes admeses: Linux. Admès des de Zabbix 6.4.

Paràmetres:

• regexp - tot (per defecte) o una [expressió] regular (/manual/regular_expressions#overview);
• manager - tot (per defecte) o un gestor de paquets (valors possibles: rpm, dpkg, pkgtool o pacman).

Comentaris:

• Retorna JSON sense format amb els paquets instal·lats el nom dels quals coincideix amb l'expressió regular donada;
• La sortida és una matriu d'objectes que conté cadascuna de les claus següents: nom, gestor, versió, mida, arquitectura, temps de construcció i temps d'instal·lació (veieu més detalls).

system.swap.in[<device>,<type>]

Estadístiques d'intercanvi (del dispositiu a la memòria).
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, OpenBSD.

Paràmetres:

• dispositiu - especifiqueu el dispositiu emprat per intercanviar (només Linux) o tot (per defecte);
• tipus - valors possibles: recompte (nombre d'intercanvis, predeterminat en plataformes que no són Linux), sectors (sectors intercanviats) o pàgines (pàgines intercanviades, predeterminada a Linux).

Comentaris:

• La font d'aquesta informació és:
  /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
  /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
• Tingueu en compte que pàgines només funcionarà si no s'ha especificat el dispositiu;
• El paràmetre de tipus sectors només és compatible amb Linux.

Exemple:

system.swap.in[,pages]

system.swap.out[<device>,<type>]

Estadístiques d'intercanvi (de la memòria cap al dispositiu).
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, OpenBSD.

Paràmetres:

• dispositiu - especifiqueu el dispositiu emprat per intercanviar (només Linux) o tot (per defecte);
• tipus - valors possibles: recompte (nombre d'intercanvis, predeterminat en plataformes que no són Linux), sectors (sectors intercanviats) o pàgines (pàgines intercanviades, predeterminada a Linux).

Comentaris:

• La font d'aquesta informació és:
  /proc/swap, /proc/partitions, /proc/stat (Linux 2.4)
  /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
• Tingueu en compte que pàgines només funcionarà si no s'ha especificat el dispositiu;
• El paràmetre de tipus sectors només és compatible amb Linux.

Exemple:

system.swap.out[,pages]

system.swap.size[<device>,<type>]

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, Tru64, OpenBSD.

Paràmetres:

• dispositiu - especifiqueu el dispositiu emprat per a l'intercanvi (només FreeBSD) o tot (per defecte);
• type - valors possibles: free (espai d'intercanvi lliure, per defecte), pfree (espai d'intercanvi lliure, en percentatge), pused (espai d'intercanvi emprat, en percentatge), total (total espai d'intercanvi), o usat (espai d'intercanvi emprat).

Comentaris:

• Tingueu en compte que pfree, pused no són compatibles amb Windows si la mida d'intercanvi és 0;
• Si no s'especifica el dispositiu, l'agent Zabbix només tindrà en compte els dispositius d'intercanvi (fitxers), la memòria física s'ignorarà. Per exemple, als sistemes Solaris, l'ordre swap -s inclou una part de la memòria física i els dispositius d'intercanvi (a diferència de swap -l).

Exemple:

 system.swap.size[,pfree] → percentatge d'espai d'intercanvi lliure

system.uname

Identificació del sistema.
Valor de retorn: Cadena.
Veieu plataformes compatibles.

Comentaris:

• A UNIX el valor d'aquest ítem s'obté amb la crida al sistema uname();
• A Windows l'element retorna l'arquitectura del sistema operatiu, mentre que a UNIX retorna l'arquitectura de la CPU.|

Exemple (UNIX):

 system.uname → FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: Mon Nov i386
        

system.uptime

Temps de funcionament del sistema en segons.
Valor de retorn: Enter.
Plataformes admeses: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. Es desconeix el suport a Tru64.

A configuració de l'element, empreu unitats s o uptime per obtindre valors llegibles.|

system.users.num

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.

vsf.dev.discovery

Llistat dels dispositius bloquejats i el seu tipus. Emprat per descobertes de baix nivell.
Valor de retorn: objecte JSON.
Plataformes admeses: Linux.

vfs.dev.read[<device>,<type>,<mode>]

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:

• dispositiu - dispositiu de disc (el valor per defecte és tot ³);
• tipus - valors possibles: sectors, operacions, octets, sps, ops o bps (sps, ops, bps signifiquen: sectors , operacions, octets per segon, respectivament);
• mode - valors possibles: avg1 (mitjana d'un minut, per defecte), avg5 o avg15. Aquest paràmetre només s'admet amb `type' a: sps, ops, bps.

Comentaris:

• Si s'empra un interval d'actualització de tres hores o més², aquest element sempre retornarà "0";
• Els paràmetres de tipus sectors i sps només són compatibles amb Linux;
• El paràmetre de tipus ops només és compatible amb Linux i FreeBSD;
• El paràmetre de tipus bps només és compatible amb FreeBSD;
• El paràmetre de tipus octets només és compatible amb FreeBSD, Solaris, AIX, OpenBSD;
• El paràmetre mode només és compatible amb Linux, FreeBSD;
• Podeu emprar noms de dispositiu relatius (per exemple, sda) així com un prefix opcional /dev/ (per exemple, /dev/sda);
• Els volums lògics LVM són compatibles;
• Els valors predeterminats del paràmetre "tipus" per a diferents sistemes operatius:
  AIX - operacions
  FreeBSD - bps
  Linux - sps
  OpenBSD - operacions
  Solaris - octets
• sps, ops i bps a les plataformes compatibles està limitat a 1024 dispositius (1023 individuals i un per a tots).

Exemple:

vfs.dev.read[,operations]

vfs.dev.write[<device>,<type>,<mode>]

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:

• dispositiu - dispositiu de disc (el valor per defecte és tot ³);
• tipus - valors possibles: sectors, operacions, octets, sps, ops o bps (sps, ops, bps signifiquen: sectors , operacions, octets per segon, respectivament);
• mode - valors possibles: avg1 (mitjana d'un minut, per defecte), avg5 o avg15. Aquest paràmetre només s'admet amb `type' a: sps, ops, bps.

Comentaris:

• Si s'empra un interval d'actualització de tres hores o més², aquest element sempre tornarà "0";
• Els paràmetres de tipus sectors i sps només són compatibles amb Linux;
• El paràmetre de tipus ops només és compatible amb Linux i FreeBSD;
• El paràmetre de tipus bps només és compatible amb FreeBSD;
• El paràmetre de tipus octets només és compatible amb FreeBSD, Solaris, AIX, OpenBSD;
• El paràmetre mode només és compatible amb Linux, FreeBSD;
• Podeu emprar noms de dispositiu relatius (per exemple, sda) així com un prefix opcional /dev/ (per exemple, /dev/sda);
• Els volums lògics LVM són compatibles;
• Els valors predeterminats del paràmetre "tipus" per a diferents sistemes operatius:
  AIX - operacions
  FreeBSD - bps
  Linux - sps
  OpenBSD - operacions
  Solaris - octets
• sps, ops i bps a les plataformes compatibles està limitat a 1024 dispositius (1023 individuals i un per a tots).

Exemple:

vfs.dev.write[,operations]

vfs.dir.count[dir,<regex incl>,<regex excl>,<types incl>,<types excl>,<max depth>,<min size>,<max size>,<min age>,<max age>,<regex excl dir>]

Recompte d'entrades del directori.
Valor de retorn: Enter.
Veieu plataformes compatibles.

Paràmetres:

• dir - la ruta absoluta al directori;
• regex incl - una expressió que descriu el patró de nom de l'entitat (fitxer, directori, enllaç simbòlic) a incloure; inclou-ho tot si és buit (valor per defecte);
• regex excl - una [expressió] regular (/manual/regular_expressions#overview) que descriu el patró de nom de l'entitat (fitxer, directori, enllaç simbòlic) a excloure; no n'exclou cap si és buit (valor per defecte);
• tipus incl. - tipus d'entrada del directori a comptar, valors possibles: fitxer - fitxer normal, dir - subdirectori, sym - enllaç simbòlic, sock - socket, bdev - dispositiu de bloqueig, cdev - dispositiu de caràcters, fifo - FIFO, dev - sinònim de "bdev,cdev", all - tots els tipus (per defecte), és a dir, "fitxer,dir,sym,sock,bdev,cdev,fifo". S'han de separar diversos tipus amb comes i entre cometes.
• types excl - els tipus d'entrada del directori (veieu 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.
• max depth - la profunditat màxima dels subdirectoris per recórrer:
  -1 (per defecte) - il·limitat,
  0 - sense descendència als subdirectoris.
• mida mínima - la mida mínima (en octets) per comptar el fitxer. Els fitxers més petits no es comptaran. Es poden emprar sufixos de memòria.
• mida màxima - la mida màxima (en octets) del fitxer que s'ha de comptar. Els fitxers més grans no es comptaran. Es poden emprar sufixos de memòria.
• edat mínima - l'edat mínima (en segons) de l'entrada al directori que s'ha de comptar. Les entrades més recents no es comptaran. Es poden emprar sufixos de temps.
• edat màxima - l'edat màxima (en segons) de l'entrada del directori que es comptabilitza. Les entrades tan antigues i més antigues no es comptaran (temps de modificació). Es poden emprar sufixos de temps.
• regex excl dir - una [expressió] regular (/manual/regular_expressions#overview) que descriu el patró de nom del directori a excloure. S'exclourà tot el contingut del directori (a diferència de l'expressió regular_excl)

Comentaris:

• Variables d'entorn, p. %APP_HOME%, $HOME i %TEMP% no són compatibles;
• Pseudo-directoris "." i ".." mai es compten;
• Els enllaços simbòlics mai es segueixen per a la travessa del directori;
• Tant "regex incl" com "regex excl" s'apliquen als fitxers i directoris quan es calcula el recompte 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).
• El temps d'execució és limitat pel valor del temps d'espera a l'agent configuration (3 segons). Com que la travessa del directori gran pot trigar més, no es retornarà cap dada i l'element no serà compatible. No es retornarà el recompte parcial.
• Quan es filtren per mida, només els fitxers normals tenen mides significatives. Sota Linux i BSD, els directoris també tenen mides diferents de zero (normalment uns quants Ko). Els dispositius tenen mides zero, p. la mida de /dev/sda1 no reflecteix la mida de la partició respectiva. Per tant, quan empreu <min_size> i <max_size>, és recomanable especificar <types_incl> com a "fitxer", per evitar sorpreses.

Exemples:

 vfs.dir.count[/dev] #monitora el nombre de dispositius a /dev (Linux)

vfs.dir.get[dir,<regex incl>,<regex excl>,<types incl>,<types excl>,<max depth>,<min size>,<max size>,<min age>,<max age>,<regex excl dir>]

Llistat d'entrades del directori.
Valor de retorn: objecte JSON.
Veieu plataformes compatibles.

Paràmetres:

• dir - la ruta absoluta al directori;
• regex incl - una expressió que descriu el patró de nom de l'entitat (fitxer, directori, enllaç simbòlic) a incloure; inclou-ho tot si és buit (valor per defecte);
• regex excl - una [expressió] regular (/manual/regular_expressions#overview) que descriu el patró de nom de l'entitat (fitxer, directori, enllaç simbòlic) a excloure; no n'exclou cap si és buit (valor per defecte);
• tipus incl. - tipus d'entrada de directori per llistar, valors possibles: fitxer - fitxer normal, dir - subdirectori, sym - enllaç simbòlic, sock - socket, bdev - dispositiu de bloqueig, cdev - dispositiu de caràcters, fifo - FIFO, dev - sinònim de "bdev,cdev", all - tots els tipus (per defecte), és a dir, "fitxer,dir,sym,sock,bdev,cdev,fifo". S'han de separar diversos tipus amb comes i entre cometes.
• types excl - tipus d'entrada del directori (veieu 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.
• max depth - la profunditat màxima dels subdirectoris per recórrer:
  -1 (per defecte) - il·limitat,
  0 - sense descendència als subdirectoris.
• mida mínima - la mida mínima (en octets) perquè el fitxer es mostri. Els fitxers més petits no apareixeran a la llista. Es poden emprar sufixos de memòria.
• mida màxima - la mida màxima (en octets) del fitxer que s'ha d'enumerar. Els fitxers més grans no apareixeran a la llista. Es poden emprar sufixos de memòria.
• edat mínima - l'edat mínima (en segons) de l'entrada al directori que s'ha d'enumerar. Les entrades més recents no es mostraran. Es poden emprar sufixos de temps.
• edat màxima - l'edat màxima (en segons) de l'entrada del directori que es mostrarà. Les entrades tan antigues i més antigues no apareixeran a la llista (hora de modificació). Es poden emprar sufixos de temps.
• regex excl dir - una [expressió] regular (/manual/regular_expressions#overview) que descriu el patró de nom del directori a excloure. S'exclourà tot el contingut del directori (a diferència de "regex excl")

Comentaris:

• Variables d'entorn, p. %APP_HOME%, $HOME i %TEMP% no són compatibles;
• Pseudo-directoris "." i ".." mai apareixen a la llista;
• Els enllaços simbòlics mai es segueixen per a la travessa del directori;
• Tant 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).
• El temps d'execució està limitat pel valor del temps d'espera a l'agent configuration. Com que la travessa del directori gran pot trigar més, no es retornarà cap dada i l'element no serà compatible. No es retornarà la llista parcial.
• Quan es filtren per mida, només els fitxers normals tenen mides significatives. Sota Linux i BSD, els directoris també tenen mides diferents de zero (normalment uns quants Ko). Els dispositius tenen mides zero, p. la mida de /dev/sda1 no reflecteix la mida de la partició respectiva. Per tant, quan empreu mida mínima i mida màxima, és recomanable especificar tipus incl com a "fitxer", per evitar sorpreses.

Exemples:

vfs.dir.get[/dev] #retrieves the device list in /dev (Linux)

vfs.dir.size[dir,<regex incl>,<regex excl>,<mode>,<max depth>,<regex excl dir>]

Mida del directori (en octets).
Valor de retorn: Enter.
Plataformes admeses: Linux. L'element pot funcionar en altres plataformes semblants a UNIX.

Paràmetres:

• dir - ruta absoluta al directori;
• regex incl - una expressió que descriu el patró de nom de l'entitat (fitxer, directori, enllaç simbòlic) a incloure; inclou-ho tot si és buit (valor per defecte);
• regex excl - una [expressió] regular (/manual/regular_expressions#overview) que descriu el patró de nom de l'entitat (fitxer, directori, enllaç simbòlic) a excloure; no n'exclou cap si és buit (valor per defecte);
• mode - valors possibles: aparent (per defecte) - obté mides aparents dels fitxers en lloc de l'ús del disc (actua com a 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).
• max depth - la profunditat màxima dels subdirectoris per recórrer: -1 (per defecte) - il·limitat, 0 - sense descendència als subdirectoris.
• regex excl dir - una [expressió] regular (/manual/regular_expressions#overview) que descriu el patró de nom del directori a excloure. S'exclourà tot el contingut del directori (a diferència de "regex excl")

Comentaris:

• Només es calculen els directoris amb almenys el permís de lectura per a l'usuari zabbix. Per als directoris amb només permís de lectura, es calcula la mida del directori. Els directoris amb permisos de lectura i execució es calculen incloent el contingut.
• Amb directoris grans o unitats lentes, aquest element pot esgotar el temps d'espera a causa de la configuració del temps d'espera a agent i server/proxy fitxers de configuració. Augmenteu els valors de temps d'espera segons sigui necessari.
• El límit de mida del fitxer depèn de suport de fitxers grans.

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'

vfs.file.cksum[file,<mode>]

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:

• fitxer - camí complet al fitxer;
• mode - crc32 (per defecte), md5 o sha256.

El límit de mida del fitxer depèn de suport per a fitxers grans.

Exemple:

 vfs.file.cksum[/etc/passwd]

Exemple de valors retornats (crc32/md5/sha256 respectivament):

675436101
       9845acf68b73991eb7fd7ee0ded23c44
       ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc

vfs.file.contents[file,<encoding>]

Recupera el contingut d'un fitxer⁷.
Valor de retorn: Text.
Veieu plataformes compatibles.

Paràmetres:

• fitxer - camí complet al fitxer;
• encoding - pàgina de codis identificador.

Comentaris:

• El valor de retorn és limitat a 16Mo (incloent els espais en blanc al final truncats); també s'hi apliquen els límits de la base de dades;
• Es retorna una cadena buida si el fitxer és buit o només conté caràcters LF/CR;
• La marca d'ordre d'octets (BOM) s'exclou de la sortida.

Exemple:

vfs.file.contents[/etc/passwd]

vfs.file.exists[file,<types incl>,<types excl>]

Comprova si el fitxer existeix.
Valor de retorn: 0 - no trobat; 1: existeix un fitxer del tipus especificat.
Veieu plataformes compatibles.

Paràmetres:

• fitxer - camí complet al fitxer;
• tipus incl. - llistat de tipus de fitxers a incloure, valors possibles: fitxer (fitxer normal, predeterminat (si no s'estableix tipus_excl)), dir (directori), sym (simbòlic enllaç), sock (socket), bdev (dispositiu de bloqueig), cdev (dispositiu de caràcter), fifo (FIFO), dev (sinònim de "bdev,cdev"), all ( tots els tipus esmentats, per defecte si s'estableix tipus_excl).
• types excl - la llista de tipus de fitxers a excloure, vegeu types_incl per als valors possibles (per defecte no s'exclou cap tipus)

Comentaris:

• S'han de separar diversos tipus amb una coma i tot el conjunt entre cometes "";
• Si el mateix tipus es troba tant a <types_incl> com a <types_excl>, s'exclouen els fitxers d'aquest tipus;
• El límit de mida del fitxer depèn de suport de fitxers grans.

Exemples:

vfs.file.exists[/tmp/application.pid]
       vfs.file.exists[/tmp/application.pid,"file,dir,sym"]
       vfs.file.exists[/tmp/application_dir,dir]

vfs.file.get[file]

Retorna informació sobre un fitxer.
Valor de retorn: objecte JSON.
Veieu plataformes compatibles.

Paràmetre:

• fitxer - el camí complet al fitxer

Comentaris:

• Tipus de fitxers compatibles amb sistemes semblants a UNIX: fitxer normal, directori, enllaç simbòlic, sòcol, dispositiu de bloc, dispositiu de caràcters, FIFO.
• El límit de mida del fitxer depèn de suport de fitxers grans.

Exemple:

 vfs.file.get[/etc/passwd] #retorna un JSON amb informació sobre el fitxer /etc/passwd (tipus, usuari, permisos, SID, uid, etc.)

vfs.file.md5sum[file]

Suma de comprovació MD5 del fitxer.
Valor de retorn: cadena de caràcters (hash MD5 del fitxer).
Veieu plataformes compatibles.

Paràmetre:

• fitxer - el camí complet al fitxer

El límit de mida del fitxer depèn de suport per a fitxers grans.

Exemple:

 vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf]

Exemple de valor retornat:

b5052decb577e0fffd622d6ddc017e82

vfs.file.owner[file,<ownertype>,<resulttype>]

Recupera el propietari d'un fitxer.
Valor de retorn: Cadena.
Veieu plataformes compatibles.

Paràmetres:

• fitxer - el camí complet al fitxer;
• ownertype - usuari (per defecte) o grup (només Unix);
• resulttype - nom (per defecte) o id; per a id: retorna uid/gid a Unix, SID a Windows.

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

vfs.file.permissions[file]

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:

• fitxer - el camí complet al fitxer

El límit de mida del fitxer depèn de suport per a fitxers grans.

Exemple:

 vfs.file.permissions[/etc/passwd] #return permisos de /etc/passwd, per exemple, '0644'

vfs.file.regexp[file,regexp,<encoding>,<start line>,<end line>,<output>]

Recupera una cadena al fitxer⁷.
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:

• fitxer - camí complet al fitxer;
• regexp - una expressió que descriu el patró necessari;
• encoding - pàgina de codis identificador;
• línia inicial - nombre de la primera línia a cercar (primera línia del fitxer per defecte);
• línia final - nombre de la darrera línia a cercar (darrera línia del fitxer per defecte);
• sortida - una plantilla de format de sortida opcional. La seqüència d'escapada \0 es substitueix per la part del text coincident (des del primer caràcter on comença la coincidència fins al caràcter on acaba la coincidència), mentre que un \N (on N=1... 9) la seqüència d'escapada es substitueix per l'enèssim grup coincident (o una cadena buida si l'N supera el nombre de grups capturats).

Comentaris:

• El límit de mida del fitxer depèn de suport de fitxers grans.
• Només es retorna la primera línia coincident;
• Es retorna una cadena buida si cap línia coincideix amb l'expressió;
• La marca d'ordre d'octets (BOM) s'exclou de la sortida;
• L'extracció de contingut mitjançant el paràmetre 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*

vfs.file.regmatch[file,regexp,<encoding>,<start line>,<end line>]

Cerca una cadena al fitxer⁷.
Valors de retorn: 0 - no s'ha trobat la coincidència; 1 - trobat.
Veieu plataformes compatibles.

Paràmetres:

• fitxer - camí complet al fitxer;
• regexp - una expressió que descriu el patró necessari;
• encoding - la pàgina de codis identificador;
• línia inicial - nombre de la primera línia a cercar (primera línia del fitxer per defecte);
• línia final - nombre de la darrera línia a cercar (darrera línia del fitxer per defecte).

Comentaris:

• El límit de mida del fitxer depèn de suport de fitxers grans.
• La marca d'ordre dels octets (BOM) s'ignora.

Exemple:

vfs.file.regmatch[/var/log/app.log,error]

vfs.file.size[file,<mode>]

Mida del fitxer (en octets).
Valor de retorn: Enter.
Vegeu plataformes compatibles.

Paràmetres:

• fitxer - camí complet al fitxer;
• mode - valors possibles: octets (per defecte) o línies (les línies buides també es compten).

Comentaris:

• El fitxer ha de tindre permisos de lectura per a l'usuari zabbix;
• El límit de mida del fitxer depèn de suport de fitxers grans.

Exemple:

vfs.file.size[/var/log/syslog]

vfs.file.time[file,<mode>]

Informació de l'hora del fitxer.
Valor de retorn: Enter (marca de temps Unix).
Veieu plataformes compatibles.

Paràmetres:

• fitxer - camí complet al fitxer;
• mode - valors possibles:
  modificar (per defecte) - la darrera vegada que es va modificar el contingut del fitxer,
  access - el darrer cop que es va llegir el fitxer,
  canviar - el darrer cop en canviar les propietats del fitxer

El límit de mida del fitxer depèn de suport per a fitxers grans.

Exemple:

vfs.file.time[/etc/passwd,modify]

vfs.fs.discovery

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.

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. 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:

• També s'informa de sistemes de fitxers amb el nombre d'inodes igual a zero, que pot ser el cas dels sistemes de fitxers amb inodes dinàmics (per exemple, btrfs);
• Veieu també: Descobriment de sistemes de fitxers muntats.

vfs.fs.inode[fs,<mode>]

Nombre o percentatge d'inodes.
Valor de retorn: Enter - per al nombre; Flotant - per percentatge.
Veieu plataformes compatibles.

Paràmetres:

• fs - sistema de fitxers;
• mode - valors possibles: total (per defecte), free, used, pfree (gratuït, percentatge) o pused (emprat, percentatge).

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:

vfs.fs.inode[/,pfree]

vfs.fs.size[fs,<mode>]

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:

• fs - sistema de fitxers;
• mode - valors possibles: total (per defecte), free, used, pfree (gratuït, percentatge) o pused (usat, percentatge).

Comentaris:

• Si el sistema de fitxers no és pas muntat, retorna la mida d'un sistema de fitxers local on es troba el punt de muntatge;
• L'espai reservat d'un sistema de fitxers es té en compte i no s'inclou quan s'empra el mode gratuït.

Exemple:

vfs.fs.size[/tmp,free]

vm.memory.size[<mode>]

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:

• mode - valors possibles: total (per defecte), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (emprat, percentatge), available o pavailable (disponible, percentatge).

Comentaris:

• Aquest element admet tres categories de paràmetres:
  1) total - quantitat total de memòria
  2) tipus de memòria específics de la plataforma: actiu, anon, búfers, emmagatzemat en memòria cau, exec, file, free, inactive, pinned, shared, slab, wired
  3) estimacions a nivell d'usuari sobre quanta memòria s'empra i hi ha disponible: used, pused, available, pavailable
• El paràmetre de mode actiu només és compatible amb FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD;
• Els paràmetres del mode anon, exec, file només són compatibles amb NetBSD;
• El paràmetre de mode buffers només és compatible amb Linux, FreeBSD, OpenBSD, NetBSD;
• El paràmetre de mode cached només és compatible amb Linux, FreeBSD, AIX, OpenBSD, NetBSD;
• Els paràmetres del mode inactiu, cablejat només són compatibles amb FreeBSD, MacOS X, OpenBSD, NetBSD;
• El paràmetre de mode pinned només és compatible amb AIX;
• El paràmetre de mode compartit només és compatible amb Linux 2.4, FreeBSD, OpenBSD, NetBSD;
• Veieu també detalls addicionals per a aquest element.

Exemple:

vm.memory.size[pavailable]

web.page.get[host,<path>,<port>]

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:

• equip - nom de l'equip o l'URL (com a scheme://host:port/path, on només equip és obligatori). Esquemes d'URL permesos: http, https⁴. 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 ⁴ . Punycode és compatible amb els noms d'equip.
• path - camí d'accés a un document HTML (per defecte és /);
• port - nombre de port (per defecte és 80 per a HTTP)

Comentaris:

• Aquest element no és compatible si el recurs especificat a "equip" no existeix o no és disponible;
• 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"]

web.page.perf[host,<path>,<port>]

El temps de càrrega d'una pàgina web completa (en segons).
Valor de retorn: Flotant.
Veieu plataformes compatibles.

Paràmetres:

• equip - nom de l'equip o l'URL (com a scheme://host:port/path, on només equip és obligatori). Esquemes d'URL permesos: http, https⁴. 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 ⁴ . Punycode és compatible amb els noms d'equip.
• path - camí d'accés a un document HTML (per defecte és /);
• port - nombre de port (per defecte és 80 per a HTTP)

Comentaris:

• Aquest element no és compatible si el recurs especificat a "equip" no existeix o no és disponible;
• `equipv 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.perf[www.exemple.cat,index.php,80]
       web.page.perf[https://www.exemple.cat]

web.page.regexp[host,<path>,<port>,regexp,<length>,<output>]

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:

• equip - nom d'equip o URL (com a scheme://host:port/path, on només equip és obligatori). Esquemes d'URL permesos: http, https⁴. 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 ⁴ . Punycode és compatible amb els noms d'equip.
• path - camí d'accés a un document HTML (per defecte és /);
• port - nombre de port (per defecte és 80 per a HTTP)
• regexp - una expressió que descriu el patró necessari;
• longitud - nombre màxim de caràcters a retornar;
• sortida - una plantilla de format de sortida opcional. La seqüència d'escapada \0 es substitueix per la part del text coincident (des del primer caràcter on comença la coincidència fins al caràcter on acaba la coincidència), mentre que un \N (on N=1... 9) la seqüència d'escapada es substitueix per l'enèssim grup coincident (o una cadena buida si la N supera el nombre de grups capturats).

Comentaris:

• Aquest element no és compatible si el recurs especificat a "equip" no existeix o no és disponible;
• "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.
• L'extracció de contingut mitjançant el paràmetre output té lloc a l'agent.

Exemple:

web.page.regexp[www.exemple.cat,index.php,80,OK,2]
       web.page.regexp[https://www.exemple.cat,,,OK,2]|

agent.hostmetadata

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.

agent.hostname

Nom d'equip de l'agent.
Valor de retorn: Cadena.
Veieu plataformes compatibles.

Devolucions:

• Com a comprovació passiva: el nom del primer equip que apareix al paràmetre Hostname del fitxer de configuració de l'agent;
• Com a verificació activa - el nom del nom d'equip actual.

agent.ping

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.

agent.variant

Variant de l'agent Zabbix (agent Zabbix o agent Zabbix 2).
Valor de retorn: 1 - agent Zabbix; 2 - Agent Zabbix 2.
Veieu plataformes compatibles.

agent.version

Versió de l'agent Zabbix.
Valor de retorn: String.
Veieu plataformes compatibles.

Exemple de valor retornat:

6.0.3

zabbix.stats[<ip>,<port>]

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:

• ip - llista d'IP/DNS/màscara de xarxa de servidors/proxies que s'han de consultar remotament (el valor per defecte és 127.0.0.1);
• port - el port del servidor/proxy que s'ha de consultar remotament (el valor per defecte és 10051)

Comentaris:

• Aquest element retorna un conjunt triat de mètriques internes. Per obtenir més informació, veieu Monitoratge remot de les estadístiques de Zabbix;
• Tingueu en compte que la pteició d'estadístiques només s'admetrà des de les adreces que figuren al paràmetre 'StatsAllowedIP' servidor/proxy a l'objectiu instància.

zabbix.stats[<ip>,<port>,queue,<from>,<to>]

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:

• ip - llista d'IP/DNS/màscara de xarxa de servidors/proxies que s'han de consultar remotament (el valor per defecte és 127.0.0.1);
• port - port del servidor/proxy que s'ha de consultar remotament (el valor per defecte és 10051)
• cua - constant (que s'emprarà tal com ve)
• de - endarreriment mínim (el valor predeterminat és de 6 segons)
• a - endarreriment màxim (per defecte és infinit)

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í.

Notes al peu

^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.

² 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'.

³ 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.

⁴ SSL (HTTPS) només és compatible si l'agent es compila amb suport de cURL. En cas contrari, l'element no serà compatible.

⁵ 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.

⁶ 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.

⁷ 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.

Ús amb utilitats de línia d'ordres

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]

Paràmetres de codificació

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:

• Si no s'especifica la codificació (o si és una cadena buida), se suposa que és UTF-8, les dades es tracten "tal com són";
• Anàlisi de BOM: aplicable als elements "vfs.file.contents", "vfs.file.regexp", "vfs.file.regmatch". S'intenta determinar la codificació correcta emprant la marca d'ordre d'octets (BOM) al començament del fitxer. Si la BOM no és pas present, s'aplica la resolució estàndard (veieu més amunt).

Problemes dels elements de l'agent

• Si s'empra amb l'agent passiu, el valor Timeout de la configuració del servidor ha d'ésser superior a Timeout a l'arxiu de configuració de l'agent. Sinó, l'element no prendrà pas cap valor doncs la petició del servidor a l'agent haurà expirat primer.