Zabbix agent

Descripción general

Esta sección proporciona detalles sobre las claves de item que utilizan la comunicación con el agent de Zabbix para la recopilación de datos.

Hay comprobaciones de agent pasivas y activas. Al configurar un item, puede seleccionar el tipo requerido:

• Zabbix agent - para comprobaciones pasivas
• Zabbix agent (active) - para comprobaciones activas

Tenga en cuenta que todas las claves de item compatibles con Zabbix agent también son compatibles con la nueva generación de Zabbix agent 2. Consulte las claves de item adicionales que puede usar solo con agent 2.

Claves de item compatibles

Las claves de item que puede usar con Zabbix agent se enumeran a continuación.

Las claves de item se enumeran sin parámetros ni información adicional. Haga clic en la clave de item para ver los detalles completos.

Plataformas compatibles

Salvo que se especifique lo contrario en los detalles del elemento, los elementos del agente (y todos los parámetros) son compatibles con:

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

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

Detalles de la clave del elemento

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

kernel.maxfiles

El número máximo de archivos abiertos soportados por el sistema operativo.
Valor de retorno: Entero.
Plataformas soportadas: Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.

kernel.maxproc

El número máximo de procesos soportados por el sistema operativo.
Valor de retorno: Entero.
Plataformas soportadas: 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 soportadas: Linux (la métrica puede funcionar en otras plataformas tipo UNIX).

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

La supervisión de un archivo de registro.
Valor devuelto: Log.
Consulte las plataformas compatibles.

Parámetros:

• file - la ruta completa y el nombre de un archivo de registro;
  
• regexp - una expresión regular que describe el patrón requerido;
  
• encoding - el identificador de la página de códigos;
  
• maxlines - el número máximo de nuevas líneas por segundo que el agent enviará a Zabbix server o proxy. Este parámetro anula el valor de MaxLinesPerSecond en zabbix_agentd.conf;
  
• mode - valores posibles:
  • all (predeterminado);
  • skip - omite el procesamiento de datos antiguos (afecta solo a los items creados recientemente);
    
• output - una template opcional de formato de salida. La secuencia de escape \0 se reemplaza por la parte coincidente del texto (desde el primer carácter donde comienza la coincidencia hasta el carácter donde termina la coincidencia), mientras que una secuencia de escape \N (donde N=1...9) se reemplaza por el N-ésimo grupo coincidente (o una cadena vacía si N supera el número de grupos capturados);
  
• maxdelay - el retraso máximo en segundos. Tipo: float. Valores:
  • 0 - (predeterminado) nunca ignora las líneas del archivo de registro;
  • > 0.0 - ignora las líneas más antiguas para que las líneas más recientes se analicen dentro de los "maxdelay" segundos. ¡Lea las notas de maxdelay antes de usarlo!
    
• options - opciones adicionales:
  mtime-noreread - registros no únicos, volver a leer solo si cambia el tamaño del archivo (ignorar el cambio de la hora de modificación). (Este parámetro está obsoleto desde 5.0.2, porque ahora se ignora mtime.)
  
• persistent dir (solo en zabbix_agentd en sistemas Unix; no compatible con Zabbix agent 2) - la ruta absoluta del directorio donde almacenar los archivos persistentes. Consulte también las notas adicionales sobre archivos persistentes.

Comentarios:

• El item debe configurarse como una comprobación activa.
• Si el archivo no existe o los permisos no permiten el acceso, el item pasa a no compatible.
• Si output se deja vacío, se devuelve toda la línea que contiene el texto coincidente. Tenga en cuenta que todos los tipos de expresión regular global, excepto 'Result is TRUE', siempre devuelven la línea completa coincidente y el parámetro output se ignora.
• La extracción de contenido mediante el parámetro output se realiza en el agent.

Ejemplos:

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

Ejemplo de uso del parámetro output para extraer un número de un registro de log:

log[/app1/app.log,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.

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

log[/app1/app.log,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to the server.

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

El número de líneas coincidentes en un archivo de registro supervisado.
Valor de retorno: Integer.
Consulte las plataformas compatibles.

Parámetros:

• file - la ruta completa y el nombre del archivo de registro;
  
• regexp - una expresión regular que describe el patrón requerido;
  
• encoding - el identificador de la página de códigos;
  
• maxproclines - el número máximo de nuevas líneas por segundo que el agent analizará (no puede superar 10000). El valor predeterminado es 10*MaxLinesPerSecond en zabbix_agentd.conf.
  
• mode - valores posibles:
  • all (predeterminado);
  • skip - omite el procesamiento de datos más antiguos (afecta solo a los items creados recientemente).
    
• maxdelay - el retraso máximo en segundos. Tipo: float. Valores:
  • 0 - (predeterminado) nunca ignora líneas del archivo de registro;
  • > 0.0 - ignora las líneas más antiguas para que las líneas más recientes se analicen dentro de los segundos de "maxdelay". ¡Lea las notas de maxdelay antes de usarlo!
    
• options - opciones adicionales:
  mtime-noreread - registros no únicos, vuelve a leer solo si cambia el tamaño del archivo (ignora el cambio de la hora de modificación). (Este parámetro está obsoleto desde la versión 5.0.2, porque ahora se ignora mtime.)
  
• persistent dir (solo en zabbix_agentd en sistemas Unix; no compatible con Zabbix agent 2) - la ruta absoluta del directorio donde almacenar los archivos persistentes. Consulte también las notas adicionales sobre archivos persistentes.

Comentarios:

• El item debe configurarse como una comprobación activa.
• Las líneas coincidentes se cuentan en las nuevas líneas desde la última comprobación del registro por parte del agent, y por lo tanto dependen del intervalo de actualización del item.
• Si el archivo no existe o los permisos no permiten el acceso, el item pasa a no compatible.

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

La monitorización de un archivo de log que se rota.
Valor devuelto: Log.
Consulte las plataformas compatibles.

Parámetros:

• file regexp - la ruta absoluta al archivo, con el nombre de archivo especificado mediante una expresión regular. Tenga en cuenta que la expresión regular se aplica solo al nombre del archivo y no necesita coincidir con el nombre completo (por ejemplo, /path/to/agent coincidirá con zabbix_agentd.log).
  
• regexp - una expresión regular que describe el patrón de contenido requerido.
  
• encoding - el identificador de la página de códigos.
  
• maxlines - el número máximo de nuevas líneas por segundo que el agent enviará al server o proxy. Este parámetro anula el valor de MaxLinesPerSecond en zabbix_agentd.conf.
  
• mode - valores posibles:
  • all (predeterminado);
  • skip - omite el procesamiento de datos antiguos (afecta solo a los items creados recientemente).
    
• output - una plantilla opcional de formato de salida. La secuencia de escape \0 se reemplaza por la parte del texto coincidente (desde el primer carácter donde comienza la coincidencia hasta el carácter donde termina la coincidencia), mientras que una secuencia de escape \N (donde N=1...9) se reemplaza por el N-ésimo grupo coincidente (o una cadena vacía si N supera el número de grupos capturados).
  
• maxdelay - el retraso máximo en segundos. Tipo: float. Valores:
  • 0 - (predeterminado) nunca ignorar líneas del archivo de log;
  • > 0.0 - ignorar líneas más antiguas para obtener las líneas más recientes analizadas dentro de "maxdelay" segundos. Lea las notas de maxdelay antes de usarlo!
    
• options - el tipo de rotación del archivo de log y otras opciones. Valores posibles:
  • rotate (predeterminado).
  • copytruncate - tenga en cuenta que copytruncate no se puede usar junto con maxdelay. En este caso, maxdelay debe ser 0 o no especificarse; consulte las notas de copytruncate.
  • mtime-reread - registros no únicos, volver a leer si cambia la hora de modificación o el tamaño (se usa de forma predeterminada si no se establece explícitamente ninguna opción mtime-*).
  • mtime-noreread - registros no únicos, volver a leer solo si cambia el tamaño (ignorar el cambio de la hora de modificación).
    
• persistent dir (solo en zabbix_agentd en sistemas Unix; no compatible con Zabbix agent 2) - la ruta absoluta del directorio donde almacenar los archivos persistentes. Consulte también las notas adicionales sobre archivos persistentes.

Comentarios:

• El item debe configurarse como una comprobación activa.
• La rotación del log se basa en la última hora de modificación de los archivos.
• Tenga en cuenta que logrt está diseñado para funcionar con un solo archivo de log activo en ese momento, con varios otros archivos inactivos coincidentes rotados. Si, por ejemplo, un directorio tiene muchos archivos de log activos, se debe crear un item logrt independiente para cada uno. De lo contrario, si un item logrt recoge demasiados archivos, puede provocar agotamiento de memoria y un fallo de la monitorización.
• Si output se deja vacío, se devuelve toda la línea que contiene el texto coincidente. Tenga en cuenta que todos los tipos de expresiones regulares globales, excepto 'Result is TRUE', siempre devuelven la línea completa coincidente y el parámetro output se ignora.
• La extracción de contenido mediante el parámetro output se realiza en el agent.
• En el parámetro file regexp, la ruta del directorio de log y la expresión regular del archivo de log deben separarse con el separador de directorio correcto:
  • En Windows, el separador debe ser una barra invertida (\); las barras diagonales pueden tolerarse en otras posiciones, excepto en la que separa la ruta del directorio de log y la expresión regular del archivo de log (consulte los ejemplos a continuación).
  • En otros sistemas, debe ser una barra diagonal (/).

Ejemplos para Windows:

logrt["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #this item will collect data from log files in "c:/dir1/dir2/dir3" where the file name starts with "filename" and ends with any extension matching ".log".
logrt["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #this item will collect data from log files in the network share "//example.com/share/dir1/dir2/dir3" where the file name starts with "filename" and ends with any extension matching ".log".

Ejemplos para otros sistemas:

logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] #this item will match a file like "logfile1" (will not match ".logfile1").
logrt["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #this item will collect data from files such as "logfile_abc_1" or "logfile__001".

Ejemplo de uso del parámetro output para extraer un número de un registro de log:

logrt[/app1/^test.*log$,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.

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

logrt[/app1/^test.*log$,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server.

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

El conteo de líneas coincidentes en un archivo de log monitoreado que está rotado.
Valor devuelto: Integer.
Consulte las plataformas compatibles.

Parámetros:

• file regexp - la ruta absoluta al archivo, con el nombre de archivo especificado mediante una expresión regular. Tenga en cuenta que la expresión regular se aplica solo al nombre del archivo y no necesita coincidir con el nombre completo (por ejemplo, /path/to/agent coincidirá con zabbix_agentd.log).
• regexp - una expresión regular que describe el patrón requerido.
• encoding - el identificador de la página de códigos.
• maxproclines - el número máximo de nuevas líneas por segundo que el agent analizará (no puede superar 10000). El valor predeterminado es 10*MaxLinesPerSecond en zabbix_agentd.conf.
• mode - valores posibles:
  • all (predeterminado);
  • skip - omite el procesamiento de datos más antiguos (afecta solo a los items creados recientemente).
• maxdelay - el retraso máximo en segundos. Tipo: float. Valores:
  • 0 - (predeterminado) nunca ignora líneas del archivo de log;
  • > 0.0 - ignora líneas más antiguas para que las líneas más recientes se analicen dentro de los segundos de "maxdelay". Lea las notas de maxdelay antes de usarlo!
    
• options - el tipo de rotación del archivo de log y otras opciones. Valores posibles:
  • rotate (predeterminado).
  • copytruncate - tenga en cuenta que copytruncate no puede usarse junto con maxdelay. En este caso maxdelay debe ser 0 o no especificarse; consulte las notas de copytruncate.
  • mtime-reread - registros no únicos, volver a leer si cambia la hora de modificación o el tamaño (predeterminado).
  • mtime-noreread - registros no únicos, volver a leer solo si cambia el tamaño (ignorar el cambio de la hora de modificación).
    
• persistent dir (solo en zabbix_agentd en sistemas Unix; no compatible con Zabbix agent 2) - la ruta absoluta del directorio donde almacenar los archivos persistentes. Consulte también las notas adicionales sobre archivos persistentes.

Comentarios:

• El item debe configurarse como una comprobación activa.
• Las líneas coincidentes se cuentan en las nuevas líneas desde la última comprobación del log por parte del agent, y por lo tanto dependen del intervalo de actualización del item.
• La rotación del log se basa en la última hora de modificación de los archivos.
• En el parámetro file regexp, la ruta del directorio del log y la expresión regular del archivo de log deben separarse con el separador de directorio correcto:
  • En Windows, el separador debe ser una barra invertida (\); las barras diagonales (/) pueden tolerarse en otras posiciones, excepto en la que separa la ruta del directorio del log y la expresión regular del archivo de log (consulte los ejemplos a continuación).
  • En otros sistemas, debe ser una barra diagonal (/).

Ejemplos para Windows:

logrt.count["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #este item contará el número de coincidencias del patrón "pattern_to_match" en los archivos de log ubicados en "c:/dir1/dir2/dir3".
logrt.count["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #este item contará el número de coincidencias del patrón "pattern_to_match" en los archivos de log de la unidad de red "//example.com/share/dir1/dir2/dir3".

Ejemplos para otros sistemas:

logrt.count["/home/zabbix/logs/.*","^logfile[0-9]{1,3}$",,100] #este item contará el número de coincidencias del patrón "^logfile[0-9]{1,3}$" en los archivos de log del directorio "/home/zabbix/logs".
logrt.count["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #este item contará el número de ocurrencias del patrón "pattern_to_match" en los archivos de log ubicados en "/home/user".

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

Lee datos Modbus.
Valor devuelto: cadena JSON.
Plataformas compatibles: Linux, Windows.

Parámetros:

• endpoint - el endpoint definido como protocol://connection_string;
  
• slave id - el ID del esclavo;
  
• function - la función Modbus;
  
• address - la dirección del primer registro, bobina o entrada;
  
• count - el número de registros a leer;
  
• type - el tipo de datos;
  
• endianness - la configuración de endianness;
  
• offset - el número de registros, comenzando desde address, cuyos resultados se descartarán.

En Windows, este item sigue rutas UNC en el parámetro endpoint, lo que puede suponer un riesgo de seguridad.

Consulte una descripción detallada de los parámetros.

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

Comprueba el estado de un servicio DNS.
Valores devueltos:

• 0 - la resolución DNS falló (el servidor DNS no respondió o devolvió un error);
• 1 - la resolución DNS se realizó correctamente.
  Consulte las plataformas compatibles.

Parámetros:

• ip (se ignora en Windows salvo que se use Zabbix agent 2) - la dirección IP del servidor DNS (deje el campo vacío para usar el servidor DNS predeterminado);
• name - el nombre DNS que se va a consultar;
• type - el tipo de registro que se va a consultar (el valor predeterminado es SOA);
• timeout (se ignora en Windows salvo que se use Zabbix agent 2) - el tiempo de espera de la solicitud en segundos (el valor predeterminado es 1 segundo);
• count (se ignora en Windows salvo que se use Zabbix agent 2) - el número de intentos de la solicitud (el valor predeterminado es 2);
• protocol - el protocolo usado para realizar consultas DNS: udp (predeterminado) o tcp.

Comentarios:

• Los valores posibles de type 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 SO), HINFO, MINFO, TXT, SRV.
• Para búsquedas DNS inversas (cuando type está establecido en PTR), puede proporcionar el nombre DNS tanto en formato invertido como no invertido (consulte los ejemplos a continuación). Tenga en cuenta que, cuando se solicita un registro PTR, el nombre DNS en realidad es una dirección IP.
• Los nombres de dominio internacionalizados no son compatibles; utilice en su lugar nombres codificados en IDNA.

Ejemplos:

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

net.dns[,198.51.100.1,PTR]
net.dns[,1.100.51.198.in-addr.arpa,PTR]

net.dns[,2a00:1450:400f:800::200e,PTR]
net.dns[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]

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

Comprueba el rendimiento de un servicio DNS.
Valor devuelto: Float (0 - el servicio está caído; segundos - la cantidad de segundos empleados esperando una respuesta del servicio).
Consulte plataformas compatibles.

Parámetros:

• ip (se ignora en Windows salvo que se use Zabbix agent 2) - la dirección IP del servidor DNS (deje vacío para usar el servidor DNS predeterminado);
• name - el nombre DNS que se va a consultar;
• type - el tipo de registro que se va a consultar (el valor predeterminado es SOA);
• timeout (se ignora en Windows salvo que se use Zabbix agent 2) - el tiempo de espera de la solicitud en segundos (el valor predeterminado es 1 segundo);
• count (se ignora en Windows salvo que se use Zabbix agent 2) - el número de intentos para la solicitud (el valor predeterminado es 2);
• protocol - el protocolo utilizado para realizar consultas DNS: udp (predeterminado) o tcp.

Comentarios:

• Los valores posibles para type 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 SO), HINFO, MINFO, TXT, SRV.
• Para búsquedas DNS inversas (cuando type se establece en PTR), puede proporcionar el nombre DNS tanto en formato invertido como no invertido (consulte los ejemplos a continuación). Tenga en cuenta que, cuando se solicita un registro PTR, el nombre DNS en realidad es una dirección IP.
• Los nombres de dominio internacionalizados no son compatibles; utilice en su lugar nombres codificados en IDNA.
• El item devuelve un tiempo de respuesta en lugar de 0 cuando el servidor DNS responde con un código de error (por ejemplo, NXDOMAIN o SERVFAIL).

Ejemplos:

net.dns.perf[198.51.100.1,example.com,MX,2,1]

net.dns.perf[,198.51.100.1,PTR]
net.dns.perf[,1.100.51.198.in-addr.arpa,PTR]

net.dns.perf[,2a00:1450:400f:800::200e,PTR]
net.dns.perf[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]

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

Realiza una consulta DNS.

Zabbix agent 2 también proporciona net.dns.get, que ofrece funciones adicionales, como más tipos de registros y mayor control sobre la supervisión DNS. Valor devuelto: una cadena de caracteres con el tipo de información requerido.
Consulte las plataformas compatibles.

Parámetros:

• ip (se ignora en Windows salvo que se use Zabbix agent 2) - la dirección IP del servidor DNS (deje el campo vacío para usar el servidor DNS predeterminado);
• name - el nombre DNS que se va a consultar;
• type - el tipo de registro que se va a consultar (el valor predeterminado es SOA);
• timeout (se ignora en Windows salvo que se use Zabbix agent 2) - el tiempo de espera de la solicitud en segundos (el valor predeterminado es 1 segundo);
• count (se ignora en Windows salvo que se use Zabbix agent 2) - el número de intentos de la solicitud (el valor predeterminado es 2);
• protocol - el protocolo utilizado para realizar consultas DNS: udp (predeterminado) o tcp.

Comentarios:

• Los valores posibles para type 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 SO), HINFO, MINFO, TXT, SRV.
• Para búsquedas DNS inversas (cuando type se establece en PTR), puede proporcionar el nombre DNS en formato invertido o no invertido (consulte los ejemplos a continuación). Tenga en cuenta que, cuando se solicita un registro PTR, el nombre DNS en realidad es una dirección IP.
• Los nombres de dominio internacionalizados no son compatibles; utilice en su lugar nombres codificados en IDNA.

Ejemplos:

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

net.dns.record[,198.51.100.1,PTR]
net.dns.record[,1.100.51.198.in-addr.arpa,PTR]

net.dns.record[,2a00:1450:400f:800::200e,PTR]
net.dns.record[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]

net.if.collisions[if]

El número de colisiones fuera de ventana.
Valor de retorno: Entero.
Plataformas soportadas: 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 el descubrimiento de bajo nivel.
Valor devuelto: cadena JSON.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD, Windows.

net.if.get[<regexp>]

La lista de interfaces de red con información detallada.
Se usa para el descubrimiento de bajo nivel.
Este item es una versión ampliada del item de Zabbix agent net.if.discovery.
Valor devuelto: objeto JSON.
Plataformas compatibles: Linux.

Parámetros:

• regexp - una expresión regular que coincide con los nombres de las interfaces de red.
  

Comentarios:

• Devuelve un objeto JSON con las interfaces de red cuyos nombres coinciden con la expresión regular dada (ver más detalles).

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

Las estadísticas de tráfico entrante en una interfaz de red.
Valor devuelto: Integer.
Plataformas compatibles: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows. Se requieren privilegios de root en NetBSD.

Parámetros:

• if - nombre de la interfaz de red (Unix); descripción completa de la interfaz o dirección IPv4; o, si está entre llaves, GUID de la interfaz de red (Windows);
• mode - 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) - número de errores del búfer FIFO;
  • frame - número de errores de encapsulación de paquetes;
  • compressed - número de paquetes comprimidos recibidos por el controlador del dispositivo;
  • multicast - número de tramas multicast recibidas por el controlador del dispositivo.

Comentarios:

• Puede usar esta clave con el paso de preprocesamiento Change per second para obtener las estadísticas de bytes por segundo.
• El modo dropped solo es compatible en Linux, FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD.
• Los modos overruns, frame, compressed, multicast solo son compatibles en Linux.
• En HP-UX este item no proporciona detalles sobre interfaces de loopback (por ejemplo, lo0).

Ejemplos:

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

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

Las estadísticas de tráfico saliente en una interfaz de red.
Valor devuelto: Integer.
Plataformas compatibles: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows. 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);
• mode - 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) - número de errores del búfer FIFO;
  • collisions (colls) - número de colisiones detectadas en la interfaz;
  • carrier - número de pérdidas de portadora detectadas por el controlador del dispositivo;
  • compressed - número de paquetes comprimidos transmitidos por el controlador del dispositivo.

Comentarios:

• Puede usar esta clave con el paso de preprocesamiento Change per second para obtener las estadísticas de bytes por segundo.
• El modo dropped solo es compatible en Linux, HP-UX.
• Los modos overruns, collision, carrier, compressed solo son compatibles en Linux.
• En HP-UX este item no proporciona detalles sobre interfaces de loopback (por ejemplo, lo0).

Ejemplos:

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

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

La suma de las estadísticas de tráfico entrante y saliente en una interfaz de red.
Valor devuelto: Integer.
Plataformas compatibles: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows. 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);
• mode - 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) - número de errores del búfer FIFO;
  • collisions (colls) - número de colisiones detectadas en la interfaz;
  • compressed - número de paquetes comprimidos transmitidos o recibidos por el controlador del dispositivo.

Comentarios:

• Puede usar esta clave con el paso de preprocesamiento Change per second para obtener las estadísticas de bytes por segundo.
• El modo dropped solo es compatible en Linux, HP-UX. Los paquetes descartados solo son compatibles si tanto net.if.in como net.if.out funcionan para paquetes descartados en su plataforma.
• Los modos overruns, collision, compressed solo son compatibles en Linux.
• En HP-UX este item no proporciona detalles sobre las interfaces de loopback (por ejemplo, lo0).

Ejemplos:

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

net.tcp.listen[port]

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

Parámetro:

• port - número de puerto TCP

En kernels Linux 2.6.14 y posteriores, la información sobre sockets TCP en escucha 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>,port]

Comprueba si es posible establecer una conexión TCP con el puerto especificado.
Valores devueltos: 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);
• port - el número de puerto.

Comentarios:

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

Ejemplo:

net.tcp.port[,80] #this item can be used to test the web server availability running on port 80

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

Comprueba si un servicio está en ejecución y acepta conexiones TCP.
Valores devueltos: 0 - el servicio no está disponible; 1 - el servicio está en ejecución.
Consulte las plataformas compatibles.

Parámetros:

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

Comentarios:

• Estas comprobaciones pueden generar mensajes adicionales en los archivos de registro del daemon del sistema (normalmente se registran sesiones SMTP y SSH).
• Actualmente no se admite la comprobació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 solo es compatible con Zabbix agent 2.
• La comprobación telnet busca un mensaje de inicio de sesión (':' al final).

Ejemplo:

net.tcp.service[ftp,,45] #this item can be used to test the availability of FTP server on TCP port 45

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

Comprueba el rendimiento de un servicio TCP.
Valores devueltos: Float (0 - el servicio no está disponible; segundos - el número de segundos empleados esperando una respuesta del servicio).
Consulte las plataformas compatibles.

Parámetros:

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

Comentarios:

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

Ejemplo:

net.tcp.service.perf[ssh] #this item can be used to test the speed of initial response from the SSH server

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

Devuelve el número de sockets TCP que coinciden con los parámetros.
Valor devuelto: Integer.
Plataformas compatibles: Linux, Windows.

Parámetros:

• laddr - la dirección IPv4/6 local o subred CIDR;
• lport - el número de puerto local o nombre de servicio;
• raddr - la dirección IPv4/6 remota o subred CIDR;
• rport - el número de puerto remoto o nombre de 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] #número de conexiones al puerto TCP local 80 en estado established

net.udp.listen[puerto]

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

Parámetro:

• puerto - número de puerto UDP

Ejemplo:

net.udp.listen[68]

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

Comprueba si un servicio está en ejecución y responde a solicitudes UDP.
Valores devueltos: 0 - el servicio no está disponible; 1 - el servicio está en ejecución.
Consulte las plataformas compatibles.

Parámetros:

• service - ntp (consulte los detalles);
• ip - la dirección IP o el nombre DNS (el valor predeterminado es 127.0.0.1);
• port - el número de puerto (de forma predeterminada, se usa el número de puerto estándar del servicio).

Ejemplo:

net.udp.service[ntp,,45] #this item can be used to test the availability of NTP service on UDP port 45

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

Comprueba el rendimiento de un servicio UDP.
Valores devueltos: Float (0 - el servicio no está disponible; segundos - la cantidad de segundos empleados esperando una respuesta del servicio).
Consulte las plataformas compatibles.

Parámetros:

• service - ntp (consulte los detalles);
• ip - la dirección IP o el nombre DNS (el valor predeterminado es 127.0.0.1);
• port - el número de puerto (de forma predeterminada, se usa el número de puerto estándar del servicio).

Ejemplo:

net.udp.service.perf[ntp] #this item can be used to test response time from NTP service

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

Devuelve el número de sockets UDP que coinciden con los parámetros.
Valor devuelto: Integer.
Plataformas soportadas: Linux, Windows.

Parámetros:

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

Ejemplo:

net.udp.socket.count[,,,,established] #devuelve el número de sockets UDP en estado conectado

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

El porcentaje de utilización de CPU del proceso.
Valor devuelto: Float.
Plataformas compatibles: Linux, Solaris⁶.

Parámetros:

• name - el nombre del proceso (el valor predeterminado es all processes);
• user - el nombre de usuario (el valor predeterminado es all users);
• type - el tipo de utilización de CPU: total (predeterminado), user o system;
• cmdline - filtra por línea de comandos (es una expresión regular);
• mode - el modo de recopilación de datos: avg1 (predeterminado), avg5 o avg15;
• zone - la zona de destino: current (predeterminado) o all. Este parámetro solo es compatible en Solaris.

Comentarios:

• El valor devuelto se basa en el porcentaje de utilización de un solo núcleo de CPU. Por ejemplo, la utilización de CPU de un proceso que usa completamente dos núcleos es 200%.
• Los datos de utilización de CPU del proceso son recopilados por un collector que admite un máximo de 1024 consultas únicas (por nombre, usuario y línea de comandos). Las consultas a las que no se ha accedido durante las últimas 24 horas se eliminan del collector.
• Al establecer el parámetro zone en current (o dejar el valor predeterminado), si el agent se ha compilado en un Solaris sin compatibilidad con zonas, pero se ejecuta en un Solaris más reciente donde sí se admiten zonas, entonces el agent devolverá NOTSUPPORTED (el agent no puede limitar los resultados solo a la zona actual). Sin embargo, all sí es compatible en este caso.

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[<name>,<user>,<cmdline>,<mode>]

La lista de procesos del sistema operativo y sus parámetros. Puede usarse para el descubrimiento de bajo nivel.
Valor devuelto: cadena JSON.
Plataformas compatibles: Linux, FreeBSD, Windows, OpenBSD, NetBSD.

Parámetros:

• name - el nombre del proceso (valor predeterminado: todos los procesos).
• user - el nombre de usuario (valor predeterminado: todos los usuarios).
• cmdline - filtra por la línea de comandos (es una expresión regular). Este parámetro no es compatible con Windows; en otras plataformas no es compatible si mode está establecido en 'summary'.
• mode - valores posibles:
  • process (predeterminado);
  • thread (no compatible con NetBSD);
  • summary. Consulte 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 terminó, falta de permisos, fallo de la llamada al sistema), se devolverá -1.
• Consulte las notas sobre la selección de procesos con los parámetros name y cmdline (específico 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 los procesos de cada tipo que se ejecutan bajo el usuario zabbix, devuelve una entrada por nombre de proceso

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

La memoria utilizada por el proceso en bytes.
Valor devuelto:

• Integer - con mode como max, min, sum;
• Float - con mode como avg
  Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

Parámetros:

• name - el nombre del proceso (el valor predeterminado es all processes);
• user - el nombre de usuario (el valor predeterminado es all users);
• mode - valores posibles: avg, max, min o sum (predeterminado);
• cmdline - filtra por la línea de comandos (es una expresión regular);
• memtype - el tipo de memoria utilizada por el proceso

Comentarios:

• El parámetro memtype solo es compatible en Linux, FreeBSD, Solaris⁶, 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 la selección de procesos con los parámetros name y cmdline (específicas de Linux).
  
  Cuando este item se invoca desde la línea de comandos y contiene un parámetro de línea de comandos (por ejemplo, usando el modo de prueba de agent: zabbix_agentd -t proc.mem[,,,apache2]), se contará un proceso adicional, ya que el agent 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 que se ejecuta bajo Oracle y tiene oracleZABBIX en su línea de comandos

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

El número de procesos.
Valor devuelto: Integer.
Plataformas compatibles: Linux, FreeBSD, Solaris⁶, HP-UX, AIX, OpenBSD, NetBSD, Windows.

Parámetros:

• name - el nombre del proceso (el valor predeterminado es all processes).
• user - el nombre de usuario (el valor predeterminado es all users).
• state - valores posibles:
  • all (predeterminado);
  • disk - suspensión ininterrumpible;
  • run - en ejecución;
  • sleep - suspensión interrumpible;
  • trace - detenido;
  • zomb - zombi.
• cmdline - filtra por la línea de comandos (es una expresión regular).
• zone - la zona de destino: current (predeterminado) o all. Este parámetro solo es compatible en Solaris.

Comentarios:

• Los parámetros de estado disk y trace solo son compatibles en Linux, FreeBSD, OpenBSD y NetBSD.
• En Windows, solo se admiten los parámetros name y user.
• Cuando este item se invoca desde la línea de comandos y contiene un parámetro de línea de comandos (por ejemplo, usando el modo de prueba de agent: zabbix_agentd -t proc.num[,,,apache2]), se contará un proceso adicional, ya que el agent se contará a sí mismo.
• Al establecer el parámetro zone en current (o el valor predeterminado), si el agent se compiló en un Solaris sin soporte para zonas, pero se ejecuta en un Solaris más reciente donde sí se admiten zonas, entonces el agent devolverá NOTSUPPORTED (el agent no puede limitar los resultados solo a la zona actual). Sin embargo, all sí es compatible en este caso.
• Consulte las notas sobre la selección de procesos con los parámetros name y cmdline (específico 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 sleep que se ejecutan bajo Oracle y que tienen oracleZABBIX en su línea de comandos

sensor[device,sensor,<mode>]

Lectura de un sensor de hardware.
Valor devuelto: Float.
Plataformas compatibles: Linux, OpenBSD.

Parámetros:

• device - el nombre del dispositivo;
• sensor - el nombre del sensor;
• mode - valores posibles: avg, max o min.

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 item sensor en Linux.
• Lee el MIB hw.sensors en OpenBSD.
• En Linux 2.4, si especifica mode, entonces device y sensor se tratan como expresiones regulares.
• En Linux 2.6+ y OpenBSD, o si se omite mode, device y sensor se tratan literalmente.

Ejemplos:

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

system.boottime

El tiempo de arranque del sistema.
Valor devuelto: Entero (timestamp Unix).
Plataformas soportadas: Linux, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

system.cpu.discovery

La lista de CPUs/núcleos de CPU detectados. Se utiliza para el descubrimiento de bajo nivel.
Valor de retorno: cadena 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>,<mode>]

La carga de la CPU.
Valor de retorno: Float.
Consulte las plataformas compatibles.

Parámetros:

• cpu: valores posibles: all (por defecto) o percpu (la carga total dividida por el número de CPUs en línea);
• mode: valores posibles: avg1 (promedio de un minuto, por defecto), avg5 o avg15.

Ejemplo:

system.cpu.load[,avg5]

system.cpu.num[<type>]

El número de CPUs.
Valor devuelto: Integer.
Plataformas soportadas: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Parámetro:

• type - valores posibles: online (por defecto) o max

El parámetro de tipo max solo es soportado en Linux, FreeBSD, Solaris, MacOS X.

Ejemplo:

system.cpu.num

system.cpu.switches

El número de cambios de contexto.
Valor de retorno: Entero.
Plataformas soportadas: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

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

El porcentaje de utilización de la CPU.
Valor de retorno: Float.
Plataformas soportadas: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD, Windows.

Parámetros:

• cpu - <número de CPU> o all (por defecto);
• type - valores posibles: user (por defecto), idle, nice, system, iowait, interrupt, softirq, steal, spin (en OpenBSD), guest (en kernels Linux 2.6.24 y superiores), o guest_nice (en kernels Linux 2.6.33 y superiores);
• mode - valores posibles: avg1 (media de un minuto, por defecto), avg5 o avg15;
• logical or physical - valores posibles: logical (por defecto) o physical. Este parámetro solo se soporta en AIX.

Comentarios:

• El parámetro de tipo nice solo se soporta en Linux, FreeBSD, HP-UX, OpenBSD, NetBSD.
• El parámetro de tipo iowait solo se soporta en Linux 2.6 y superiores, Solaris, AIX.
• El parámetro de tipo interrupt solo se soporta en Linux 2.6 y superiores, FreeBSD, OpenBSD.
• Los parámetros de tipo softirq, steal, guest, guest_nice solo se soportan en Linux 2.6 y superiores.
• Los parámetros de modo avg5 y avg15 se soportan en Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.

Ejemplo:

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

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

El nombre de host del sistema.
Valor devuelto: String.
Consulte plataformas compatibles.

Parámetros:

• type - valores posibles:
  • netbios (predeterminado en Windows);
  • host (predeterminado en Linux);
  • shorthost (devuelve la parte del nombre de host anterior al primer punto, una cadena completa para nombres sin puntos);
  • fqdn (devuelve el nombre de dominio completamente calificado).
• transform - valores posibles:
  • none (predeterminado);
  • lower (convierte a minúsculas).

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

Ejemplos de valores devueltos:

system.hostname → linux-w7x1
system.hostname → example.com
system.hostname[shorthost] → example
system.hostname → WIN-SERV2008-I6
system.hostname[host] → Win-Serv2008-I6LonG
system.hostname[host,lower] → win-serv2008-i6long
system.hostname[fqdn,lower] → blog.zabbix.com

system.hw.chassis[<info>]

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

Parámetro:

• info: valores posibles: full (por defecto), model, serial, type o vendor

Comentarios:

• Esta clave de elemento 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 obtiene 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 all (por defecto);
• info - valores posibles: full (por defecto), curfreq, maxfreq, model o vendor.

Comentarios:

• Recopila 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[<type>]

La lista de dispositivos PCI o USB.
Valor de retorno: Texto.
Plataformas compatibles: Linux.

Parámetro:

• type - pci (por defecto) o usb

Devuelve la salida 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[<interface>,<format>]

Listado de direcciones MAC.
Valor devuelto: String.
Plataformas compatibles: Linux.

Parámetros:

• interface - all (predeterminado) o una expresión regular;
• format - full (predeterminado) o short.

Comentarios:

• Enumera las direcciones MAC de las interfaces cuyo nombre coincide con la expresión regular dada en interface (all enumera todas las interfaces).
• Si format se especifica como short, no se enumeran los nombres de las interfaces ni las direcciones MAC idénticas.

Ejemplo:

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

system.localtime[<type>]

La hora del sistema.
Valor devuelto: Integer - con type como utc; String - con type como local.
Consulte las plataformas compatibles.

Parámetros:

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

Debe usarse como una comprobación pasiva para Zabbix agent; en Zabbix agent 2 puede configurarse como una comprobación activa.

Ejemplo:

system.localtime[local] #cree un item usando esta clave y luego úselo para mostrar la hora del host en el widget del panel *Clock*.

system.run[command,<mode>]

Ejecuta el comando especificado en el host.
Valor devuelto: resultado de Text del comando o 1 - con mode como nowait (independientemente del resultado del comando).
Consulte las plataformas compatibles.

Parámetros:

• command - comando para ejecución;
  
• mode - valores posibles:
  • wait - esperar al final de la ejecución (predeterminado);
  • nowait - no esperar.

Comentarios:

• Este item está deshabilitado de forma predeterminada. Aprenda cómo habilitarlos.
• El valor devuelto del item es la salida estándar junto con el error estándar producido por el comando. No se realiza comprobación del código de salida.
• Para procesarse correctamente, el valor devuelto del comando debe ser de tipo de datos text. También se permite un resultado vacío.
• El valor devuelto está limitado a 16 MB (incluido el espacio en blanco final, que se trunca); también se aplican los límites de la base de datos.
• Véase también: Ejecución de comandos.

Ejemplo:

system.run[ls -l /] #return a detailed file list of the root directory

system.stat[resource,<type>]

Las estadísticas del sistema.
Valor devuelto: Integer o float.
Plataformas compatibles: AIX.

Parámetros:

• ent - el número de unidades de procesador que esta partición tiene derecho a recibir (float).
• kthr,<type> - información sobre los estados de los hilos del kernel:
  • r - número promedio de hilos del kernel ejecutables (float);
  • b - número promedio de hilos del kernel colocados en la cola de espera del Virtual Memory Manager (float).
• memory,<type> - información sobre el uso de memoria virtual y real:
  • avm - páginas virtuales activas (integer);
  • fre - tamaño de la lista libre (integer).
• page,<type> - información sobre fallos de página y actividad de paginación:
  • fi - entradas de páginas de archivo por segundo (float);
  • fo - salidas de páginas de archivo por segundo (float);
  • pi - páginas paginadas desde el espacio de paginación (float);
  • po - páginas paginadas hacia el espacio de paginación (float);
  • fr - páginas liberadas (reemplazo de páginas) (float);
  • sr - páginas examinadas por el algoritmo de reemplazo de páginas (float).
• faults,<type> - tasa de traps e interrupciones:
  • in - interrupciones de dispositivo (float);
  • sy - llamadas al sistema (float);
  • cs - cambios de contexto de hilos del kernel (float).
• cpu,<type> - desglose del porcentaje de uso del tiempo de procesador:
  • us - tiempo de usuario (float);
  • sy - tiempo de sistema (float);
  • id - tiempo de inactividad (float);
  • wa - tiempo de inactividad durante el cual el sistema tenía solicitudes pendientes de E/S de disco/NFS (float);
  • pc - número de procesadores físicos consumidos (float);
  • ec - porcentaje de capacidad asignada consumida (float);
  • lbusy - indica el porcentaje de utilización de uno o varios procesadores lógicos que se produjo al ejecutarse en el nivel de usuario y sistema (float);
  • app - indica los procesadores físicos disponibles en el grupo compartido (float).
• disk,<type> - estadísticas de disco:
  • bps - indica la cantidad de datos transferidos (leídos o escritos) a la unidad en bytes por segundo (integer);
  • tps - indica el número de transferencias por segundo emitidas al disco/cinta físico (float).

Comentarios:

• Tenga en cuenta las siguientes limitaciones en estos items:
  • system.stat[cpu,app] - compatible solo en AIX LPAR de tipo "Shared";
  • system.stat[cpu,ec] - compatible en AIX LPAR de tipo "Shared" y "Dedicated" ("Dedicated" siempre devuelve 100 (percent));
  • system.stat[cpu,lbusy] - compatible solo en AIX LPAR de tipo "Shared";
  • system.stat[cpu,pc] - compatible en AIX LPAR de tipo "Shared" y "Dedicated";
  • system.stat[ent] - compatible en AIX LPAR de tipo "Shared" y "Dedicated".

system.sw.arch

La información de la arquitectura del software.
Valor de retorno: Cadena.
Vea plataformas soportadas.

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

Ejemplo:

system.sw.arch → i686

system.sw.os[<info>]

La información del sistema operativo.
Valor devuelto: String.
Plataformas compatibles: Linux, Windows.

Parámetro:

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

La información de info se obtiene de (ten 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 admiten o /etc/issue.net (name);
• la clave del 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.asd64fre.ni_release.220506-1250 Build 22621.963]

system.sw.os.get

Información detallada sobre el sistema operativo (versión, tipo, nombre de la distribución, versión menor y mayor, etc).
Valor de retorno: cadena JSON.
Plataformas soportadas: Linux, Windows.

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

El listado de paquetes instalados.
Valor devuelto: Text.
Plataformas compatibles: Linux.

Parámetros:

• regexp - all (predeterminado) o una expresión regular;
• manager - all (predeterminado) o un gestor de paquetes;
• format - full (predeterminado) o short.

Comentarios:

• Enumera (alfabéticamente) los paquetes instalados cuyo nombre coincide con la expresión regular dada (all los enumera todos).
• Gestores de paquetes compatibles (comando ejecutado):
  • pkg (dpkg --get-selections);
  • pkgtool (ls /var/log/packages);
  • rpm (rpm -qa);
  • pacman (pacman -Q);
  • portage.
• Si format se especifica como full, los paquetes se agrupan por gestores de paquetes (cada gestor en una línea separada que comienza con su nombre entre corchetes).
• Si format se especifica 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>,<manager>]

Un listado detallado de los paquetes instalados.
Valor devuelto: cadena JSON.
Plataformas compatibles: Linux.

Parámetros:

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

Comentarios:

• Devuelve JSON sin formato con los paquetes instalados cuyo nombre coincide con la expresión regular proporcionada.
• La salida es un array de objetos, cada uno de los cuales contiene las siguientes claves: name, manager, version, size, architecture, buildtime e installtime (consulte más detalles).

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

Las estadísticas de entrada de swap (del dispositivo a la memoria).
Valor devuelto: Integer.
Plataformas compatibles: Linux, FreeBSD, OpenBSD.

Parámetros:

• device - especifica el dispositivo usado para el intercambio (solo Linux) o all (predeterminado);
• type - valores posibles:
  • count (número de entradas de swap, predeterminado en plataformas que no son Linux);
  • sectors (sectores intercambiados);
  • 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 pages solo funcionará si no se especificó device.
• El parámetro de tipo sectors solo es compatible en Linux.

Ejemplo:

system.swap.in[,pages]

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

Las estadísticas de swap-out (de la memoria al dispositivo).
Valor devuelto: Integer.
Plataformas compatibles: Linux, FreeBSD, OpenBSD.

Parámetros:

• device - especifica el dispositivo usado para el intercambio (solo Linux) o all (predeterminado);
• type - valores posibles:
  • count (número de swapouts, predeterminado en plataformas que no son Linux);
  • sectors (sectores intercambiados);
  • 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 pages solo funcionará si no se especificó device.
• El parámetro de tipo sectors solo es compatible en Linux.

Ejemplo:

system.swap.out[,pages]

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

El tamaño del espacio de intercambio en bytes o en porcentaje del total.
Valor devuelto: Integer - para bytes; Float - para porcentaje.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, OpenBSD, Windows.

Parámetros:

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

Comentarios:

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

Ejemplo:

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

system.uname

Identificación del sistema.
Valor de retorno: Cadena.
Consulte las 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 SO, mientras que en UNIX devuelve la arquitectura de la CPU.

Ejemplos:

system.uname → FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: Mon Nov i386
system.uname → Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86

system.uptime

El tiempo de actividad del sistema en segundos.
Valor devuelto: Entero.
Plataformas soportadas: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD, Windows.

En la configuración del item, utilice las unidades s o uptime para obtener valores legibles.

system.users.num

El número de usuarios conectados.
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 bloques y su tipo. Se utiliza para el descubrimiento de bajo nivel.
Valor de retorno: cadena JSON.
Plataformas compatibles: Linux.

vfs.dev.get[<mode>,<regexp>]

La lista de dispositivos de bloque con información detallada. Se usa para el descubrimiento de bajo nivel.
Valor devuelto: cadena JSON.
Plataformas compatibles: Linux, AIX.

Parámetros:

• mode - valores posibles:
  • disks (predeterminado) - devuelve la lista de discos;
  • disk_stats - devuelve estadísticas para cada disco;
  • devices (solo Linux) - devuelve la lista de dispositivos de bloque (discos y particiones);
  • device_stats (solo Linux) - devuelve estadísticas para cada dispositivo (discos y particiones).
• regexp - una expresión regular usada para filtrar dispositivos de bloque por su nombre.

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

Las estadísticas de lectura de disco.
Valor devuelto:

• Integer - con type en sectors, operations, bytes;
• Float - con type en sps, ops, bps.
  Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parámetros:

• device - dispositivo de disco (el valor predeterminado es all ³);
• type - valores posibles: sectors, operations, bytes, sps, ops o bps (sps, ops, bps significan: sectores, operaciones, bytes por segundo, respectivamente);
• mode - valores posibles: avg1 (promedio de un minuto, predeterminado), avg5 o avg15. Este parámetro solo es compatible con type en: sps, ops, bps.

Comentarios:

• Si se usa un intervalo de actualización de tres horas o más², este item siempre devolverá 0.
• Los parámetros de tipo sectors y sps solo son compatibles en Linux.
• El parámetro de tipo ops solo es compatible en Linux y FreeBSD.
• El parámetro de tipo bps solo es compatible en FreeBSD.
• El parámetro de tipo bytes solo es compatible en FreeBSD, Solaris, AIX, OpenBSD.
• El parámetro mode solo es compatible en Linux, FreeBSD.
• Puede usar nombres relativos de dispositivos (por ejemplo, sda) así como un prefijo opcional /dev/ (por ejemplo, /dev/sda).
• Se admiten volúmenes lógicos LVM.
• Los valores predeterminados del parámetro 'type' para diferentes SO:
  • AIX - operations;
  • FreeBSD - bps;
  • Linux - sps;
  • OpenBSD - operations;
  • Solaris - bytes.
• sps, ops y bps en las plataformas compatibles están limitados a 1024 dispositivos (1023 individuales y uno para all).

Ejemplo:

vfs.dev.read[,operations]

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

Las estadísticas de escritura del disco.
Valor devuelto: Integer - con type en sectors, operations, bytes; Float - con type en sps, ops, bps.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parámetros:

• device - dispositivo de disco (el valor predeterminado es all ³);
• type - valores posibles: sectors, operations, bytes, sps, ops o bps (sps, ops, bps significan: sectores, operaciones, bytes por segundo, respectivamente);
• mode - valores posibles: avg1 (promedio de un minuto, predeterminado), avg5 o avg15. Este parámetro solo es compatible con type en: sps, ops, bps.

Comentarios:

• Si se usa un intervalo de actualización de tres horas o más², este item siempre devolverá 0.
• Los parámetros de tipo sectors y sps solo son compatibles en Linux.
• El parámetro de tipo ops solo es compatible en Linux y FreeBSD.
• El parámetro de tipo bps solo es compatible en FreeBSD.
• El parámetro de tipo bytes solo es compatible en FreeBSD, Solaris, AIX, OpenBSD.
• El parámetro mode solo es compatible en Linux, FreeBSD.
• Puede usar nombres relativos de dispositivos (por ejemplo, sda) así como un prefijo opcional /dev/ (por ejemplo, /dev/sda).
• Se admiten volúmenes lógicos LVM.
• Los valores predeterminados del parámetro type para diferentes sistemas operativos:
  • AIX - operations
  • FreeBSD - bps
  • Linux - sps
  • OpenBSD - operations
  • Solaris - bytes
• sps, ops y bps en las plataformas compatibles están limitados a 1024 dispositivos (1023 individuales y uno para all).

Ejemplo:

vfs.dev.write[,operations]

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

El recuento de entradas del directorio.
Valor devuelto: Integer.
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 todas 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 excluir ninguna si está vacío (valor predeterminado);
• types incl - tipos de entradas de directorio a contar, valores posibles:
  • file - archivo regular;
  • 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 separarse con coma y entre comillas.
• types excl - tipos de entradas de directorio (consulte types incl) que NO se deben contar. Si algún tipo de entrada está tanto en types incl como en types excl, las entradas de directorio de ese tipo NO se cuentan.
• max depth - la profundidad máxima de subdirectorios a recorrer:
  • -1 (predeterminado) - ilimitada;
  • 0 - no descender a subdirectorios.
• min size - el tamaño mínimo (en bytes) para que un archivo se cuente. Los archivos más pequeños no se contarán. Los sufijos de memoria se pueden usar.
• max size - el tamaño máximo (en bytes) para que un archivo se cuente. Los archivos más grandes no se contarán. Los sufijos de memoria se pueden usar.
• min age - la antigüedad mínima (en segundos) de la entrada de directorio para que se cuente. Las entradas más recientes no se contarán. Los sufijos de tiempo se pueden usar.
• max age - la antigüedad máxima (en segundos) de la entrada de directorio para que se cuente. Las entradas con esa antigüedad o mayor no se contarán (hora de modificación). Los sufijos de tiempo se pueden usar.
• regex excl dir - una expresión regular que describe el patrón de nombre del directorio a excluir. Todo el contenido del directorio quedará excluido (a diferencia de regex_excl)

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede suponer un riesgo de seguridad.
• Las variables de entorno, por ejemplo, %APP_HOME%, $HOME y %TEMP% no son compatibles.
• Los pseudodirectorios "." y ".." nunca se cuentan.
• Los enlaces simbólicos nunca se siguen durante el recorrido de directorios.
• Tanto regex incl como regex excl se aplican a archivos y directorios al calcular el recuento de entradas, pero se ignoran al seleccionar subdirectorios que recorrer (si regex incl es (?i)\^.+\.zip$ y max depth no está establecido, 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 timeout en la configuración del agent (3 sec). Dado que el recorrido de directorios grandes puede tardar más que eso, no se devolverán datos y el item pasará a no compatible. No se devolverá un recuento parcial.
• Al filtrar por tamaño, solo los archivos regulares 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ño cero; por ejemplo, el tamaño de /dev/sda1 no refleja el tamaño de la partición correspondiente. Por lo tanto, al usar <min_size> y <max_size>, se recomienda especificar <types_incl> como "file", para evitar sorpresas.

Ejemplos:

vfs.dir.count[/dev] #monitoriza el número de dispositivos en /dev (Linux)
vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] #monitoriza el número de archivos en un directorio temporal

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

La lista de entradas del directorio.
Valor devuelto: cadena 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; incluye todas 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 excluye ninguna si está vacío (valor predeterminado);
• types incl - tipos de entradas de directorio a listar, valores posibles:
  • file - archivo regular;
  • 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 separarse con comas y entre comillas.
• types excl - tipos de entradas de directorio (consulte types incl) que NO se deben listar. Si algún tipo de entrada está tanto en types incl como en types excl, las entradas de directorio de ese tipo NO se listan.
• max depth - la profundidad máxima de subdirectorios a recorrer:
  • -1 (predeterminado) - ilimitada;
  • 0 - no descender a subdirectorios.
• min size - el tamaño mínimo (en bytes) para que un archivo se liste. Los archivos más pequeños no se listarán. Los sufijos de memoria se pueden usar.
• max size - el tamaño máximo (en bytes) para que un archivo se liste. Los archivos más grandes no se listarán. Los sufijos de memoria se pueden usar.
• min age - la antigüedad mínima (en segundos) de la entrada de directorio para que se liste. Las entradas más recientes no se listarán. Los sufijos de tiempo se pueden usar.
• max age - la antigüedad máxima (en segundos) de la entrada de directorio para que se liste. Las entradas tan antiguas o más antiguas no se listarán (tiempo de modificación). Los sufijos de tiempo se pueden usar.
• regex excl dir - una expresión regular que describe el patrón de nombre del directorio a excluir. Todo el contenido del directorio se excluirá (a diferencia de regex excl)

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede suponer un riesgo de seguridad.
• Las variables de entorno, por ejemplo, %APP_HOME%, $HOME y %TEMP% no son compatibles.
• Los pseudodirectorios "." y ".." nunca se listan.
• Los enlaces simbólicos nunca se siguen para el recorrido de directorios.
• Tanto regex incl como regex excl se aplican a archivos y directorios al generar la lista de entradas, pero se ignoran al seleccionar subdirectorios que recorrer (si regex incl es (?i)\^.+\.zip$ y max depth no está establecido, 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 del agent. Dado que el recorrido de directorios grandes puede tardar más que eso, no se devolverán datos y el item pasará a no compatible. No se devolverá una lista parcial.
• Al filtrar por tamaño, solo los archivos regulares 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ño cero, por ejemplo, el tamaño de /dev/sda1 no refleja el tamaño de la partición correspondiente. Por lo tanto, al usar min size y max size, se recomienda especificar types incl como "file", para evitar sorpresas.

Ejemplos:

vfs.dir.get[/dev] #recupera la lista de dispositivos en /dev (Linux)
vfs.dir.get["C:\Users\ADMINI~1\AppData\Local\Temp"] #recupera la lista de archivos en un directorio temporal

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

El tamaño del directorio (en bytes).
Valor devuelto: Integer.
Plataformas compatibles: Linux, Windows. El item puede funcionar en otras plataformas similares a 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; incluye todas 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 excluye ninguna si está vacío (valor predeterminado);
• mode - valores posibles:
  • apparent (predeterminado) - obtiene tamaños aparentes de archivo en lugar del uso de disco (actúa como du -sb dir);
  • disk - obtiene el uso de disco (actúa como du -s -B1 dir). A diferencia del comando du, el item vfs.dir.size tiene en cuenta los archivos ocultos al calcular el tamaño del directorio (actúa como du -sb .[^.]* * dentro de dir).
• max depth - la profundidad máxima de subdirectorios a recorrer:
  • -1 (predeterminado) - ilimitada;
  • 0 - no descender a subdirectorios.
• regex excl dir - una expresión regular que describe el patrón de nombre del directorio a excluir. Todo el contenido del directorio será excluido (a diferencia de regex excl)

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede ser un riesgo de seguridad.
• Solo se calculan los directorios con al menos permiso de lectura para el usuario zabbix. Para los directorios con solo permiso de lectura, se calcula el tamaño del propio directorio. Los directorios con permisos de lectura y ejecución se calculan incluyendo su contenido.
• En directorios grandes o unidades lentas, este item puede agotar el tiempo de espera debido al ajuste Timeout en los archivos de configuración de agent y server/proxy. Aumente los valores de timeout según sea necesario.
• El límite de tamaño de archivo depende de large file support.

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[file,<mode>]

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

Parámetros:

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

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede ser un riesgo de seguridad.
• El límite de tamaño de archivo depende del soporte para archivos grandes.

Ejemplo:

vfs.file.cksum[/etc/passwd]

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

675436101
9845acf68b73991eb7fd7ee0ded23c44
ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc

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

Recupera el contenido de un archivo⁷.
Valor devuelto: Text.
Consulte las plataformas compatibles.

Parámetros:

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

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede suponer un riesgo de seguridad.
• El valor devuelto está limitado a 16 MB (incluido el espacio en blanco final, que se trunca); 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 solo caracteres LF/CR.
• La marca de orden de bytes (BOM) se excluye de la salida.

Ejemplo:

vfs.file.contents[/etc/passwd]

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

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

Parámetros:

• file - la ruta completa al archivo;
• types incl - la lista de tipos de archivo a incluir, valores posibles:
  • file (archivo regular, predeterminado (si types_excl no está establecido));
  • dir (directorio);
  • 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 mencionados, predeterminado si types_excl está establecido).
• types excl - la lista de tipos de archivo a excluir, consulte types_incl para conocer los valores posibles (por defecto no se excluye ningún tipo)

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede suponer un riesgo de seguridad.
• Varios tipos deben separarse con una coma y todo el conjunto debe ir entre comillas "".
• Si el mismo tipo está en ambos <types_incl> y <types_excl>, los archivos de ese tipo se excluyen.
• El límite de tamaño de archivo depende del soporte para 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[file]

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

Parámetro:

• file - la ruta completa al archivo

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede suponer un riesgo de seguridad.
• Tipos de archivo compatibles en sistemas tipo UNIX: archivo regular, directorio, enlace simbólico, socket, dispositivo de bloque, dispositivo de caracteres, FIFO.
• El límite de tamaño de archivo depende de large file support.

Ejemplo:

vfs.file.get[/etc/passwd] #return a JSON with information about the /etc/passwd file (type, user, permissions, SID, uid etc)

vfs.file.md5sum[file]

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

Parámetro:

• file - la ruta completa al archivo

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede suponer un riesgo de seguridad.
• El límite de tamaño del archivo depende del soporte para archivos grandes.

Ejemplo:

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

Ejemplo del valor devuelto:

b5052decb577e0fffd622d6ddc017e82

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

Recupera el propietario de un archivo.
Valor devuelto: String.
Consulte las plataformas compatibles.

Parámetros:

• file - la ruta completa al archivo;
• ownertype - user (predeterminado) o group (solo Unix);
• resulttype - name (predeterminado) o id; para id - devuelve uid/gid en Unix, SID en Windows.

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede ser un riesgo de seguridad.
• El límite de tamaño de archivo depende de la compatibilidad con archivos grandes.

Ejemplos:

vfs.file.owner[/tmp/zabbix_server.log] #devuelve el propietario del archivo /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[file]

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

Parámetros:

• file: 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 los permisos de /etc/passwd, por ejemplo, '0644'

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

Recupera una cadena en el archivo⁷.
Valor devuelto: La línea que contiene la cadena coincidente, o según lo especificado por el parámetro opcional output.
Consulte las plataformas compatibles.

Parámetros:

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

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede suponer un riesgo de seguridad.
• El límite de tamaño del archivo depende del soporte para archivos grandes.
• Solo 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 output se realiza en el agent.

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[file,regexp,<encoding>,<start line>,<end line>]

Buscar una cadena en el archivo⁷.
Valores devueltos: 0 - no se encontró coincidencia; 1 - encontrado.
Consulte las plataformas compatibles.

Parámetros:

• file - la ruta completa al archivo;
• regexp - una expresión regular que describe el patrón requerido;
• encoding - el identificador de la página de códigos;
• start line - el número de la primera línea en la que buscar (de forma predeterminada, la primera línea del archivo);
• end line - el número de la última línea en la que buscar (de forma predeterminada, la última línea del archivo).

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede suponer un riesgo de seguridad.
• El límite de tamaño del archivo depende del soporte para archivos grandes.
• La marca de orden de bytes (BOM) se ignora.

Ejemplo:

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

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

El tamaño del archivo (en bytes).
Valor devuelto: Integer.
Consulte plataformas compatibles.

Parámetros:

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

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede ser un riesgo de seguridad.
• El archivo debe tener permisos de lectura para el usuario zabbix.
• El límite de tamaño del archivo depende del soporte para archivos grandes.

Ejemplo:

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

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

La información de tiempo del archivo.
Valor devuelto: Integer (marca de tiempo Unix).
Consulte las plataformas compatibles.

Parámetros:

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

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede suponer un riesgo de seguridad.
• El límite de tamaño del 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 el descubrimiento de bajo nivel.
Valor de retorno: cadena JSON.
Plataformas soportadas: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

vfs.fs.get

La lista de sistemas de archivos montados con su tipo, espacio de disco disponible, estadísticas de inodos y opciones de montaje. Puede usarse para el descubrimiento de bajo nivel.
Valor devuelto: cadena JSON.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Comentarios:

• También se informan los sistemas de archivos con un recuento de inodos igual a cero, lo que puede ocurrir en sistemas de archivos con inodos dinámicos (por ejemplo, btrfs).
• El espacio de disco disponible y las estadísticas de inodos solo se devuelven si el usuario del agent de Zabbix tiene permiso de recorrido en todos los directorios de la ruta del punto de montaje; de lo contrario, el sistema de archivos se omite de la salida.
• Véase 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 las plataformas compatibles.

Parámetros:

• fs - el sistema de archivos;
• modo - valores posibles: total (por defecto), free, used, pfree (libres, porcentaje), o pused (usados, porcentaje).

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

Ejemplo:

vfs.fs.inode[/,pfree]

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

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;
• mode: valores posibles: total (por defecto), free, used, pfree (libre, porcentaje) o pused (usado, porcentaje).

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 al usar el modo free.

Ejemplo:

vfs.fs.size[/tmp,free]

vm.memory.size[<mode>]

El tamaño de la memoria en bytes o en porcentaje del total.
Valor de retorno: Integer - para bytes; Float - para porcentaje.
Consulte las plataformas soportadas.

Parámetro:

• mode - valores posibles: total (por defecto), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (usada, porcentaje), available o pavailable (disponible, porcentaje).

Comentarios:

• Este item acepta tres categorías de parámetros:
  • total - cantidad total de memoria;
  • tipos de memoria específicos de la plataforma: active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired;
  • estimaciones a nivel de usuario sobre cuánta memoria se utiliza y está disponible: used, pused, available, pavailable.
• El parámetro de modo active solo es compatible con FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD.
• Los parámetros de modo anon, exec, file solo son compatibles con NetBSD.
• El parámetro de modo buffers solo es compatible con Linux, FreeBSD, OpenBSD, NetBSD.
• El parámetro de modo cached solo es compatible con Linux, FreeBSD, AIX, OpenBSD, NetBSD.
• Los parámetros de modo inactive, wired solo son compatibles con FreeBSD, MacOS X, OpenBSD, NetBSD.
• El parámetro de modo pinned solo es compatible con AIX.
• El parámetro de modo shared solo es compatible con Linux 2.4, FreeBSD, OpenBSD, NetBSD.
• Consulte también detalles adicionales para este item.

Ejemplo:

vm.memory.size[pavailable]

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

Obtiene el contenido de una página web.
Valor devuelto: código fuente de la página web como texto (incluidos los encabezados).
Consulte plataformas compatibles.

Parámetros:

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

Comentarios:

• Este item pasa a no ser compatible si el recurso especificado en host no existe o no está disponible.
• host puede ser un nombre de host, nombre de dominio, dirección IPv4 o IPv6. Pero para direcciones IPv6, Zabbix agent debe compilarse con compatibilidad IPv6 habilitada.

Ejemplos:

web.page.get[www.example.com,index.php,80]
web.page.get[https://www.example.com]
web.page.get[https://blog.example.com/?s=zabbix]
web.page.get[localhost:80]
web.page.get["[::1]/server-status"]

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

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

Parámetros:

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

Comentarios:

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

Ejemplos:

web.page.perf[www.example.com,index.php,80]
web.page.perf[https://www.example.com]

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

Encuentra una cadena en la página web.
Valor devuelto: La cadena coincidente, o según lo especificado por el parámetro opcional output.
Consulte las plataformas compatibles.

Parámetros:

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

Comentarios:

• Este item pasa a no ser compatible si el recurso especificado en host no existe o no está disponible.
• host puede ser un nombre de host, nombre de dominio, dirección IPv4 o IPv6. Pero para direcciones IPv6, Zabbix agent debe compilarse con la compatibilidad IPv6 habilitada.
• La extracción de contenido mediante el parámetro output se realiza en el agent.

Ejemplos:

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 host del agent.
Valor devuelto: String.
Consulte plataformas compatibles.

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

agent.hostname

El nombre de host del agent.
Valor devuelto: String.
Consulte plataformas compatibles.

Devuelve:

• Como comprobación pasiva: el nombre del primer host listado en el parámetro Hostname del archivo de configuración del agent;
• Como comprobación activa: el nombre del hostname actual.

agent.ping

La comprobación de disponibilidad del agent.
Valor devuelto: Nada - no disponible; 1 - disponible.
Consulte supported platforms.

Use la función de trigger nodata() para comprobar la indisponibilidad del host.

agent.variant

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

agent.version

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

Ejemplo de valor devuelto:

6.0.3

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

Devuelve un conjunto de métricas internas del server o proxy de Zabbix. Si se especifican ip y port, las métricas se obtienen de la instancia remota; de lo contrario, de la instancia local.
Valor devuelto: cadena JSON.
Consulte las plataformas compatibles.

Parámetros:

• ip - la lista de IP/DNS/máscara de red de los servers/proxies que se consultarán de forma remota (el valor predeterminado es 127.0.0.1);
• port - el puerto del server/proxy que se consultará de forma remota (el valor predeterminado es 10051)

Comentarios:

• Este item devuelve un conjunto seleccionado de métricas internas. Para obtener más detalles, consulte Supervisión remota 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 de server/proxy en la instancia de destino.

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

Devuelve el número de items monitorizados en la cola que presentan retraso en el server o proxy de Zabbix. Si se especifican ip y port, las métricas se obtienen de la instancia remota; de lo contrario, de la instancia local.
Valor devuelto: cadena JSON.
Consulte las plataformas compatibles.

Parámetros:

• ip - la lista de IP/DNS/máscara de red de servers/proxies que se consultarán de forma remota (el valor predeterminado es 127.0.0.1);
• port - el puerto del server/proxy que se consultará de forma remota (el valor predeterminado es 10051)
• queue - constante (debe usarse tal cual)
• from - retrasado al menos (el valor predeterminado es 6 segundos)
• to - 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' de server/proxy de la instancia de destino.

Notas al pie

¹Una nota específica de Linux. Zabbix agent 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 sin privilegios.

² vfs.dev.read[], vfs.dev.write[]: Zabbix agent terminará las conexiones de dispositivos "obsoletas" si los valores del item no se acceden durante más de 3 horas. Esto puede ocurrir si un sistema tiene dispositivos con rutas que cambian dinámicamente o si un dispositivo se elimina manualmente. Tenga en cuenta también que estos items, si usan un intervalo de actualización de 3 horas o más, siempre devolverán '0'.

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

⁴ SSL (HTTPS) solo es compatible si agent se compila con soporte para cURL. De lo contrario, el item pasará a no compatible.

⁵ Los valores bytes y errors no son compatibles con las interfaces de loopback en sistemas Solaris hasta Solaris 10 6/06 inclusive, ya que las estadísticas de bytes, errores y utilización no se almacenan y/o no son informadas por el kernel. Sin embargo, si está supervisando un sistema Solaris mediante net-snmp, los valores pueden devolverse porque net-snmp incorpora código heredado de cmu-snmp, fechado tan atrás como 1997, que, al no poder leer los valores de bytes de las estadísticas de la interfaz, devuelve el contador de paquetes (que sí existe en las interfaces de loopback) multiplicado por un valor arbitrario de 308. Esto hace la suposición de que la longitud media de un paquete es de 308 octetos, lo cual es una estimación muy aproximada, ya que el límite MTU en sistemas Solaris para interfaces de loopback es de 8892 bytes. No debe suponerse que estos valores sean correctos ni siquiera cercanamente precisos. Son estimaciones. Zabbix agent no hace ninguna estimación, pero net-snmp devolverá un valor para estos campos.

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

⁷ Los items vfs.file.contents[], vfs.file.regexp[], vfs.file.regmatch[] pueden usarse para recuperar el contenido de archivos. Si desea restringir el acceso a archivos específicos con información sensible, ejecute Zabbix agent bajo 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 usar claves de ítem con zabbix_agentd o zabbix_get desde la línea de comandos, también debe considerar la sintaxis de la shell.

Por ejemplo, si un determinado parámetro de la clave debe ir entre comillas dobles, debe escapar explícitamente las comillas dobles; de lo contrario, la shell las eliminará como caracteres especiales y no se pasarán a la utilidad de 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 se corrompan, puede especificar la codificación correcta para procesar la comprobación (por ejemplo, vfs.file.contents) en el parámetro encoding. La lista de codificaciones admitidas (identificadores de página de códigos) puede encontrarse en la documentación de libiconv (GNU Project) o en la documentación de Microsoft Windows SDK para "Code Page Identifiers". Tenga en cuenta que Microsoft a veces marca algunas páginas de códigos como "disponibles solo para aplicaciones administradas", es decir, expuestas únicamente a través del entorno de ejecución .NET y no disponibles mediante las API nativas de Win32. agent de Zabbix implementa su propia lógica de conversión de codificación, por lo tanto, esas páginas de códigos son compatibles con agent de Zabbix incluso cuando las funciones nativas de Windows no las proporcionan.

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

• Si no se especifica codificación (o es una cadena vacía), se asume UTF-8 y los datos se procesan "tal cual";
• Análisis BOM: aplicable a los items vfs.file.contents, vfs.file.regexp, vfs.file.regmatch. Se intenta determinar la codificación correcta utilizando la marca de orden de bytes (BOM) al principio del archivo. Si no está presente el BOM, se aplica en su lugar la resolución estándar (véase arriba).

Solución de problemas de items de agent

En el caso de comprobaciones pasivas, para evitar que el item no reciba ningún valor porque la solicitud del server al agent agote el tiempo de espera primero, debe tenerse en cuenta lo siguiente:

• Cuando la versión del agent es anterior a la versión del server, es posible que el valor de Timeout en la configuración del item (o en el tiempo de espera global) deba ser mayor que el valor de Timeout en el archivo de configuración del agent.
• Cuando la versión del agent es más reciente que la versión del server, es posible que el valor de Timeout en el archivo de configuración del server deba ser mayor que el valor de Timeout en el archivo de configuración del agent.