1 Agente Zabbix

Descripción general

Esta sección proporciona detalles sobre las claves de métricas que utilizan la comunicación con el agente de Zabbix para la recopilación de datos.

Hay comprobaciones pasivas y activas de agentes . Al configurar una métrica puede seleccionar el tipo requerido:

  • Agente Zabbix - para comprobaciones pasivas
  • Agente Zabbix (activo) - para comprobaciones activas

Tenga en cuenta que todas las claves de métricas admitidas por el agente Zabbix en Windows también son compatibles con el agente Zabbix 2 de nueva generación. Consulte las claves de métricas adicionales que puede usar solo con el agente 2.

Plataformas compatibles

Excepto cuando se especifique lo contrario en los detalles de la métrica, las métricas del agente (y todos los parámetros) son compatibles con:

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

Muchas métricas del agente también son compatibles con Windows. Consulte la página métricas del agente de Windows para obtener más detalles.

Detalles clave de métrica

Los parámetros sin corchetes angulares son obligatorios. Los parámetros marcados con corchetes angulares < > son opcionales.

kernel.maxfiles


La cantidad máxima de archivos abiertos admitidos por el sistema operativo.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.

kernel.maxproc


El número máximo de procesos admitidos por el sistema operativo.
Valor de retorno: Entero.
Plataformas compatibles: Linux 2.6 y posteriores, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

kernel.openfiles


El número de descriptores de archivos abiertos actualmente.
Valor de retorno: Entero.
Plataformas compatibles: Linux (la métrica puede funcionar en otras plataformas similares a UNIX).

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


La supervisión de un archivo de registro.
Valor de retorno: Registro.
Consulte plataformas compatibles.

Parámetros:

  • archivo: la ruta completa y el nombre de un archivo de registro;
  • regexp - una expresión regular que describe el patrón requerido;
  • codificación - la página de códigos identificador;
  • maxlines: el número máximo de líneas nuevas por segundo que el agente enviará al servidor o proxy de Zabbix. Este parámetro anula el valor de 'MaxLinesPerSecond' en zabbix_agentd.conf;
  • modo - valores posibles: todos (predeterminado) o omitir - omitir el procesamiento de datos más antiguos (afecta solo a los elementos recién creados);
  • salida: una plantilla de formato de salida opcional. La secuencia de escape \0 se reemplaza con la parte coincidente del texto (desde el primer carácter donde comienza la coincidencia hasta el carácter donde termina la coincidencia), mientras que \N (donde N=1... 9) la secuencia de escape se reemplaza con el enésimo grupo coincidente (o una cadena vacía si N excede el número de grupos capturados);
  • maxdelay - el retraso máximo en segundos. Tipo: flotador. Valores: 0 - (predeterminado) nunca ignorar las líneas del archivo de registro; > 0.0: ignore las líneas más antiguas para analizar las líneas más recientes en segundos de "retraso máximo". ¡Lea las notas de maxdelay antes de usarlo!
  • opciones - opciones adicionales:
    mtime-noreread - registros no únicos, relee solo si el tamaño del archivo cambia (ignora el cambio de hora de modificación). (Este parámetro está en desuso desde 5.0.2, porque ahora se ignora mtime).
  • directorio persistente (solo en zabbix_agentd en sistemas Unix; no compatible con el agente Zabbix 2): la ruta absoluta del directorio donde almacenar los archivos persistentes. Consulte también notas adicionales sobre [archivos persistentes] (log_items#notes-on-persistent-files-for-log-items).

Comentarios:

  • El artículo debe configurarse como verificación activa;
  • Si falta el archivo o los permisos no permiten el acceso, el elemento deja de ser compatible;
  • Si "salida" se deja vacío, se devuelve la línea completa que contiene el texto coincidente. Tenga en cuenta que todos los tipos de expresiones regulares globales, excepto 'El resultado es VERDADERO', siempre devuelven la línea coincidente completa y el parámetro "salida" se ignora.
  • La extracción de contenido mediante el parámetro "salida" se realiza en el agente.

Ejemplos:

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

Ejemplo de uso del parámetro "salida" para extraer un número del registro:

log[/app1/app.log,"tarea ejecutada [0-9.]+ segundos, registros procesados ([0-9]+), [0-9]+ errores",,,,\1] #este elemento coincidirá con un registro "2015-11-13 10:08:26 tarea ejecutada 6,08 segundos, procesó 6080 registros, 0 errores" y enviará solo '6080' al servidor. Debido a que se envía un valor numérico, el "Tipo de información" para este elemento se puede establecer en "Numérico (sin firmar)" y el valor se puede usar en gráficos, activadores, etc.

Ejemplo de uso del parámetro output para reescribir un registro antes de enviarlo al servidor:

log[/app1/app.log,"([0-9:-]+) tarea ejecutada ([0-9.]+) segundos, registros procesados ([0-9]+), ([0-9] +) errores",,,,"\1 REGISTROS: \3, ERRORES: \4, DURACIÓN: \2"] #este elemento coincidirá con un registro "2015-11-13 10:08:26 ejecución de la tarea 6,08 seg. , procesó 6080 registros, 0 errores" y envía un registro modificado "2015-11-13 10:08:26 REGISTROS: 6080, ERRORES: 0, DURACIÓN: 6.08" al servidor.
log.count[file,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]


El recuento de líneas coincidentes en un archivo de registro monitoreado.
Valor de retorno: Entero.
Consulte plataformas compatibles.

Parámetros:

  • archivo - la ruta completa y el nombre del archivo de registro;
  • regexp - una expresión regular que describe el patrón requerido;
  • codificación - la página de códigos identificador;
  • maxproclines: el número máximo de líneas nuevas por segundo que analizará el agente (no puede exceder 10000). El valor predeterminado es 10*'MaxLinesPerSecond' en zabbix_agentd.conf.
  • modo - valores posibles: todos (predeterminado) o omitir - omitir el procesamiento de datos más antiguos (afecta solo a los elementos recién creados).
  • maxdelay - el retraso máximo en segundos. Tipo: flotador. Valores: 0 - (predeterminado) nunca ignorar las líneas del archivo de registro; > 0.0: ignore las líneas más antiguas para analizar las líneas más recientes en segundos de "retraso máximo". ¡Lea las notas de maxdelay antes de usarlo!
  • opciones - opciones adicionales:
    mtime-noreread - registros no únicos, relee solo si el tamaño del archivo cambia (ignora el cambio de hora de modificación). (Este parámetro está en desuso desde 5.0.2, porque ahora se ignora mtime).
  • directorio persistente (solo en zabbix_agentd en sistemas Unix; no compatible con el agente Zabbix 2): la ruta absoluta del directorio donde almacenar los archivos persistentes. Consulte también notas adicionales sobre [archivos persistentes] (log_items#notes-on-persistent-files-for-log-items).

Comentarios:

  • El artículo debe configurarse como verificación activa;
  • Las líneas coincidentes se cuentan en las nuevas líneas desde la última verificación del registro por parte del agente y, por lo tanto, dependen del intervalo de actualización del elemento;
  • Si falta el archivo o los permisos no permiten el acceso, el elemento deja de ser compatible.
logrt[file regexp,<regexp>,<codificación>,<maxlines>,<modo>,<salida>,<maxdelay>,<opciones>,<directorio persistente>]


La supervisión de un archivo de registro que se rota.
Valor de retorno: Registro.
Consulte las plataformas compatibles.

Parámetros:

  • file regexp: la ruta absoluta al archivo y el nombre del archivo descrito por una expresión normal. Tenga en cuenta que sólo el nombre del archivo es una expresión regular.
  • regexp - una expresión regular que describe el patrón de contenido requerido;
  • codificación - identificador de la página de códigos;
  • maxlines: el número máximo de líneas nuevas por segundo que el agente enviará al servidor o proxy de Zabbix. Este parámetro anula el valor de 'MaxLinesPerSecond' en zabbix_agentd.conf.
  • modo - valores posibles: all (predeterminado) o skip - omitir el procesamiento de datos más antiguos (afecta solo a las métricas recién creados).
  • salida: una plantilla de formato de salida opcional. La secuencia de escape \0 se reemplaza con la parte coincidente del texto (desde el primer carácter donde comienza la coincidencia hasta el carácter donde termina la coincidencia), mientras que \N (donde N=1... 9) la secuencia de escape se reemplaza con el enésimo grupo coincidente (o una cadena vacía si N excede el número de grupos capturados).
  • maxdelay - el retraso máximo en segundos. Tipo: flotador. Valores: 0 - (predeterminado) nunca ignorar las líneas del archivo de registro; > 0.0: ignore las líneas más antiguas para analizar las líneas más recientes en segundos de "retraso máximo". ¡Lea las notas de maxdelay antes de usarlo!
  • opciones: el tipo de rotación del archivo de registro y otras opciones. Valores posibles:
    rotate (predeterminado),
    copytruncate - tenga en cuenta que copytruncate no se puede utilizar junto con maxdelay. En este caso maxdelay debe ser 0 o no especificarse; consulte las notas de copytruncate,
    mtime-reread - registros no únicos, vuelva a leer si la hora de modificación o el tamaño cambian (predeterminado),
    mtime-noreread - registros no únicos, vuelva a leer solo si el tamaño cambia (ignore el cambio de hora de modificación).
  • directorio persistente (solo en zabbix_agentd en sistemas Unix; no compatible con el agente Zabbix 2): la ruta absoluta del directorio donde almacenar los archivos persistentes. Consulte también notas adicionales sobre [archivos persistentes] (log_items#notes-on-persistent-files-for-log-items).

Comentarios:

  • La métrica debe configurarse como verificación activa;
  • La rotación de registros se basa en la hora de la última modificación de los archivos;
  • Tenga en cuenta que logrt está diseñado para funcionar con un archivo de registro actualmente activo, con varios otros archivos inactivos coincidentes rotados. Si, por ejemplo, un directorio tiene muchos archivos de registro activos, se debe crear un elemento de registro independiente para cada uno. De lo contrario, si un elemento de registro recoge demasiados archivos, puede provocar que se agote la memoria y se produzca un fallo en la supervisión.
  • Si "salida" se deja vacío, se devuelve la línea completa que contiene el texto coincidente. Tenga en cuenta que todos los tipos de expresiones regulares globales, excepto 'El resultado es VERDADERO', siempre devuelven la línea coincidente completa y el parámetro "salida" se ignora.
  • La extracción de contenido mediante el parámetro "salida" se realiza en el agente.

Ejemplos:

logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] #esta métrica coincidirá con un archivo como "logfile1" (no coincidirá con ".logfile1")
       logrt["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #esta métrica recopilará datos de archivos como "logfile_abc_1" o "archivo de registro__001"

Ejemplo de uso del parámetro "salida" para extraer un número del registro:

logrt[/app1/^test.*log$,"tarea ejecutada [0-9.]+ segundos, registros procesados ([0-9]+), [0-9]+ errores",,,,\1] #esta métrica coincidirá con un registro "2015-11-13 10:08:26 tarea ejecutada 6,08 segundos, procesado 6080 registros, 0 errores" y enviará solo '6080' al servidor. Debido a que se envía un valor numérico, el "Tipo de información" para esta métrica se puede establecer en "Numérico (sin signo)" y el valor se puede utilizar en gráficos, iniciadores, etc.

Ejemplo de uso del parámetro output para reescribir un registro antes de enviarlo al servidor:

logrt[/app1/^test.*log$,"([0-9:-]+) tarea ejecutada ([0-9.]+) segundos, registros procesados ([0-9]+), ([0 -9]+) errores",,,,"\1 REGISTROS: \3, ERRORES: \4, DURACIÓN: \2"] #esta métrica coincidirá con un registro de registro "2015-11-13 10:08:26 tarea ejecute 6,08 segundos, procesó 6080 registros, 0 errores" y envíe un registro modificado "2015-11-13 10:08:26 REGISTROS: 6080, ERRORES: 0, DURACIÓN: 6,08" al servidor. |
logrt.count[archivo regexp,<regexp>,<codificación>,<maxproclines>,<modo>,<maxdelay>,<opciones>,<directorio persistente>]


El recuento de líneas coincidentes en un archivo de registro monitoreado que se rota.
Valor de retorno: Entero.
Consulte plataformas compatibles.

Parámetros:

  • file regexp - la ruta absoluta al archivo y la expresión regular que describe el patrón de nombre del archivo;
  • regexp - una expresión regular que describe el patrón requerido;
  • codificación - el identificador de la página de códigos;
  • maxproclines: el número máximo de líneas nuevas por segundo que analizará el agente (no puede exceder 10000). El valor predeterminado es 10*'MaxLinesPerSecond' en zabbix_agentd.conf.
  • modo - valores posibles: all (predeterminado) o skip - omitir el procesamiento de datos más antiguos (afecta solo a los elementos recién creados).
  • maxdelay - el retraso máximo en segundos. Tipo: flotador. Valores: 0 - (predeterminado) nunca ignorar las líneas del archivo de registro; > 0.0: ignore las líneas más antiguas para analizar las líneas más recientes en segundos de "retraso máximo". ¡Lea las notas de maxdelay antes de usarlo!
  • opciones: el tipo de rotación del archivo de registro y otras opciones. Valores posibles:
    rotate (predeterminado),
    copytruncate - tenga en cuenta que copytruncate no se puede utilizar junto con maxdelay. En este caso maxdelay debe ser 0 o no especificarse; consulte las notas de copytruncate,
    mtime-reread - registros no únicos, vuelva a leer si cambia el tiempo de modificación o el tamaño (predeterminado),
    mtime-noreread - registros no únicos, vuelva a leer solo si el tamaño cambia (ignore el cambio de hora de modificación).
  • directorio persistente (solo en zabbix_agentd en sistemas Unix; no compatible con el agente Zabbix 2): la ruta absoluta del directorio donde almacenar los archivos persistentes. Consulte también notas adicionales sobre [archivos persistentes] (log_items#notes-on-persistent-files-for-log-items).

Comentarios:

  • La métrica debe configurarse como comprobación activa;
  • Las líneas coincidentes se cuentan en las nuevas líneas desde la última verificación del registro por parte del agente y, por lo tanto, dependen del intervalo de actualización del elemento;
  • La rotación de registros se basa en la hora de la última modificación de los archivos.
modbus.get[punto final,<id de esclavo>,<función>,<dirección>,<recuento>,<tipo>,<endianidad>,<desplazamiento>]


Lee datos Modbus.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux.

Parámetros:

  • punto final - el punto final definido como protocol://connection_string;
  • id del esclavo - el ID del esclavo;
  • función - la función Modbus;
  • dirección - la dirección del primer registro, bobina o entrada;
  • count - el número de registros a leer;
  • tipo - el tipo de datos;
  • endianidad - la configuración de endianidad;
  • desplazamiento: el número de registros, comenzando desde 'dirección', cuyos resultados se descartarán.

Consulte una descripción detallada de parámetros.

net.dns[<ip>,nombre,<tipo>,<tiempo de espera>,<recuento>,<protocolo>]


Comprueba si el servicio DNS está activo.
Valores de retorno: 0: DNS está inactivo (el servidor no respondió o falló la resolución de DNS); 1: DNS está activo.
Consulte plataformas compatibles.

Parámetros:

  • ip: la dirección IP del servidor DNS (déjela vacía para el servidor DNS predeterminado, ignorada en Windows a menos que utilice el agente 2 de Zabbix);
  • nombre - el nombre DNS a consultar;
  • tipo: el tipo de registro que se consultará (el valor predeterminado es SOA);
  • tiempo de espera (ignorado en Windows a menos que se use el agente Zabbix 2): el tiempo de espera de la solicitud en segundos (el valor predeterminado es 1 segundo);
  • recuento (ignorado en Windows a menos que se utilice el agente 2 de Zabbix): el número de intentos para la solicitud (el valor predeterminado es 2);
  • protocolo: el protocolo utilizado para realizar consultas DNS: udp (predeterminado) o tcp.

Comentarios:

  • Los valores posibles para tipo son: ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (no compatible con Zabbix Agent en Windows, Zabbix Agent 2 en todos los sistemas operativos), HINFO, MINFO, TXT, SRV
  • Los nombres de dominio internacionalizados no son compatibles; en su lugar, utilice nombres codificados con IDNA.

Ejemplo:

net.dns[198.51.100.1,example.com,MX,2,1]
net.dns.record[<ip>,nombre,<tipo>,<tiempo de espera>,<recuento>,<protocolo>]


Realiza una consulta DNS.
Valor de retorno: una cadena de caracteres con el tipo de información requerida.
Consulte plataformas compatibles.

Parámetros:

  • ip: la dirección IP del servidor DNS (déjela vacía para el servidor DNS predeterminado, ignorada en Windows a menos que utilice el agente Zabbix 2);
  • nombre - el nombre DNS a consultar;
  • tipo: el tipo de registro que se consultará (el valor predeterminado es SOA);
  • tiempo de espera (ignorado en Windows a menos que se use el agente Zabbix 2): el tiempo de espera de la solicitud en segundos (el valor predeterminado es 1 segundo);
  • recuento (ignorado en Windows a menos que se utilice el agente 2 de Zabbix): el número de intentos para la solicitud (el valor predeterminado es 2);
  • protocolo: el protocolo utilizado para realizar consultas DNS: udp (predeterminado) o tcp.

Comentarios:

  • Los valores posibles para tipo son:
    ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, * MF, MX, SOA, NULL, WKS* (no compatible con Zabbix Agent en Windows, Zabbix Agent 2 en todos los sistemas operativos), HINFO, MINFO, TXT, SRV
  • Los nombres de dominio internacionalizados no son compatibles; en su lugar, utilice nombres codificados con IDNA.

Ejemplo:

net.dns.record[198.51.100.1,example.com,MX,2,1]
net.if.collisions[if]


El número de colisiones "out-of-window".
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. Se requieren privilegios de root en NetBSD.

Parámetro:

  • if - nombre de la interfaz de red
net.if.discovery


La lista de interfaces de red. Se utiliza para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.

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


Las estadísticas del tráfico entrante en una interfaz de red.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Se requieren privilegios de root en NetBSD.

Parámetros:

  • if - nombre de la interfaz de red (Unix); descripción completa de la interfaz de red o dirección IPv4; o, si está entre llaves, GUID de la interfaz de red (Windows);
  • modo - valores posibles:
    bytes - número de bytes (predeterminado)
    packets - número de paquetes
    errors - número de errores
    dropped - número de paquetes descartados
    overruns (fifo) - el número de errores del búfer FIFO
    frame - el número de errores de encuadre de paquetes
    compressed - el número de paquetes comprimidos recibidos por el controlador del dispositivo
    multicast: el número de tramas de multidifusión recibidas por el controlador del dispositivo

Comentarios:

  • Puede utilizar esta clave con el paso de preprocesamiento Cambio por segundo para obtener las estadísticas de bytes por segundo;
  • El modo eliminado sólo se admite en Linux, FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD;
  • Los modos overruns, frame, compressed, multicast solo se admiten en Linux;
  • En HP-UX, este elemento no proporciona detalles sobre las interfaces de bucle invertido (por ejemplo, lo0).

Ejemplos:

net.if.in[eth0]
       net.if.in[eth0,errors]
net.if.out[if,<modo>]


Las estadísticas de tráfico saliente en una interfaz de red.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Se requieren privilegios de root en NetBSD.

Parámetros:

  • if - nombre de la interfaz de red (Unix); descripción completa de la interfaz de red o dirección IPv4; o, si está entre llaves, GUID de la interfaz de red (Windows);
  • modo - valores posibles:
    bytes - número de bytes (predeterminado)
    packets - número de paquetes
    errors - número de errores
    dropped - número de paquetes descartados
    overruns (fifo) - el número de errores del búfer FIFO
    collisions (colls) - el número de colisiones detectadas en la interfaz
    carrier - el número de pérdidas del portador detectado por el controlador del dispositivo
    compressed: la cantidad de paquetes comprimidos transmitidos por el controlador del dispositivo

Comentarios:

  • Puede utilizar esta clave con el paso de preprocesamiento Cambio por segundo para obtener las estadísticas de bytes por segundo;
  • El modo eliminado solo se admite en Linux, HP-UX;
  • Los modos overruns, colision, carrier, compressed son compatibles solo en Linux;
  • En HP-UX, este elemento no proporciona detalles sobre las interfaces de bucle invertido (por ejemplo, lo0).

Ejemplos:

net.if.out[eth0]
       net.if.out[eth0,errors]
net.if.total[if,<modo>]


La suma de las estadísticas de tráfico entrante y saliente en una interfaz de red.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Se requieren privilegios de root en NetBSD.

Parámetros:

  • if - nombre de la interfaz de red (Unix); descripción completa de la interfaz de red o dirección IPv4; o, si está entre llaves, GUID de la interfaz de red (Windows);
  • modo - valores posibles:
    bytes - número de bytes (predeterminado)
    packets - número de paquetes
    errors - número de errores
    dropped - número de paquetes descartados
    overruns (fifo) - el número de errores del búfer FIFO
    collisions (colls) - el número de colisiones detectadas en la interfaz
    compressed - el número de paquetes comprimidos transmitido o recibido por el controlador del dispositivo

Comentarios:

  • Puede utilizar esta clave con el paso de preprocesamiento Cambio por segundo para obtener las estadísticas de bytes por segundo;
  • El modo dropped solo se admite en Linux, HP-UX. Los paquetes descartados solo se admiten si tanto net.if.in como net.if.out funcionan para paquetes descartados en su plataforma.
  • Los modos overruns, collisions, compressed solo se admiten en Linux;
  • En HP-UX, este elemento no proporciona detalles sobre las interfaces de bucle invertido (por ejemplo, lo0).

Ejemplos:

net.if.total[eth0]
       net.if.total[eth0,errors]
net.tcp.listen[puerto]


Comprueba si este puerto TCP está en estado ESCUCHA.
Valores de retorno: 0: no está en estado ESCUCHA; 1 - está en estado ESCUCHA.
Plataformas compatibles: Linux, FreeBSD, Solaris, MacOS X.

Parámetro:

  • puerto - número de puerto TCP

En los kernels de Linux 2.6.14 y superiores, la información sobre la escucha de sockets TCP se obtiene de la interfaz NETLINK del kernel, si es posible. De lo contrario, la información se recupera de los archivos /proc/net/tcp y /roc/net/tcp6.

Ejemplo:

net.tcp.listen[80]
net.tcp.port[<ip>,puerto]


Comprueba si es posible realizar una conexión TCP al puerto especificado.
Valores de retorno: 0 - no se puede conectar; 1 - se puede conectar.
Consulte plataformas compatibles.

Parámetros:

  • ip: la dirección IP o el nombre DNS (el valor predeterminado es 127.0.0.1);
  • puerto: el número de puerto.

Comentarios:

  • Para pruebas simples de rendimiento de TCP, utilice net.tcp.service.perf[tcp,<ip>,<port>];
  • Estas comprobaciones pueden generar mensajes adicionales en los archivos de registro del demonio del sistema (normalmente se registran sesiones SMTP y SSH).

Ejemplo:

net.tcp.port[,80] #esta métrica se puede utilizar para probar la disponibilidad del servidor web que se ejecuta en el puerto 80
net.tcp.service[servicio,<ip>,<puerto>]


Comprueba si un servicio se está ejecutando y acepta conexiones TCP.
Valores de retorno: 0: el servicio no funciona; 1: el servicio se está ejecutando.
Consulte plataformas compatibles.

Parámetros:

  • servicio - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https o telnet (ver detalles);
  • ip: la dirección IP o el nombre DNS (el valor predeterminado es 127.0.0.1);
  • puerto: el número de puerto (de forma predeterminada se utiliza el número de puerto de servicio estándar).

Comentarios:

  • Estas comprobaciones pueden generar mensajes adicionales en los archivos de registro del demonio del sistema (normalmente se registran sesiones SMTP y SSH);
  • Actualmente no se admite la verificación de protocolos cifrados (como IMAP en el puerto 993 o POP en el puerto 995). Como solución alternativa, utilice net.tcp.port[] para comprobaciones como estas.
  • La comprobación de LDAP y HTTPS en Windows sólo es compatible con el agente 2 de Zabbix;
  • La comprobación de telnet busca un mensaje de inicio de sesión (':' al final).

Ejemplo:

net.tcp.service[ftp,,45] #este elemento se puede utilizar para probar la disponibilidad del servidor FTP en el puerto TCP 45
net.tcp.service.perf[servicio,<ip>,<puerto>]


Comprueba el rendimiento de un servicio TCP.
Valores de retorno: Flotante (0: el servicio está inactivo; segundos: la cantidad de segundos transcurridos mientras se conecta al servicio).
Consulte plataformas compatibles.

Parámetros:

  • servicio - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https o telnet (ver detalles);
  • ip: la dirección IP o el nombre DNS (el valor predeterminado es 127.0.0.1);
  • puerto: el número de puerto (de forma predeterminada se utiliza el número de puerto de servicio estándar).

Comentarios:

  • Actualmente no se admite la verificación de protocolos cifrados (como IMAP en el puerto 993 o POP en el puerto 995). Como solución alternativa, utilice net.tcp.service.perf[tcp,<ip>,<port>] para comprobaciones como estas.
  • La comprobación de telnet busca un mensaje de inicio de sesión (':' al final).

Ejemplo:

net.tcp.service.perf[ssh] #este elemento se puede utilizar para probar la velocidad de respuesta inicial del servidor SSH
net.tcp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<estado>]


Devuelve el número de sockets TCP que coinciden con los parámetros.
Valor de retorno: Entero.
Plataformas compatibles: Linux.

Parámetros:

  • laddr: la dirección IPv4/6 local o subred CIDR;
  • lport: el número de puerto local o el nombre del servicio;
  • raddr: la dirección IPv4/6 remota o subred CIDR;
  • rport: el número de puerto remoto o el nombre del servicio;
  • state - el estado de la conexión (established, syn_sent, syn_recv, fin_wait1, fin_wait2, time_wait, close, * close_wait, last_ack, listen, closing*).

Ejemplo:

net.tcp.socket.count[,80,,,established] #el número de conexiones al puerto TCP local 80 en el estado establecido
net.udp.listen[puerto]


Comprueba si este puerto UDP está en estado ESCUCHA.
Valores de retorno: 0: no está en estado ESCUCHA; 1 - está en estado ESCUCHA.
Plataformas compatibles: Linux, FreeBSD, Solaris, MacOS X.

Parámetro:

  • puerto - número de puerto UDP

Ejemplo:

net.udp.listen[68]
net.udp.service[servicio,<ip>,<puerto>]


Comprueba si un servicio se está ejecutando y respondiendo a solicitudes UDP.
Valores de retorno: 0: el servicio no funciona; 1: el servicio se está ejecutando.
Consulte plataformas compatibles.

Parámetros:

  • servicio - ntp (ver detalles);
  • ip: la dirección IP o el nombre DNS (el valor predeterminado es 127.0.0.1);
  • puerto: el número de puerto (de forma predeterminada se utiliza el número de puerto de servicio estándar).

Ejemplo:

net.udp.service[ntp,,45] #este elemento se puede utilizar para probar la disponibilidad del servicio NTP en el puerto UDP 45
net.udp.service.perf[servicio,<ip>,<puerto>]


Comprueba el rendimiento de un servicio UDP.
Valores de retorno: Flotante (0: el servicio está inactivo; segundos: la cantidad de segundos transcurridos esperando una respuesta del servicio).
Consulte plataformas compatibles.

Parámetros:

  • servicio - ntp (ver detalles);
  • ip: la dirección IP o el nombre DNS (el valor predeterminado es 127.0.0.1);
  • puerto: el número de puerto (de forma predeterminada se utiliza el número de puerto de servicio estándar).

Ejemplo:

net.udp.service.perf[ntp] #esta métrica se puede utilizar para probar el tiempo de respuesta del servicio NTP
net.udp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<estado>]


Devuelve el número de sockets UDP que coinciden con los parámetros.
Valor de retorno: Entero.
Plataformas compatibles: Linux.

Parámetros:

  • laddr: la dirección IPv4/6 local o subred CIDR;
  • lport: el número de puerto local o el nombre del servicio;
  • raddr: la dirección IPv4/6 remota o subred CIDR;
  • rport: el número de puerto remoto o el nombre del servicio;
  • estado - el estado de la conexión (established, unconn).

Ejemplo:

net.udp.socket.count[,,,,established] #devuelve el número de sockets UDP en el estado conectado
proc.cpu.util[<nombre>,<usuario>,<tipo>,<cmdline>,<modo>,<zona>]


El porcentaje de utilización de la CPU del proceso.
Valor de retorno: Flotante.
Plataformas compatibles: Linux, Solaris6.

Parámetros:

  • nombre - el nombre del proceso (el valor predeterminado es todos los procesos);
  • usuario - el nombre de usuario (el valor predeterminado es todos los usuarios);
  • tipo - el tipo de utilización de la CPU: total (predeterminado), user o system;
  • cmdline - filtrar por línea de comando (es una expresión) normal;
  • modo - el modo de recopilación de datos: avg1 (predeterminado), avg5 o avg15;
  • zona - la zona objetivo: current (predeterminado) o all. Este parámetro sólo se admite en Solaris.

Comentarios:

  • El valor devuelto se basa en un porcentaje de utilización de núcleo de CPU único. Por ejemplo, la utilización de CPU de un proceso que utiliza completamente dos núcleos es del 200%.
  • Los datos de utilización de la CPU del proceso son recopilados por un recopilador que admite un máximo de 1024 consultas únicas (por nombre, usuario y línea de comando). Las consultas a las que no se accedió durante las últimas 24 horas se eliminan del recopilador.
  • Al configurar el parámetro zone en actual (o predeterminado) en caso de que el agente haya sido compilado en un Solaris sin soporte de zona, pero ejecutándose en un Solaris más nuevo donde se admiten zonas, entonces el agente devolverá NOTSUPPORTED (el agente no puede limitar los resultados sólo a la zona actual). Sin embargo, en este caso se admite todo.

Ejemplos:

proc.cpu.util[,root] #Utilización de CPU de todos los procesos que se ejecutan bajo el usuario "root"
       proc.cpu.util[zabbix_server,zabbix] #Utilización de CPU de todos los procesos zabbix_server que se ejecutan bajo el usuario zabbix
proc.get[<nombre>,<usuario>,<cmdline>,<modo>]


La lista de procesos del sistema operativo y sus parámetros. Se puede utilizar para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Plataformas soportadas: Linux, FreeBSD, Windows, OpenBSD, NetBSD.

Parámetros:

  • nombre - el nombre del proceso (por defecto todos los procesos);
  • usuario - el nombre de usuario (por defecto todos los usuarios);
  • cmdline - filtrar por línea de comando (es una [expresión] normal (/manual/regular_expressions#overview)). Este parámetro no es compatible con Windows; en otras plataformas no se admite si el modo está configurado en "resumen".
  • modo - valores posibles:
    process (predeterminado), thread (no compatible con NetBSD), summary. Vea una lista de parámetros de proceso devueltos para cada modo y sistema operativo.

Comentarios:

  • Si no se puede recuperar un valor, por ejemplo, debido a un error (el proceso ya finalizó, falta de permisos, falla en la llamada al sistema), se devolverá -1;
  • Consulte las notas sobre la selección de procesos con parámetros name y cmdline (específicos de Linux).

Ejemplos:

proc.get[zabbix_server,zabbix,,process] #lista de todos los procesos zabbix_server que se ejecutan bajo el usuario zabbix, devuelve una entrada por PID
       proc.get[java,,,thread] #lista de todos los procesos Java, devuelve una entrada por hilo
       proc.get[,zabbix,,summary] #datos combinados para procesos de cada tipo que se ejecutan bajo el usuario zabbix, devuelve una entrada por nombre de proceso
proc.mem[<nombre>,<usuario>,<modo>,<cmdline>,<tipo de memoria>]


La memoria utilizada por el proceso en bytes.
Valor de retorno: Entero - con modo como max, min, sum; Float - con modo como avg
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, Tru64, OpenBSD, NetBSD.

Parámetros:

  • nombre - el nombre del proceso (el valor predeterminado es todos los procesos);
  • usuario - el nombre de usuario (el valor predeterminado es todos los usuarios);
  • modo - valores posibles: avg, max, min o sum (predeterminado);
  • cmdline - filtrar por línea de comando (es una [expresión] normal (/manual/regular_expressions#overview));
  • memtype - el tipo de memoria utilizado por el proceso

Comentarios:

  • El parámetro memtype solo se admite en Linux, FreeBSD, Solaris6, AIX;
  • Cuando varios procesos usan memoria compartida, la suma de la memoria utilizada por los procesos puede dar como resultado valores grandes y poco realistas.

    Consulte las notas sobre cómo seleccionar procesos con nombre y parámetros cmdline (específicos de Linux).

    Cuando este elemento se invoca desde la línea de comando y contiene un parámetro de línea de comando (por ejemplo, usando el modo de prueba del agente: zabbix_agentd -t proc.mem[,, ,apache2]), se contará un proceso extra, ya que el agente se contará a sí mismo.

Ejemplos:

proc.mem[,root] #la memoria utilizada por todos los procesos que se ejecutan bajo el usuario "root"
       proc.mem[zabbix_server,zabbix] #la memoria utilizada por todos los procesos zabbix_server que se ejecutan bajo el usuario zabbix
       proc.mem[,oracle,max,oracleZABBIX] #la memoria utilizada por el proceso que consume más memoria y se ejecuta en Oracle con oracleZABBIX en su línea de comando
proc.num[<nombre>,<usuario>,<estado>,<cmdline>,<zona>]


El número de procesos.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris6, HP-UX, AIX, Tru64, OpenBSD, NetBSD.

Parámetros:

  • nombre - el nombre del proceso (el valor predeterminado es todos los procesos);
  • usuario - el nombre de usuario (el valor predeterminado es todos los usuarios);
  • estado - valores posibles:
    all (predeterminado),
    disk - suspensión ininterrumpida,
    run - en ejecución,
    sleep - suspensión interrumpible,< br>trace - detenido,
    zomb - zombi;
  • cmdline - filtrar por línea de comando (es una expresión normal);
  • zona - la zona objetivo: current (predeterminada) o all. Este parámetro sólo se admite en Solaris.

Comentarios:

  • Los parámetros de estado disk y trace solo se admiten en Linux, FreeBSD, OpenBSD, NetBSD;
  • Cuando esta métrica se invoca desde la línea de comando y contiene un parámetro de línea de comando (por ejemplo, usando el modo de prueba del agente: zabbix_agentd -t proc.num[,,,apache2]), se contará un proceso adicional, como agente se contará a sí mismo;
  • Al configurar el parámetro zona en current (o predeterminado) en caso de que el agente haya sido compilado en un Solaris sin soporte de zona, pero ejecutándose en un Solaris más nuevo donde se admiten zonas, entonces el agente devolverá NOTSUPPORTED (el agente no puede limitar los resultados sólo a la zona actual). Sin embargo, en este caso se admite todo.
  • Consulte notas sobre la selección de procesos con parámetros name y cmdline (específicos de Linux).

Ejemplos:

proc.num[,mysql] #el número de procesos que se ejecutan bajo el usuario mysql
       proc.num[apache2,www-data] #el número de procesos apache2 que se ejecutan bajo el usuario www-data
       proc.num[,oracle,sleep,oracleZABBIX] #el número de procesos en estado de suspensión que se ejecutan en Oracle que tienen oracleZABBIX en su línea de comando
sensor[dispositivo,sensor,<modo>]


Lectura del sensor de hardware.
Valor de retorno: Flotador.
Plataformas compatibles: Linux, OpenBSD.

Parámetros:

  • dispositivo: el nombre del dispositivo; puede ser una expresión regular si se omite el modo;
  • sensor: el nombre del sensor; puede ser una expresión regular si se omite el modo;
  • modo - valores posibles: avg, max o min (si se omite este parámetro, el dispositivo y el sensor se tratan palabra por palabra).

Comentarios:

  • Lee /proc/sys/dev/sensors en Linux 2.4;
  • Lee /sys/class/hwmon en Linux 2.6+. Consulte una descripción más detallada del elemento sensor en Linux.
  • Lee la MIB hw.sensors en OpenBSD.

Ejemplo:

sensor[w83781d-i2c-0-2d,temp1]
       sensor[cpu0,temp0] #la temperatura de una CPU
       sensor["cpu[0-2]$",temp,avg] #la temperatura promedio de las tres primeras CPU
system.boottime


La hora de inicio del sistema.
Valor de retorno: Entero (marca de tiempo de Unix).
Plataformas compatibles: Linux, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

system.cpu.discovery


La lista de CPU/núcleos de CPU detectados. Se utiliza para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Consulte plataformas compatibles.

system.cpu.intr


Las interrupciones del dispositivo.
Valor de retorno: Entero.
Plataformas soportadas: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

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


La carga de CPU.
Valor de retorno: Flotante.
Consulte plataformas compatibles.

Parámetros:

  • cpu - valores posibles: all (predeterminado) o percpu (la carga total dividida por el recuento de CPU en línea);
  • modo - valores posibles: avg1 (promedio de un minuto, predeterminado), avg5 o avg15.

El parámetro percpu no es compatible con Tru64.

Ejemplo:

system.cpu.load[,avg5]
system.cpu.num[<tipo>]


El número de CPU.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.

Parámetro:

  • tipo - valores posibles: online (predeterminado) o máx

El parámetro de tipo max solo se admite en Linux, FreeBSD, Solaris y MacOS X.

Ejemplo:

system.cpu.num
system.cpu.switches


El recuento de cambios de contexto.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

system.cpu.util[<cpu>,<tipo>,<modo>,<lógico o físico>]


El porcentaje de utilización de la CPU.
Valor de retorno: Flotador.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, Tru64, OpenBSD, NetBSD.

Parámetros:

  • cpu - <número de CPU> o all (predeterminado);
  • tipo - valores posibles: user (predeterminado), idle, system, iowait, interrupt, softirq, steal, guest (en Kernels de Linux 2.6.24 y superiores), o guest_nice (en kernels de Linux 2.6.33 y superiores);
  • modo - valores posibles: avg1 (promedio de un minuto, predeterminado), avg5 o avg15;
  • lógico o físico - valores posibles: logical (predeterminado) o physical. Este parámetro sólo se admite en AIX.

Comentarios:

  • El parámetro de tipo nice solo se admite en Linux, FreeBSD, HP-UX, Tru64, OpenBSD, NetBSD.
  • El parámetro de tipo iowait solo se admite en Linux 2.6 y posteriores, Solaris, AIX.
  • El parámetro de tipo interrupt solo se admite en Linux 2.6 y posteriores, FreeBSD, OpenBSD.
  • Los parámetros de tipo softirq, steal, guest, guest_nice solo se admiten en Linux 2.6 y versiones posteriores.
  • Los parámetros de modo avg5 y avg15 son compatibles con Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.

Ejemplo:

system.cpu.util[0,user,avg5]
system.hostname[<tipo>,<transformación>]


El nombre del equipo del sistema.
Valor de retorno: Cadena.
Consulte plataformas compatibles.

Parámetros:

  • tipo - valores posibles: netbios (predeterminado en Windows), host (predeterminado en Linux) o shorthost (desde la versión 5.4.7; devuelve parte del nombre del host antes del primer punto, un completo cadena para nombres sin puntos);
  • transformar - valores posibles: none (predeterminado) o lower (convertir a minúsculas).

El valor se adquiere tomando nodename de la salida de la API del sistema uname().

Ejemplos de valores devueltos:

system.hostname → linux-w7x1
       system.hostname → ejemplo.com
       system.hostname[shorthost] → ejemplo
system.hw.chasis[<info>]


La información del chasis.
Valor de retorno: Cadena.
Plataformas compatibles: Linux.

Parámetro:

  • info - valores posibles: full (predeterminado), model, serial, type o vendor

Comentarios:

  • Esta clave de métrica depende de la disponibilidad de la tabla SMBIOS;
  • Intentará leer la tabla DMI desde sysfs, si el acceso a sysfs falla, intentará leer directamente desde la memoria;
  • Se requieren permisos de root porque el valor se adquiere leyendo desde sysfs o memoria.

Ejemplo:

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


La información de la CPU.
Valor de retorno: Cadena o Entero.
Plataformas compatibles: Linux.

Parámetros:

  • cpu - <número de CPU> o todos (predeterminado);
  • info - valores posibles: full (predeterminado), curfreq, maxfreq, model o vendor.

Comentarios:

  • Reúne información de /proc/cpuinfo y /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq;
  • Si se especifica un número de CPU y curfreq o maxfreq, se devuelve un valor numérico (Hz).

Ejemplo:

system.hw.cpu[0,vendor] → AuthenticAMD
system.hw.devices[<tipo>]


El listado de dispositivos PCI o USB.
Valor de retorno: Texto.
Plataformas compatibles: Linux.

Parámetro:

  • tipo - pci (predeterminado) o usb

Devuelve el resultado de la utilidad lspci o lsusb (ejecutada sin ningún parámetro).

Ejemplo:

system.hw.devices → 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge
system.hw.macaddr[<interfaz>,<formato>]


La lista de direcciones MAC.
Valor de retorno: Cadena.
Plataformas compatibles: Linux.

Parámetros:

  • interfaz - all (predeterminado) o una expresión normal;
  • formato - full (predeterminado) o short

Comentarios:

  • Enumera las direcciones MAC de las interfaces cuyo nombre coincide con la expresión regular interfaz dada (all lista para todas las interfaces);
  • Si "formato" se especifica como short, los nombres de interfaz y las direcciones MAC idénticas no aparecen en la lista.

Ejemplo:

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


La hora del sistema.
Valor de retorno: Entero - con tipo como utc; Cadena - con tipo como local.
Consulte plataformas compatibles.

Parámetros:

  • tipo - valores posibles: utc - (predeterminado) el tiempo desde la Época (00:00:00 UTC, 1 de enero de 1970), medido en segundos o local - el tiempo en el formato 'yyyy -mm-dd,hh:mm:ss.nnn,+hh:mm'

Debe usarse únicamente como comprobación pasiva.

Ejemplo:

system.localtime[local] #cree una métrica usando esta clave y luego úsela para mostrar la hora del equipo en el widget de tablero *Reloj*.
system.run[comando,<modo>]


Ejecute el comando especificado en el equipo.
Valor de retorno: Texto resultado del comando o 1 - con mode como nowait (independientemente del resultado del comando).
Consulte plataformas compatibles.

Parámetros:

  • comando - comando para ejecución;
  • modo - valores posibles: wait - espera el final de la ejecución (predeterminado) o nowait - no espera.

Comentarios:

  • Esta métrica está deshabilitada de forma predeterminada. Aprenda cómo habilitarlas;
  • El valor de retorno de la métrica es una salida estándar junto con un error estándar producido por el comando. La comprobación del código de salida no se realiza;
  • Para que se procese correctamente, el valor de retorno del comando debe ser del tipo de datos "texto". También se permite un resultado vacío;
  • El valor de retorno está limitado a 16 MB (incluidos los espacios en blanco finales que están truncados); los límites de la base de datos también se aplican;
  • Ver también: Ejecución de comando.

Ejemplo:

system.run[ls -l /] #devuelve una lista detallada de archivos del directorio raíz
system.stat[recurso,<tipo>]


Las estadísticas del sistema.
Valor de retorno: Entero o flotante.
Plataformas compatibles: AIX.

Parámetros:

  • ent: el número de unidades de procesador que esta partición tiene derecho a recibir (flotante);
  • kthr,<tipo> - información sobre los estados de los subprocesos del kernel:
    r - número promedio de subprocesos del kernel ejecutables (flotantes)
    b - número promedio de subprocesos del kernel colocados en la memoria virtual Cola de espera del administrador (flotante)
  • memory,<tipo> - información sobre el uso de la memoria virtual y real:
    avm - páginas virtuales activas (entero)
    fre - tamaño de la lista libre (entero)
  • page,<tipo> - información sobre errores de página y actividad de paginación:
    fi - entradas de páginas de archivos por segundo (flotante)
    fo - salidas de páginas de archivos por segundo (flotantes) )
    pi - páginas paginadas desde el espacio de paginación (flotante)
    po - páginas paginadas al espacio de paginación (flotante)
    fr - páginas liberadas (reemplazo de página) (flotante)< br>sr - páginas escaneadas mediante algoritmo de reemplazo de página (flotante)
  • faults,<tipo> - tasa de capturas e interrupciones:
    in - interrupciones del dispositivo (flotante)
    sy - llamadas al sistema (flotantes)
    cs - contexto del hilo del kernel interruptores (flotador)
  • cpu,<tipo> - desglose del porcentaje de uso del tiempo del procesador:
    us - tiempo de usuario (flotante)
    sy - tiempo del sistema (flotante)
    id - tiempo de inactividad (flotante)
    wa - tiempo de inactividad durante el cual el sistema tuvo solicitudes de E/S de disco/NFS pendientes (flotante)
    pc - número de procesadores físicos consumidos (flotante)<br >ec: el porcentaje de capacidad autorizada consumida (flotante)
    lbusy: indica el porcentaje de utilización de procesadores lógicos que se produjo durante la ejecución a nivel de usuario y sistema (flotante)
    app - indica los procesadores físicos disponibles en el grupo compartido (flotante)
  • disco,<tipo> - estadísticas del disco:
    bps - indica la cantidad de datos transferidos (leídos o escritos) a la unidad en bytes por segundo (entero)
    tps - indica el número de transferencias por segundo que se emitieron al disco/cinta físico (flotante)|

Comentarios:

  • Tome nota de las siguientes limitaciones en estas métricas:
    system.stat[cpu,app]: compatible solo con AIX LPAR de tipo "Compartido"
    system.stat[cpu,ec] - compatible con AIX LPAR de tipo "Compartido" y "Dedicado" ("Dedicado" siempre devuelve 100 (por ciento))
    system.stat[cpu,lbusy]: compatible solo con AIX LPAR de tipo "Compartido"
    system.stat[cpu,pc] - compatible con AIX LPAR de tipo "Compartido" y "Dedicado"
    system.stat[ent] - compatible con AIX LPAR de tipo "Compartido" y "Dedicado"
system.sw.arch


La información de la arquitectura del software.
Valor de retorno: Cadena.
Consulte plataformas compatibles.

La información se adquiere de la función uname().

Ejemplo:

system.sw.arch → i686
system.sw.os[<info>]


La información del sistema operativo.
Valor de retorno: Cadena.
Plataformas compatibles: Linux, Windows. Compatible con Windows desde Zabbix 6.4.

Parámetro:

  • info - valores posibles: full (predeterminado), short o name

La información se obtiene de (tenga en cuenta que no todos los archivos y opciones están presentes en todas las distribuciones):

  • /proc/version (full) en Linux;
  • /proc/version_signature (short) en Linux;
  • el parámetro PRETTY_NAME de /etc/os-release en sistemas Linux que lo soporten o /etc/issue.net (name);
  • la clave de registro HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion en Windows.

Ejemplos:

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ón detallada sobre el sistema operativo (versión, tipo, nombre de distribución, versión menor y mayor, etc.).
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux, Windows. Compatible desde Zabbix 6.4.

system.sw.packages[<regexp>,<administrador>,<formato>]


La lista de paquetes instalados.
Valor de retorno: Texto.
Plataformas compatibles: Linux.

Parámetros:

  • regexp - all (predeterminado) o una expresión normal;
  • administrador - all (predeterminado) o un administrador de paquetes;
  • formato - full (predeterminado) o short.

Comentarios:

  • Enumera (alfabéticamente) los paquetes instalados cuyo nombre coincide con la expresión regular dada (all los enumera todos);
  • Administradores de paquetes compatibles (comando ejecutado):
    dpkg (dpkg --get-selections)
    pkgtool (ls /var/log/packages)
    rpm (rpm -qa)
    pacman (pacman - P)
  • Si formato se especifica como full, los paquetes se agrupan por administradores de paquetes (cada administrador en una línea separada que comienza con su nombre entre corchetes);
  • Si se especifica "formato" como short, los paquetes no se agrupan y se enumeran en una sola línea.

Ejemplo:

system.sw.packages[mini,dpkg,short] → python-minimal, python2.6-minimal, ubuntu-minimal
system.sw.packages.get[<regexp>,<administrador>]


Una lista detallada de los paquetes instalados.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux. Compatible desde Zabbix 6.4.

Parámetros:

  • regexp - all (predeterminado) o una expresión normal;
  • manager - all (predeterminado) o un administrador de paquetes (valores posibles: rpm, dpkg, pkgtool o pacman).

Comentarios:

  • Devuelve JSON sin formato con los paquetes instalados cuyo nombre coincide con la expresión regular dada;
  • El resultado es una matriz de objetos, cada uno de los cuales contiene las siguientes claves: nombre, administrador, versión, tamaño, arquitectura, tiempo de compilación y tiempo de instalación (consulte más detalles).
system.swap.in[<dispositivo>,<tipo>]


Las estadísticas de intercambio (del dispositivo a la memoria).
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, OpenBSD.

Parámetros:

  • dispositivo: especifique el dispositivo utilizado para el intercambio (solo Linux) o all (predeterminado);
  • tipo - valores posibles: count (número de swapins, predeterminado en plataformas que no son Linux), sectors (sectores intercambiados) o pages (páginas intercambiadas, predeterminado en Linux).

Comentarios:

  • La fuente de esta información es:
    /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
    /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
  • Tenga en cuenta que las páginas solo funcionarán si no se especificó el dispositivo;
  • El parámetro de tipo sectores solo se admite en Linux.

Ejemplo:

system.swap.in[,pages]
system.swap.out[<dispositivo>,<tipo>]


Las estadísticas de intercambio (de la memoria al dispositivo).
Valor de retorno: Entero.
Plataformas soportadas: Linux, FreeBSD, OpenBSD.

Parámetros:

  • dispositivo: especifique el dispositivo utilizado para el intercambio (solo Linux) o all (predeterminado);
  • tipo - valores posibles: count (número de intercambios, predeterminado en plataformas que no son Linux), sectors (sectores intercambiados) o pages (páginas intercambiadas, predeterminado en Linux).

Comentarios:

  • La fuente de esta información es:
    /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
    /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
  • Tenga en cuenta que las páginas solo funcionarán si no se especificó el dispositivo;
  • El parámetro de tipo sectores solo se admite en Linux.

Ejemplo:

system.swap.out[,pages]
system.swap.size[<dispositivo>,<tipo>]


El tamaño del espacio de intercambio en bytes o en porcentaje del total.
Valor de retorno: Entero - para bytes; Flotador - para porcentaje.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, Tru64, OpenBSD.

Parámetros:

  • dispositivo: especifique el dispositivo utilizado para el intercambio (solo FreeBSD) o all (predeterminado);
  • tipo - valores posibles: free (espacio de intercambio libre, predeterminado), pfree (espacio de intercambio libre, en porcentaje), pused (espacio de intercambio utilizado, en porcentaje), total (total espacio de intercambio), o used (espacio de intercambio usado).

Comentarios:

  • Tenga en cuenta que pfree, pused no son compatibles con Windows si el tamaño de intercambio es 0;
  • Si no se especifica el dispositivo, el agente Zabbix solo tendrá en cuenta los dispositivos de intercambio (archivos), se ignorará la memoria física. Por ejemplo, en los sistemas Solaris, el comando swap -s incluye una parte de la memoria física y dispositivos de intercambio (a diferencia de swap -l).

Ejemplo:

system.swap.size[,pfree] → porcentaje de espacio de intercambio libre
system.uname


Identificación del sistema.
Valor de retorno: Cadena.
Consulte plataformas compatibles.

Comentarios:

  • En UNIX, el valor de este elemento se obtiene con la llamada al sistema uname();
  • En Windows, el elemento devuelve la arquitectura del sistema operativo, mientras que en UNIX devuelve la arquitectura de la CPU.|

Ejemplo (UNIX):

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


El tiempo de actividad del sistema en segundos.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. Se desconoce el soporte de Tru64.

En la configuración de la métrica, use unidades s o tiempo de actividad para obtener valores legibles.|

system.users.num


El número de usuarios que iniciaron sesión.
Valor de retorno: Entero.
Consulte plataformas compatibles.

El comando who se utiliza en el lado del agente para obtener el valor.

vfs.dev.discovery


La lista de dispositivos de bloque y su tipo. Se utiliza para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux.

vfs.dev.read[<dispositivo>,<tipo>,<modo>]


Estadísticas de lectura del disco.
Valor de retorno: Entero - con tipo en sectores, operaciones, bytes; Flotante - con tipo en sps, ops, bps.
Plataformas soportadas: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parámetros:

  • dispositivo - dispositivo de disco (el valor predeterminado es all 3);
  • tipo - valores posibles: sectors, operations, bytes, sps, ops o bps (sps, ops, bps representan: sectores , operaciones y bytes por segundo, respectivamente);
  • modo - valores posibles: avg1 (promedio de un minuto, predeterminado), avg5 o avg15. Este parámetro solo se admite con type en: sps, ops, bps.

Comentarios:

  • Si utiliza un intervalo de actualización de tres horas o más2, esta métrica siempre devolverá '0';
  • Los parámetros de tipo sectors y sps solo se admiten en Linux;
  • El parámetro de tipo ops sólo se admite en Linux y FreeBSD;
  • El parámetro de tipo bps sólo se admite en FreeBSD;
  • El parámetro de tipo bytes solo se admite en FreeBSD, Solaris, AIX, OpenBSD;
  • El parámetro mode solo se admite en Linux, FreeBSD;
  • Puede utilizar nombres de dispositivos relativos (por ejemplo, sda), así como un prefijo /dev/ opcional (por ejemplo, /dev/sda);
  • Se admiten volúmenes lógicos LVM;
  • Los valores predeterminados del parámetro 'tipo' para diferentes sistemas operativos:
    AIX - operaciones
    FreeBSD - bps
    Linux - sps
    OpenBSD - operaciones
    Solaris -bytes
  • sps, ops y bps en plataformas compatibles están limitados a 1024 dispositivos (1023 individuales y uno para todos).

Ejemplo:

vfs.dev.read[,operations]
vfs.dev.write[<dispositivo>,<tipo>,<modo>]


Las estadísticas de escritura del disco.
Valor de retorno: Entero - con tipo en sectors, operations, bytes; Flotante - con tipo en sps, ops, bps.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parámetros:

  • dispositivo - dispositivo de disco (el valor predeterminado es todos 3);
  • tipo - valores posibles: sectors, operations, bytes, sps, ops o bps (sps, ops, bps representan: sectores , operaciones y bytes por segundo, respectivamente);
  • modo - valores posibles: avg1 (promedio de un minuto, predeterminado), avg5 o avg15. Este parámetro solo se admite con tipo en: sps, ops, bps.

Comentarios:

  • Si utiliza un intervalo de actualización de tres horas o más2, esta métrica siempre devolverá '0';
  • Los parámetros de tipo sectors y sps solo se admiten en Linux;
  • El parámetro de tipo ops sólo se admite en Linux y FreeBSD;
  • El parámetro de tipo bps sólo se admite en FreeBSD;
  • El parámetro de tipo bytes solo se admite en FreeBSD, Solaris, AIX, OpenBSD;
  • El parámetro modo solo se admite en Linux, FreeBSD;
  • Puede utilizar nombres de dispositivos relativos (por ejemplo, sda), así como un prefijo /dev/ opcional (por ejemplo, /dev/sda);
  • Se admiten volúmenes lógicos LVM;
  • Los valores predeterminados del parámetro 'tipo' para diferentes sistemas operativos:
    AIX - operaciones
    FreeBSD - bps
    Linux - sps
    OpenBSD - operaciones
    Solaris -bytes
  • sps, ops y bps en plataformas compatibles están limitados a 1024 dispositivos (1023 individuales y uno para todos).

Ejemplo:

vfs.dev.write[,operations]
vfs.dir.count[dir,<regex incl>,<regex excl>,<tipos incl>,<tipos excl>,<profundidad máxima>,<tamaño mínimo>,<tamaño máximo>,<mínimo edad>,<edad máxima>,<regex excl dir>]


El recuento de entradas del directorio.
Valor de retorno: Entero.
Consulte plataformas compatibles.

Parámetros:

  • dir - la ruta absoluta al directorio;
  • regex incl - una expresión regular que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) a incluir; incluir todo si está vacío (valor predeterminado);
  • regex excl - una expresión normal que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) a excluir; no excluya ninguno si está vacío (valor predeterminado);
  • types incl - tipos de entradas de directorio para contar, valores posibles: file - archivo normal, dir - subdirectorio, sym - enlace simbólico, sock - socket, bdev - dispositivo de bloque, cdev - dispositivo de caracteres, fifo - FIFO, dev - sinónimo de "bdev,cdev", all - todos los tipos (predeterminado), es decir, "file,dir,sym,sock,bdev,cdev,fifo ". Varios tipos deben estar separados por comas y entre comillas.
  • tipos excl - tipos de entradas de directorio (consulte tipos incluidos) que NO se cuentan. Si algún tipo de entrada está tanto en "tipos incluidos" como en "tipos excluidos", las entradas de directorio de este tipo NO se cuentan.
  • profundidad máxima - la profundidad máxima de los subdirectorios a atravesar:
    -1 (predeterminado) - ilimitado,
    0 - no descender a subdirectorios.
  • tamaño mínimo: el tamaño mínimo (en bytes) para que se cuente el archivo. Los archivos más pequeños no se contarán. Se pueden utilizar sufijos de memoria.
  • tamaño máximo: el tamaño máximo (en bytes) del archivo que se va a contar. Los archivos más grandes no se contarán. Se pueden utilizar sufijos de memoria.
  • edad mínima: la edad mínima (en segundos) de entrada al directorio que se contará. Las entradas más recientes no se contarán. Se pueden utilizar sufijos de tiempo.
  • edad máxima: la edad máxima (en segundos) de la entrada al directorio que se contará. Las entradas cada vez más antiguas no se contabilizarán (tiempo de modificación). Se pueden utilizar sufijos de tiempo.
  • regex excl dir: una [expresión] normal (/manual/regular_expressions#overview) que describe el patrón de nombre del directorio a excluir. Se excluirá todo el contenido del directorio (a diferencia de regex_excl)

Comentarios:

  • Variables de entorno, p. %APP_HOME%, $HOME y %TEMP% no son compatibles;
  • Pseudodirectorios "." y ".." nunca se cuentan;
  • Los enlaces simbólicos nunca se siguen para recorrer el directorio;
  • Tanto regex incl como regex excl se aplican a archivos y directorios al calcular el recuento de entradas, pero se ignoran al seleccionar los subdirectorios para recorrer (si regex incl es “(?i)^.+\ .zip$” y max Depth no están configurados, entonces se recorrerán todos los subdirectorios, pero solo se contarán los archivos de tipo zip).
  • El tiempo de ejecución está limitado por el valor de tiempo de espera en el agente configuración (3 segundos). Dado que el recorrido de un directorio grande puede tardar más, no se devolverán datos y el elemento dejará de ser compatible. No se devolverá el recuento parcial.
  • Al filtrar por tamaño, sólo los archivos normales tienen tamaños significativos. En Linux y BSD, los directorios también tienen tamaños distintos de cero (normalmente unos pocos Kb). Los dispositivos tienen tamaños cero, p. el tamaño de /dev/sda1 no refleja el tamaño de la partición respectiva. Por lo tanto, cuando se utiliza <min_size> y <max_size>, es recomendable especificar <types_incl> como "archivo", para evitar sorpresas.

Ejemplos:

vfs.dir.count[/dev] #monitorea la cantidad de dispositivos en /dev (Linux)
vfs.dir.get[dir,<regex incl>,<regex excl>,<tipos incl>,<tipos excl>,<profundidad máxima>,<tamaño mínimo>,<tamaño máximo>,<mínimo edad>,<edad máxima>,<regex excl dir>]


La lista de entradas del directorio.
Valor de retorno: objeto JSON.
Consulte plataformas compatibles.

Parámetros:

  • dir - la ruta absoluta al directorio;
  • regex incl - una expresión regular que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) a incluir; incluir todo si está vacío (valor predeterminado);
  • regex excl - una expresión normal que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) a excluir; no excluya ninguno si está vacío (valor predeterminado);
  • types incl - tipos de entradas de directorio a enumerar, valores posibles: file - archivo normal, dir - subdirectorio, sym - enlace simbólico, sock - socket, bdev - dispositivo de bloque, cdev - dispositivo de caracteres, fifo - FIFO, dev - sinónimo de "bdev,cdev", all - todos los tipos (predeterminado), es decir, "file,dir,sym,sock,bdev,cdev,fifo ". Varios tipos deben estar separados por comas y entre comillas.
  • tipos excl - tipos de entradas de directorio (consulte tipos incluidos) para NO enumerar. Si algún tipo de entrada está tanto en "tipos incluidos" como en "tipos excluidos", las entradas de directorio de este tipo NO se enumeran.
  • profundidad máxima - la profundidad máxima de los subdirectorios a atravesar:
    -1 (predeterminado) - ilimitado,
    0 - no descender a subdirectorios.
  • tamaño mínimo: el tamaño mínimo (en bytes) para que el archivo aparezca en la lista. Los archivos más pequeños no aparecerán en la lista. Se pueden utilizar sufijos de memoria.
  • tamaño máximo: el tamaño máximo (en bytes) del archivo que se mostrará. Los archivos más grandes no aparecerán en la lista. Se pueden utilizar sufijos de memoria.
  • edad mínima: la edad mínima (en segundos) de la entrada del directorio que se incluirá en la lista. Las entradas más recientes no aparecerán en la lista. Se pueden utilizar sufijos de tiempo.
  • edad máxima: la edad máxima (en segundos) de la entrada del directorio que se incluirá en la lista. Las entradas cada vez más antiguas no aparecerán en la lista (tiempo de modificación). Se pueden utilizar sufijos de tiempo.
  • regex excl dir: una [expresión] normal (/manual/regular_expressions#overview) que describe el patrón de nombre del directorio a excluir. Se excluirá todo el contenido del directorio (a diferencia de regex excl)

Comentarios:

  • Variables de entorno, p. %APP_HOME%, $HOME y %TEMP% no son compatibles;
  • Pseudodirectorios "." y ".." nunca aparecen en la lista;
  • Los enlaces simbólicos nunca se siguen para recorrer el directorio;
  • Tanto regex incl como regex excl se aplican a archivos y directorios al generar la lista de entradas, pero se ignoran al seleccionar los subdirectorios para recorrer (si regex incl es “(?i)^.+\ .zip$” y max Depth no están configurados, entonces se recorrerán todos los subdirectorios, pero solo se contarán los archivos de tipo zip).
  • El tiempo de ejecución está limitado por el valor de tiempo de espera en la [configuración] (/manual/appendix/config/zabbix_agentd#timeout) del agente. Dado que el recorrido de un directorio grande puede tardar más, no se devolverán datos y el elemento dejará de ser compatible. No se devolverá la lista parcial.
  • Al filtrar por tamaño, sólo los archivos normales tienen tamaños significativos. En Linux y BSD, los directorios también tienen tamaños distintos de cero (normalmente unos pocos Kb). Los dispositivos tienen tamaños cero, p. el tamaño de /dev/sda1 no refleja el tamaño de la partición respectiva. Por lo tanto, cuando se utiliza min size y max size, es recomendable especificar types incl como "archivo", para evitar sorpresas.

Ejemplos:

vfs.dir.get[/dev] #recupera la lista de dispositivos en /dev (Linux)
vfs.dir.size[dir,<regex incl>,<regex excl>,<modo>,<profundidad máxima>,<regex excl dir>]


El tamaño del directorio (en bytes).
Valor de retorno: Entero.
Plataformas compatibles: Linux. La métrica puede funcionar en otras plataformas tipo UNIX.

Parámetros:

  • dir - la ruta absoluta al directorio;
  • regex incl - una expresión regular que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) a incluir; incluir todo si está vacío (valor predeterminado);
  • regex excl - una expresión regular que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) a excluir; no excluya ninguno si está vacío (valor predeterminado);
  • modo - valores posibles: aparent (predeterminado) - obtiene los tamaños de archivo aparentes en lugar del uso del disco (actúa como du -sb dir), disk - obtiene el uso del disco (actúa como du -s -B1 directorio). A diferencia del comando du, el elemento vfs.dir.size tiene en cuenta los archivos ocultos al calcular el tamaño del directorio (actúa como du -sb .[^.]* * dentro del directorio).
  • profundidad máxima: la profundidad máxima de los subdirectorios a recorrer: -1 (predeterminado): ilimitado, 0: no descender a subdirectorios.
  • regex excl dir: una [expresión] normal (/manual/regular_expressions#overview) que describe el patrón de nombre del directorio a excluir. Se excluirá todo el contenido del directorio (a diferencia de regex excl)

Comentarios:

  • Sólo se calculan los directorios con al menos permiso de lectura para el usuario zabbix. Para directorios con permiso de lectura únicamente, se calcula el tamaño del directorio en sí. Los directorios con permisos de lectura y ejecución se calculan incluyendo el contenido.
  • Con directorios grandes o unidades lentas, este elemento puede agotar el tiempo de espera debido a la configuración de Tiempo de espera en agent y server/proxy archivos de configuración. Aumente los valores de tiempo de espera según sea necesario.
  • El límite de tamaño de archivo depende de compatibilidad con archivos grandes.

Ejemplos:

vfs.dir.size[/tmp,log] #calcula el tamaño de todos los archivos en /tmp que contienen 'log' en sus nombres
       vfs.dir.size[/tmp,log,^.+\.old$] #calcula el tamaño de todos los archivos en /tmp que contienen 'log' en sus nombres, excluyendo los archivos con nombres que terminan en '.old'
vfs.file.cksum[archivo,<modo>]


La suma de comprobación del archivo, calculada mediante el algoritmo cksum de UNIX.
Valor de retorno: Integer - con mode como crc32, String - con mode como md5, sha256.
Consulte plataformas compatibles.

Parámetros:

  • archivo - la ruta completa al archivo;
  • modo - crc32 (predeterminado), md5 o sha256.

El límite de tamaño de archivo depende de la compatibilidad con archivos grandes.

Ejemplo:

vfs.file.cksum[/etc/passwd]

Ejemplo de valores devueltos (crc32/md5/sha256 respectivamente):

675436101
       9845acf68b73991eb7fd7ee0ded23c44
       ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc
vfs.file.contents[archivo,<codificación>]


Recuperando el contenido de un archivo7.
Valor de retorno: Texto.
Consulte plataformas compatibles.

Parámetros:

  • archivo - la ruta completa al archivo;
  • codificación - el identificador de la página de códigos.

Comentarios:

  • El valor de retorno está limitado a 16 MB (incluidos los espacios en blanco finales que están truncados); también se aplican los límites de la base de datos ;
  • Se devuelve una cadena vacía si el archivo está vacío o contiene únicamente caracteres LF/CR;
  • La marca de orden de bytes (BOM) se excluye de la salida.

Ejemplo:

vfs.file.contents[/etc/passwd]
vfs.file.exists[archivo,<tipos incluidos>,<tipos excluidos>]


Comprueba si el archivo existe.
Valor de retorno: 0 - no encontrado; 1: existe un archivo del tipo especificado.
Consulte plataformas compatibles.

Parámetros:

  • archivo - la ruta completa al archivo;
  • tipos incluidos - la lista de tipos de archivos a incluir, valores posibles: file (archivo normal, predeterminado (si tipos_excl no está configurado)), dir (directorio), sym (simbólico link), sock (socket), bdev (dispositivo de bloque), cdev (dispositivo de carácter), fifo (FIFO), dev (sinónimo de "bdev,cdev"), all ( todos los tipos mencionados, predeterminado si se establece tipos_excl).
  • tipos excl: la lista de tipos de archivos a excluir; consulte tipos_incl para conocer los posibles valores (de forma predeterminada, no se excluye ningún tipo)

Comentarios:

  • Varios tipos deben estar separados por una coma y el conjunto completo entre comillas "";
  • Si el mismo tipo está tanto en <tipos incluidos> como en <tipos excluidos>, los archivos de este tipo se excluyen;
  • El límite de tamaño de archivo depende de la compatibilidad con archivos grandes.

Ejemplos:

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[archivo]


Devuelve información sobre un archivo.
Valor de retorno: objeto JSON.
Consulte plataformas compatibles.

Parámetro:

  • archivo - la ruta completa al archivo

Comentarios:

  • Tipos de archivos admitidos en sistemas tipo UNIX: archivo normal, directorio, enlace simbólico, socket, dispositivo de bloque, dispositivo de caracteres, FIFO.
  • El límite de tamaño de archivo depende de la compatibilidad con archivos grandes.

Ejemplo:

vfs.file.get[/etc/passwd] #devuelve un JSON con información sobre el archivo /etc/passwd (tipo, usuario, permisos, SID, uid, etc.)
vfs.file.md5sum[archivo]


La suma de comprobación MD5 del archivo.
Valor de retorno: cadena de caracteres (hash MD5 del archivo).
Consulte las plataformas compatibles.

Parámetro:

  • archivo - la ruta completa al archivo

El límite de tamaño de archivo depende de la compatibilidad con archivos grandes.

Ejemplo:

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

Ejemplo de valor devuelto:

b5052decb577e0fffd622d6ddc017e82
vfs.file.owner[archivo,<tipo de propietario>,<tipo de resultado>]


Recupera el propietario de un archivo.
Valor de retorno: Cadena.
Consulte plataformas compatibles.

Parámetros:

  • archivo - la ruta completa al archivo;
  • tipo de propietario - user (predeterminado) o group (solo Unix);
  • tipo de resultado - name (predeterminado) o id; para id: devuelve uid/gid en Unix, SID en Windows.

El límite de tamaño de archivo depende de la compatibilidad con archivos grandes.

Ejemplo:

vfs.file.owner[/tmp/zabbix_server.log] #devuelve el propietario del archivo de /tmp/zabbix_server.log
       vfs.file.owner[/tmp/zabbix_server.log,,id] #devuelve el ID del propietario del archivo /tmp/zabbix_server.log
vfs.file.permissions[archivo]


Devuelve una cadena de 4 dígitos que contiene el número octal con permisos UNIX.
Valor de retorno: Cadena.
Plataformas compatibles: Linux. El elemento puede funcionar en otras plataformas tipo UNIX.

Parámetros:

  • archivo - la ruta completa al archivo

El límite de tamaño de archivo depende de la compatibilidad con archivos grandes.

Ejemplo:

vfs.file.permissions[/etc/passwd] #devuelve permisos de /etc/passwd, por ejemplo, '0644'
vfs.file.regexp[archivo,regexp,<codificación>,<línea inicial>,<línea final>,<salida>]


Recuperar una cadena en el archivo7.
Valor de retorno: la línea que contiene la cadena coincidente, o según lo especificado por el parámetro opcional salida.
Consulte las plataformas compatibles.

Parámetros:

  • archivo - la ruta completa al archivo;
  • regexp - una expresión regular que describe el patrón requerido;
  • codificación - el identificador de la página de códigos;
  • línea de inicio - el número de la primera línea a buscar (primera línea del archivo por defecto);
  • línea final - el número de la última línea a buscar (última línea del archivo por defecto);
  • salida: una plantilla de formato de salida opcional. La secuencia de escape \0 se reemplaza con la parte coincidente del texto (desde el primer carácter donde comienza la coincidencia hasta el carácter donde termina la coincidencia), mientras que \N (donde N=1... 9) la secuencia de escape se reemplaza con el enésimo grupo coincidente (o una cadena vacía si N excede el número de grupos capturados).

Comentarios:

  • El límite de tamaño de archivo depende de la compatibilidad con archivos grandes.
  • Sólo se devuelve la primera línea coincidente;
  • Se devuelve una cadena vacía si ninguna línea coincide con la expresión;
  • La marca de orden de bytes (BOM) se excluye de la salida;
  • La extracción de contenido mediante el parámetro "salida" se realiza en el agente.

Ejemplos:

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] → obteniendo el ID del usuario *zabbix*
vfs.file.regmatch[archivo,regexp,<codificación>,<línea inicial>,<línea final>]


Busque una cadena en el archivo7.
Valores de retorno: 0 - coincidencia no encontrada; 1 - encontrado.
Consulte las plataformas compatibles.

Parámetros:

  • archivo - la ruta completa al archivo;
  • regexp - una expresión regular que describe el patrón requerido;
  • codificación - el identificador de la página de códigos;
  • línea de inicio - el número de la primera línea a buscar (primera línea del archivo por defecto);
  • línea final: el número de la última línea a buscar (última línea del archivo de forma predeterminada).

Comentarios:

Ejemplo:

vfs.file.regmatch[/var/log/app.log,error]
vfs.file.size[archivo,<modo>]


El tamaño del archivo (en bytes).
Valor de retorno: Entero.
Consulte las plataformas compatibles.

Parámetros:

  • archivo - la ruta completa al archivo;
  • modo - valores posibles: bytes (predeterminado) o lines (las líneas vacías también se cuentan).

Comentarios:

Ejemplo:

vfs.file.size[/var/log/syslog]
vfs.file.time[archivo,<modo>]


La información de la hora del archivo.
Valor de retorno: Entero (marca de tiempo Unix).
Consulte plataformas compatibles.

Parámetros:

  • archivo - la ruta completa al archivo;
  • modo - valores posibles:
    modify (predeterminado) - la última vez que se modificó el contenido del archivo,
    access - la última vez que se leyó el archivo,
    change - el última vez que se cambiaron las propiedades del archivo

El límite de tamaño de archivo depende de la compatibilidad con archivos grandes.

Ejemplo:

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


La lista de sistemas de archivos montados con su tipo y opciones de montaje. Se utiliza para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.

vfs.fs.get


La lista de sistemas de archivos montados con su tipo, espacio disponible en disco, estadísticas de inodos y opciones de montaje. Se puede utilizar para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.

Comentarios:

  • También se informan los sistemas de archivos con un recuento de inodos igual a cero, lo que puede ser el caso de sistemas de archivos con inodos dinámicos (por ejemplo, btrfs);
  • Ver también: Descubrimiento de sistemas de archivos montados.
vfs.fs.inode[fs,<modo>]


El número o porcentaje de inodos.
Valor de retorno: Entero - para número; Flotante - para porcentaje.
Consulte plataformas compatibles.

Parámetros:

  • fs - el sistema de archivos;
  • modo - valores posibles: total (predeterminado), free, used, pfree (free, percentage) o pused (used, percentage).

Si el recuento de inodos es igual a cero, lo que puede ser el caso de sistemas de archivos con inodos dinámicos (por ejemplo, btrfs), los valores pfree/pused se informarán como "100" y "0" respectivamente.

Ejemplo:

vfs.fs.inode[/,pfree]
vfs.fs.size[fs,<modo>]


El espacio en disco en bytes o en porcentaje del total.
Valor de retorno: Entero - para bytes; Flotante - para porcentaje.
Consulte plataformas compatibles.

Parámetros:

  • fs - el sistema de archivos;
  • modo - valores posibles: total (predeterminado), free, used, pfree (free, percentage) o pused (used, percentage).

Comentarios:

  • Si el sistema de archivos no está montado, devuelve el tamaño de un sistema de archivos local donde se encuentra el punto de montaje;
  • El espacio reservado de un sistema de archivos se tiene en cuenta y no se incluye cuando se utiliza el modo free.

Ejemplo:

vfs.fs.size[/tmp,free]
vm.memory.size[<modo>]


El tamaño de la memoria en bytes o en porcentaje del total.
Valor de retorno: Entero - para bytes; Flotante - para porcentaje.
Consulte plataformas compatibles.

Parámetro:

  • modo - valores posibles: total (predeterminado), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (disponible, porcentaje).

Comentarios:

  • Esta métrica acepta tres categorías de parámetros:
    1) total - cantidad total de memoria
    2) tipos de memoria específicos de la plataforma: activa, anon, buffers, cached, * ejecutivo, archivo, libre, inactivo, fijado, compartido, losa, cableado
    3) estimaciones a nivel de usuario sobre cuánta memoria se usa y está disponible:
    usada , pused, disponible, pdisponible*
  • El parámetro de modo activo sólo se admite en FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD;
  • Los parámetros de modo anon, exec, file solo se admiten en NetBSD;
  • El parámetro de modo buffers solo se admite en Linux, FreeBSD, OpenBSD, NetBSD;
  • El parámetro modo cached solo se admite en Linux, FreeBSD, AIX, OpenBSD, NetBSD;
  • Los parámetros del modo inactivo, cableado sólo se admiten en FreeBSD, MacOS X, OpenBSD, NetBSD;
  • El parámetro de modo fijado solo se admite en AIX;
  • El parámetro modo compartido sólo se admite en Linux 2.4, FreeBSD, OpenBSD, NetBSD;
  • Consulte también detalles adicionales para este elemento.

Ejemplo:

vm.memory.size[pavailable]
web.page.get[host,<ruta>,<puerto>]


Obtener el contenido de una página web.
Valor de retorno: fuente de la página web como texto (incluidos los encabezados).
Consulte plataformas compatibles.

Parámetros:

  • host: el nombre del host o URL (como scheme://host:port/path, donde solo host es obligatorio). Esquemas de URL permitidos: http, https4. Un esquema faltante será tratado como http. Si se especifica una URL, "ruta" y "puerto" deben estar vacíos. Especificar el nombre de usuario/contraseña al conectarse a servidores que requieren autenticación, por ejemplo: http://usuario:contraseñ[email protected] solo es posible con soporte cURL 4 . Punycode se admite en los nombres de host.
  • ruta - la ruta a un documento HTML (el valor predeterminado es /);
  • puerto: el número de puerto (el valor predeterminado es 80 para HTTP)

Comentarios:

  • Este elemento deja de ser compatible si el recurso especificado en "host" no existe o no está disponible;
  • host puede ser un nombre de host, un nombre de dominio, una dirección IPv4 o IPv6. Pero para la dirección IPv6, el agente Zabbix debe compilarse con la compatibilidad con IPv6 habilitada.

Ejemplo:

página.web.get[www.ejemplo.com,index.php,80]
       página.web.get[https://www.ejemplo.com]
       web.page.get[https://blog.example.com/?s=zabbix]
       web.página.get[localhost:80]
       web.page.get["[::1]/server-status"]
web.page.perf[host,<ruta>,<puerto>]


El tiempo de carga de una página web completa (en segundos).
Valor de retorno: Flotador.
Consulte plataformas compatibles.

Parámetros:

  • host: el nombre del host o URL (como scheme://host:port/path, donde solo host es obligatorio). Esquemas de URL permitidos: http, https4. Un esquema faltante será tratado como http. Si se especifica una URL, "ruta" y "puerto" deben estar vacíos. Especificar el nombre de usuario/contraseña al conectarse a servidores que requieren autenticación, por ejemplo: http://usuario:contraseñ[email protected] solo es posible con soporte cURL 4 . Punycode es compatible con los nombres de host.
  • ruta - la ruta a un documento HTML (el valor predeterminado es /);
  • puerto: el número de puerto (el valor predeterminado es 80 para HTTP)

Comentarios:

  • Este elemento deja de ser compatible si el recurso especificado en "host" no existe o no está disponible;
  • host puede ser un nombre de host, un nombre de dominio, una dirección IPv4 o IPv6. Pero para la dirección IPv6, el agente Zabbix debe compilarse con la compatibilidad con IPv6 habilitada.

Ejemplo:

web.page.perf[www.example.com,index.php,80]
       web.page.perf[https://www.example.com]
web.page.regexp[host,<ruta>,<puerto>,regexp,<longitud>,<salida>]


Busque una cadena en la página web.
Valor de retorno: la cadena coincidente, o según lo especificado por el parámetro opcional salida.
Consulte plataformas compatibles.

Parámetros:

  • host: el nombre del host o URL (como scheme://host:port/path, donde solo host es obligatorio). Esquemas de URL permitidos: http, https4. Un esquema faltante será tratado como http. Si se especifica una URL, "ruta" y "puerto" deben estar vacíos. Especificar el nombre de usuario/contraseña al conectarse a servidores que requieren autenticación, por ejemplo: http://usuario:contraseñ[email protected] solo es posible con soporte cURL 4 . Punycode es compatible con los nombres de host.
  • ruta - la ruta a un documento HTML (el valor predeterminado es /);
  • puerto: el número de puerto (el valor predeterminado es 80 para HTTP)
  • regexp - una expresión regular que describe el patrón requerido;
  • longitud - el número máximo de caracteres a devolver;
  • salida: una plantilla de formato de salida opcional. La secuencia de escape \0 se reemplaza con la parte coincidente del texto (desde el primer carácter donde comienza la coincidencia hasta el carácter donde termina la coincidencia), mientras que \N (donde N=1... 9) la secuencia de escape se reemplaza con el enésimo grupo coincidente (o una cadena vacía si N excede el número de grupos capturados).

Comentarios:

  • Esta métrica deja de ser compatible si el recurso especificado en "host" no existe o no está disponible;
  • host puede ser un nombre de host, un nombre de dominio, una dirección IPv4 o IPv6. Pero para la dirección IPv6, el agente Zabbix debe compilarse con la compatibilidad con IPv6 habilitada.
  • La extracción de contenido mediante el parámetro "salida" se realiza en el agente.

Ejemplo:

web.page.regexp[www.example.com,index.php,80,OK,2]
       web.page.regexp[https://www.example.com,,,OK,2]|
agent.hostmetadata


Los metadatos del equipo del agente.
Valor de retorno: Cadena.
Consulte plataformas compatibles.

Devuelve el valor de los parámetros HostMetadata o HostMetadataItem, o una cadena vacía si no hay ninguno definido.

agent.hostname


El nombre de equipo del agente.
Valor de retorno: Cadena.
Consulte plataformas compatibles.

Devuelve:

  • Como comprobación pasiva: el nombre del primer equipo que figura en el parámetro Hostname del archivo de configuración del agente;
  • Como comprobación activa: el nombre del equipo actual.
agent.ping


La verificación de disponibilidad del agente.
Valor de retorno: Nada - no disponible; 1 - disponible.
Consulte plataformas compatibles.

Utilice la función de iniciador nodata() para comprobar si el equipo no está disponible.

agent.variant


La variante del agente Zabbix (agente Zabbix o agente Zabbix 2).
Valor de retorno: 1 - Agente Zabbix; 2 - Agente Zabbix 2.
Consulte plataformas compatibles.

agent.version


La versión del agente Zabbix.
Valor de retorno: Cadena.
Consulte plataformas compatibles.

Ejemplo de valor devuelto:

6.0.3
zabbix.stats[<ip>,<puerto>]


Devuelve un conjunto de métricas internas del servidor Zabbix o del proxy de forma remota.
Valor de retorno: objeto JSON.
Consulte plataformas compatibles.

Parámetros:

  • ip: la lista de IP/DNS/máscara de red de servidores/proxies que se consultarán de forma remota (el valor predeterminado es 127.0.0.1);
  • puerto: el puerto del servidor/proxy que se consultará de forma remota (el valor predeterminado es 10051)

Comentarios:

  • Esta métrica devuelve un conjunto seleccionado de métricas internas. Para obtener más información, consulte Monitoreo remoto de las estadísticas de Zabbix;
  • Tenga en cuenta que la solicitud de estadísticas solo se aceptará desde las direcciones enumeradas en el parámetro 'StatsAllowedIP' del servidor/proxy de la instancia objetivo.
zabbix.stats[<ip>,<puerto>,cola,<de>,<a>]


Devuelve la cantidad de métricas monitoreadas en la cola que están retrasados en el servidor Zabbix o en el proxy de forma remota.
Valor de retorno: objeto JSON.
Consulte plataformas compatibles.

Parámetros:

  • ip: la lista de IP/DNS/máscara de red de servidores/proxies que se consultarán de forma remota (el valor predeterminado es 127.0.0.1);
  • puerto: el puerto del servidor/proxy que se consultará de forma remota (el valor predeterminado es 10051)
  • queue - constante (para usar tal como está)
  • desde - retrasado al menos (el valor predeterminado es 6 segundos)
  • a - retrasado como máximo (el valor predeterminado es infinito)

Tenga en cuenta que la solicitud de estadísticas solo se aceptará desde las direcciones enumeradas en el parámetro 'StatsAllowedIP' del servidor/proxy en la instancia objetivo.

Claves de métricas admitidas

Las claves de métricas que puede utilizar con el agente Zabbix se enumeran a continuación.

Las claves de las métricas se enumeran sin parámetros ni información adicional. Haga clic en la clave de la métrica para ver todos los detalles.

Clave de métrica Descripción Grupo de métricas
kernel.maxfiles El número máximo de archivos abiertos admitidos por el sistema operativo. Kernel
kernel.maxproc El número máximo de procesos admitidos por el sistema operativo.
kernel.openfiles El número de descriptores de archivos abiertos actualmente.
log El monitoreo de un archivo de registro. Monitoreo de registro
log.count El recuento de líneas coincidentes en un archivo de registro monitoreado.
logrt La supervisión de un archivo de registro que se rota.
logrt.count El recuento de líneas coincidentes en un archivo de registro monitoreado que se rota.
modbus.get Lee datos Modbus. Modbus
net.dns Comprueba si el servicio DNS está activo. Red
net.dns.record Realiza una consulta DNS.
net.if.collisions El número de colisiones fuera de ventana.
net.if.discovery La lista de interfaces de red.
net.if.in Las estadísticas del tráfico entrante en una interfaz de red.
net.if.out Las estadísticas de tráfico saliente en una interfaz de red.
net.if.total La suma de las estadísticas de tráfico entrante y saliente en una interfaz de red.
net.tcp.listen Comprueba si este puerto TCP está en estado LISTEN.
net.tcp.port Comprueba si es posible realizar una conexión TCP al puerto especificado.
net.tcp.service Comprueba si un servicio se está ejecutando y acepta conexiones TCP.
net.tcp.service.perf Comprueba el rendimiento de un servicio TCP.
net.tcp.socket.count Devuelve el número de sockets TCP que coinciden con los parámetros.
net.udp.listen Comprueba si este puerto UDP está en estado LISTEN.
net.udp.service Comprueba si un servicio se está ejecutando y respondiendo a solicitudes UDP.
net.udp.service.perf Comprueba el rendimiento de un servicio UDP.
net.udp.socket.count Devuelve el número de sockets UDP que coinciden con los parámetros.
proc.cpu.util El porcentaje de utilización de CPU del proceso. Procesos
proc.get La lista de procesos del sistema operativo y sus parámetros.
proc.mem La memoria utilizada por el proceso en bytes.
proc.num El número de procesos.
sensor Lectura del sensor de hardware. Sensores
system.boottime La hora de inicio del sistema. Sistema
system.cpu.discovery La lista de CPU/núcleos de CPU detectados.
system.cpu.intr El dispositivo se interrumpe.
system.cpu.load La carga de la CPU.
system.cpu.num El número de CPU.
system.cpu.switches El recuento de cambios de contexto.
system.cpu.util El porcentaje de utilización de la CPU.
system.hostname El nombre del equipo del sistema.
system.hw.chassis La información del chasis.
system.hw.cpu La información de la CPU.
system.hw.devices El listado de dispositivos PCI o USB.
system.hw.macaddr La lista de direcciones MAC.
system.localtime La hora del sistema.
system.run Ejecute el comando especificado en el equipo.
system.stat Las estadísticas del sistema.
system.sw.arch La información de la arquitectura del software.
system.sw.os La información del sistema operativo.
system.sw.os.get Información detallada sobre el sistema operativo (versión, tipo, nombre de distribución, versión menor y mayor, etc.).
system.sw.packages La lista de paquetes instalados.
system.sw.packages.get Una lista detallada de los paquetes instalados.
system.swap.in Las estadísticas de intercambio (del dispositivo a la memoria).
system.swap.out Las estadísticas de intercambio (de la memoria al dispositivo).
system.swap.size El tamaño del espacio de intercambio en bytes o en porcentaje del total.
system.uname Identificación del sistema.
system.uptime El tiempo de actividad del sistema en segundos.
system.users.num El número de usuarios conectados.
vfs.dev.discovery La lista de dispositivos de bloque y su tipo. Sistemas de archivos virtuales
vfs.dev.read Las estadísticas de lectura del disco.
vfs.dev.write Las estadísticas de escritura en disco.
vfs.dir.count El recuento de entradas del directorio.
vfs.dir.get La lista de entradas del directorio.
vfs.dir.size El tamaño del directorio.
vfs.file.cksum La suma de comprobación del archivo, calculada mediante el algoritmo cksum de UNIX.
vfs.file.contents Recuperando el contenido de un archivo.
vfs.file.exists Comprueba si el archivo existe.
vfs.file.get Devuelve información sobre un archivo.
vfs.file.md5sum La suma de comprobación MD5 del archivo.
vfs.file.owner Recupera el propietario de un archivo.
vfs.file.permissions Devuelve una cadena de 4 dígitos que contiene el número octal con permisos UNIX.
vfs.file.regexp Recuperar una cadena en el archivo.
vfs.file.regmatch Busca una cadena en el archivo.
vfs.file.size El tamaño del archivo.
vfs.file.time La información de hora del archivo.
vfs.fs.discovery La lista de sistemas de archivos montados con su tipo y opciones de montaje.
vfs.fs.get La lista de sistemas de archivos montados con su tipo, espacio disponible en disco, estadísticas de inodos y opciones de montaje.
vfs.fs.inode El número o porcentaje de inodos.
vfs.fs.size El espacio en disco en bytes o en porcentaje del total.
vm.memory.size El tamaño de la memoria en bytes o en porcentaje del total. Memoria virtual
web.page.get Obtener el contenido de una página web. Monitoreo web
web.page.perf El tiempo de carga de una página web completa.
web.page.regexp Buscar una cadena en la página web.
agent.hostmetadata Los metadatos del host del agente. Zabbix
agent.hostname El nombre de equipo del agente.
agent.ping La verificación de disponibilidad del agente.
agent.variant La variante del agente Zabbix (agente Zabbix o agente Zabbix 2).
agent.version La versión del agente Zabbix.
zabbix.stats Devuelve un conjunto de métricas internas del servidor Zabbix o del proxy de forma remota.
zabbix.stats Devuelve el número de elementos monitoreados en la cola que están retrasados en el servidor Zabbix o en el proxy de forma remota.

Notas al pie

1Una nota específica de Linux. El agente de Zabbix debe tener acceso de solo lectura al sistema de archivos /proc. Los parches del kernel de www.grsecurity.org limitan los derechos de acceso de los usuarios no privilegiados.

2 vfs.dev.read[], vfs.dev.write[]: el agente Zabbix terminará las conexiones de dispositivos "obsoletas" si no se accede a los valores de la métrica durante más de 3 horas. Esto puede suceder si un sistema tiene dispositivos con rutas cambiando dinámicamente o si un dispositivo se elimina manualmente. Tenga en cuenta también que estas métricas, si utilizan un intervalo de actualización de 3 horas o más, siempre se devolverán '0'.

3 vfs.dev.read[], vfs.dev.write[]: si se usa all por defecto para el primer parámetro, la clave devolverá estadísticas resumidas, incluidos todos los dispositivos de bloque como sda, sdb y sus particiones (sda1, sda2, sdb3...) y múltiples dispositivos (MD raid) basados en esos bloques dispositivos/particiones y volúmenes lógicos (LVM) basados en esos bloques dispositivos/particiones. En tales casos, se deben considerar los valores devueltos. sólo como valor relativo (dinámico en el tiempo) pero no como valores absolutos.

4 SSL (HTTPS) solo se admite si el agente se compila con soporte cURL. De lo contrario, la métrica quedará sin soporte.

5 Los valores bytes y errors no se admiten para interfaces de bucle invertido en sistemas Solaris hasta Solaris 10 6/06 inclusive, ya que el sistema no almacena ni informa estadísticas de bytes, errores y utilización. núcleo. Sin embargo, si está monitoreando un sistema Solaris a través de net-snmp, es posible que se devuelvan valores ya que net-snmp contiene un código heredado de cmu-snmp con fecha de 1997 que, al no poder leer los valores de bytes de las estadísticas de la interfaz, devuelve el contador de paquetes (que existe en las interfaces loopback) multiplicado por un valor arbitrario de 308. Esto supone que la longitud promedio de un paquete es 308 octetos, lo cual es una estimación muy aproximada ya que el límite de MTU en los sistemas Solaris para interfaces loopback es 8892 bytes. No se debe suponer que estos valores sean correctos o incluso muy precisos. Son estimaciones aproximadas. El agente Zabbix no hace ninguna conjetura, pero net-snmp devolverá un valor para estos campos.

6 La línea de comando en Solaris, obtenida de /proc/pid/psinfo, está limitada a 80 bytes y contiene la línea de comando tal como estaba cuando se inició el proceso.

7 Las métricas vfs.file.contents[], vfs.file.regexp[], vfs.file.regmatch[] se pueden utilizar para recuperar el contenido del archivo. Si desea restringir el acceso a archivos específicos con información confidencial, ejecute el agente Zabbix con un usuario que no tenga permisos de acceso para ver estos archivos.

Uso con utilidades de línea de comandos

Tenga en cuenta que al probar o utilizar claves de métricas con zabbix_agentd o zabbix_get desde la línea de comando también debe considerar la sintaxis del shell.

Por ejemplo, si un determinado parámetro de la clave debe estar entre comillas dobles tiene que escapar explícitamente las comillas dobles; de lo contrario, el shell las recortará como caracteres especiales y no se pasarán a la utilidad Zabbix.

Ejemplos:

$ zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'
       
       $ zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]

Configuración de codificación

Para asegurarse de que los datos adquiridos no estén dañados, puede especificar la codificación correcta para procesar la comprobación (por ejemplo, 'vfs.file.contents') en el parámetro codificación. La lista de codificaciones admitidas (identificadores de página de códigos) se pueden encontrar en la documentación para libiconv (Proyecto GNU) o en la Documentación del SDK de Microsoft Windows para "Identificadores de página de códigos".

Si no se especifica ninguna codificación en el parámetro "codificación", se aplican las siguientes estrategias de resolución:

  • Si no se especifica la codificación (o es una cadena vacía), se supone que es UTF-8, los datos se procesan "tal cual";
  • Análisis de BOM: aplicable para las métricas 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. Se intenta determinar la codificación correcta utilizando la marca de orden de bytes (BOM) en el comienzo del archivo. Si la marca BOM no está presente: se aplica la resolución estándar (ver arriba).

Solución de problemas de métricas del agente

  • Si se usa con el agente pasivo, el valor del Tiempo de espera en la configuración del servidor puede que deba ser superior al Tiempo de espera en el archivo de configuración del agente. De lo contrario, es posible que la métrica no obtenga ningún valor porque la solicitud del servidor al agente expiró primero.