1 Agente Zabbix

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.

Existen 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 admitidas por el agent de Zabbix también son compatibles con el agent de Zabbix de nueva generación, agent 2. Consulte las claves de item adicionales que puede utilizar solo con el agent 2.

Claves de item soportadas

Las claves de item que puede utilizar con el agent de Zabbix 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

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

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

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

Detalles clave de métrica

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

kernel.maxfiles

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

kernel.maxproc

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

kernel.openfiles

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

log[archivo,<regexp>,<codificación>,<maxlines>,<modo>,<salida>,<maxdelay>,<opciones>,<directorio persistente>]

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

Parámetros:

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

Comentarios:

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

Ejemplos:

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

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

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

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

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

log.count[archivo,<regexp>,<codificación>,<maxproclines>,<modo>,<maxdelay>,<opciones>,<directorio persistente>]

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

Parámetros:

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

Comentarios:

• El artículo debe configurarse como verificación activa;
• Las líneas coincidentes se cuentan en las nuevas líneas desde la última verificación del registro por parte del agente y, por lo tanto, dependen del intervalo de actualización del elemento;
• Si falta el archivo o los permisos no permiten el acceso, el elemento deja de ser compatible.

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

Supervisa un archivo de registro que es rotado.
Valor devuelto: Log.
Ver plataformas soportadas.

Parámetros:

• file regexp - la ruta absoluta al archivo, con el nombre del archivo especificado usando una expresión regular. Tenga en cuenta que la expresión regular solo se aplica al nombre del archivo y no necesita coincidir con todo el nombre (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 servidor o proxy de Zabbix. Este parámetro sobrescribe el valor de 'MaxLinesPerSecond' en zabbix_agentd.conf.
  
• mode - valores posibles: all (por defecto) o skip - omite el procesamiento de datos antiguos (afecta solo a los items recién creados).
  
• 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 excede el número de grupos capturados).
  
• maxdelay - el retraso máximo en segundos. Tipo: float. Valores: 0 - (por defecto) nunca ignorar líneas del archivo de registro; > 0.0 - ignorar líneas más antiguas para que las líneas más recientes se analicen dentro de los segundos especificados en "maxdelay". ¡Lea las notas sobre maxdelay antes de usarlo!
  
• options - el tipo de rotación del archivo de registro y otras opciones. Valores posibles:
  rotate (por defecto),
  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 sobre copytruncate,
  mtime-reread - registros no únicos, volver a leer si cambia la hora de modificación o el tamaño (se usa por defecto 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 hora de modificación).
  
• persistent dir (solo en zabbix_agentd en sistemas Unix; no soportado en 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 verificación activa;
• La rotación del registro se basa en la última hora de modificación de los archivos;
• Tenga en cuenta que logrt está diseñado para trabajar con un archivo de registro actualmente activo, con varios otros archivos inactivos coincidentes rotados. Si, por ejemplo, un directorio tiene muchos archivos de registro activos, se debe crear un item logrt separado para cada uno. De lo contrario, si un item logrt recoge demasiados archivos, puede agotar la memoria y provocar un fallo en 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 toda la línea coincidente y se ignora el parámetro output.
• La extracción de contenido usando el parámetro output se realiza en el agent.
• En el parámetro file regexp, la ruta del directorio de registro y la expresión regular del archivo de registro deben estar separadas por el separador de directorio correcto:
  • en Windows, el separador debe ser una barra invertida (\); las barras normales pueden tolerarse en otras posiciones, excepto en la que separa la ruta del directorio de registro y la expresión regular del archivo de registro (ver ejemplos a continuación).
  • en otros sistemas, debe ser una barra normal (/).

Ejemplos para Windows:

logrt["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #este item recopilará datos de archivos de registro en "c:/dir1/dir2/dir3" donde el nombre del archivo comienza con "filename" y termina con cualquier extensión que coincida con ".log".
logrt["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #este item recopilará datos de archivos de registro en el recurso compartido de red "//example.com/share/dir1/dir2/dir3" donde el nombre del archivo comienza con "filename" y termina con cualquier extensión que coincida con ".log".

Ejemplos para otros sistemas:

logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] #este item coincidirá con un archivo como "logfile1" (no coincidirá con ".logfile1").
logrt["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #este item recopilará datos de archivos como "logfile_abc_1" o "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] #este item coincidirá con un registro de log "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" y enviará solo '6080' al server. Debido a que se está enviando un valor numérico, el "Tipo de información" para este item puede establecerse en "Numérico (sin signo)" y el valor puede usarse en gráficos, 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"] #este item coincidirá con un registro de log "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" y enviará un registro modificado "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" al server.

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

El número de líneas coincidentes en un archivo de registro monitorizado que se rota.
Valor de retorno: Entero.
Ver plataformas soportadas.

Parámetros:

• file regexp - la ruta absoluta al archivo, con el nombre del archivo especificado usando una expresión regular. Tenga en cuenta que la expresión regular solo se aplica al nombre del archivo y no necesita coincidir con todo el nombre (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 líneas nuevas por segundo que el agent analizará (no puede exceder de 10000). El valor predeterminado es 10*'MaxLinesPerSecond' en zabbix_agentd.conf.
  
• mode - valores posibles: all (por defecto) o skip - omite el procesamiento de datos antiguos (afecta solo a los items recién creados).
  
• maxdelay - el retraso máximo en segundos. Tipo: float. Valores: 0 - (por defecto) nunca ignorar líneas del archivo de registro; > 0.0 - ignorar líneas antiguas para obtener las líneas más recientes analizadas dentro de los segundos de "maxdelay". ¡Lea las notas de maxdelay antes de usarlo!
  
• options - el tipo de rotación del archivo de registro y otras opciones. Valores posibles:
  rotate (por defecto),
  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 (por defecto),
  mtime-noreread - registros no únicos, volver a leer solo si cambia el tamaño (ignorar el cambio de hora de modificación).
  
• persistent dir (solo en zabbix_agentd en sistemas Unix; no soportado en 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 de registro por el agent y, por lo tanto, dependen del intervalo de actualización del item;
• La rotación de registros se basa en la última hora de modificación de los archivos;
• En el parámetro file regexp, la ruta del directorio de registro y la expresión regular del archivo de registro deben estar separadas por 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 registro y la expresión regular del archivo de registro (ver 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 para el patrón "pattern_to_match" en los archivos de registro 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 para el patrón "pattern_to_match" en los archivos de registro en el recurso compartido 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 para el patrón "^logfile[0-9]{1,3}$" en los archivos de registro en el 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 registro ubicados en "/home/user".

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

Lee datos de Modbus.
Valor devuelto: cadena JSON.
Plataformas soportadas: 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 serán descartados.

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

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

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

Comprueba el estado de un servicio DNS.
Valores de retorno: 0: falló la resolución de DNS (el servidor DNS no respondió o devolvió un error); 1: la resolución de DNS se realizó correctamente.
Consulte plataformas compatibles.

Parámetros:

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

Comentarios:

• Los valores posibles para tipo son: ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (no compatible con Zabbix Agent en Windows, Zabbix Agent 2 en todos los sistemas operativos), HINFO, MINFO, TXT, SRV
• Para búsquedas de DNS inversas (cuando "tipo" está configurado en PTR), puede proporcionar el nombre de DNS en formato inverso y no inverso (consulte los ejemplos a continuación). Tenga en cuenta que cuando se solicita el registro PTR, el nombre DNS es en realidad una dirección IP.
• No se admiten nombres de dominio internacionalizados; en su lugar, utilice nombres codificados con IDNA.

Ejemplos:

net.dns[198.51.100.1,ejemplo.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.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 de retorno: Float (0 - el servicio está caído; segundos - el número de segundos que se ha esperado la respuesta del servicio).
Consulte las plataformas compatibles.

Parámetros:

• ip (ignorado en Windows a menos que se utilice Zabbix agent 2): la dirección IP del servidor DNS (dejar vacío para el servidor DNS por defecto);
• name: el nombre DNS a consultar;
• type: el tipo de registro a consultar (por defecto es SOA);
• timeout (ignorado en Windows a menos que se utilice Zabbix agent 2): el tiempo de espera para la solicitud en segundos (por defecto es 1 segundo);
• count (ignorado en Windows a menos que se utilice Zabbix agent 2): el número de intentos para la solicitud (por defecto es 2);
• protocol: el protocolo utilizado para realizar las consultas DNS: udp (por defecto) o tcp.

Comentarios:

• Los valores posibles para type son:
  ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (no soportado para 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 (ver ejemplos abajo). Tenga en cuenta que cuando se solicita un registro PTR, el nombre DNS es en realidad una dirección IP.
• Los nombres de dominio internacionalizados no son compatibles, utilice nombres codificados en IDNA en su lugar.
• El elemento 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 monitorización DNS. Valor de retorno: una cadena de caracteres con el tipo de información requerida.
Consulte las plataformas compatibles.

Parámetros:

• ip (ignorado en Windows a menos que se utilice Zabbix agent 2): la dirección IP del servidor DNS (dejar en blanco para el servidor DNS por defecto);
• name: el nombre DNS a consultar;
• type: el tipo de registro a consultar (por defecto es SOA);
• timeout (ignorado en Windows a menos que se utilice Zabbix agent 2): el tiempo de espera para la solicitud en segundos (por defecto es 1 segundo);
• count (ignorado en Windows a menos que se utilice Zabbix agent 2): el número de intentos para la solicitud (por defecto es 2);
• protocol: el protocolo utilizado para realizar consultas DNS: udp (por defecto) 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 (vea los ejemplos a continuación). Tenga en cuenta que cuando se solicita un registro PTR, el nombre DNS es en realidad una dirección IP.
• Los nombres de dominio internacionalizados no son compatibles, utilice nombres codificados en IDNA en su lugar.

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.colisiones[if]

El número de colisiones fuera de la ventana.
Valor de retorno: Entero.
[Plataformas compatibles](#plataformas compatibles): Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. Se requieren privilegios de root en NetBSD.

Parámetro:

• if - nombre de la interfaz de red

net.if.discovery

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

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

Las estadísticas de tráfico entrante en una interfaz de red.
Valor de retorno: Integer.
Plataformas soportadas: 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 (por defecto)
  packets - número de paquetes
  errors - número de errores
  dropped - número de paquetes descartados
  overruns (fifo) - número de errores de búfer FIFO
  frame - número de errores de enmarcado 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 estadísticas de bytes por segundo;
• El modo dropped solo se admite en Linux, FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD;
• Los modos overruns, frame, compressed, multicast solo se admiten en Linux;
• En HP-UX este item no proporciona detalles sobre las 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 soportadas: 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 (por defecto)
  packets - número de paquetes
  errors - número de errores
  dropped - número de paquetes descartados
  overruns (fifo) - número de errores de 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 utilizar esta clave con el paso de preprocesamiento Cambio por segundo para obtener las estadísticas de bytes por segundo;
• El modo dropped solo es compatible con Linux, HP-UX;
• Los modos overruns, collision, carrier, compressed solo son compatibles con Linux;
• En HP-UX este item no proporciona detalles sobre las 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 soportadas: 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 (por defecto)
  packets - número de paquetes
  errors - número de errores
  dropped - número de paquetes descartados
  overruns (fifo) - número de errores de 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 Cambio por segundo para obtener estadísticas de bytes por segundo;
• El modo dropped solo es compatible con 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 con 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 soportadas: Linux, FreeBSD, Solaris, MacOS X, Windows.

Parámetro:

• port - número de puerto TCP

En los kernels de Linux 2.6.14 y superiores, la información sobre los 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>,puerto]

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

Parámetros:

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

Comentarios:

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

Ejemplo:

net.tcp.port[,80] #este elemento se puede utilizar para probar la disponibilidad del servidor web que se ejecuta en el puerto 80

net.tcp.service[servicio,<ip>,<puerto>]

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

Parámetros:

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

Comentarios:

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

Ejemplo:

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

net.tcp.service.perf[servicio,<ip>,<puerto>]

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

Parámetros:

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

Comentarios:

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

Ejemplo:

net.tcp.service.perf[ssh] #este elemento se puede utilizar para probar la velocidad de respuesta inicial del servidor SSH

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

Devuelve el número de sockets TCP 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 del servicio;
• raddr - la dirección IPv4/6 remota o subred CIDR;
• rport - el número de puerto remoto o nombre del servicio;
• state - el estado de la conexión (established, syn_sent, syn_recv, fin_wait1, fin_wait2, time_wait, close, close_wait, last_ack, listen, closing).

Ejemplo:

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

net.udp.listen[puerto]

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

Parámetro:

• puerto - número de puerto UDP

Ejemplo:

net.udp.escuchar[68]

net.udp.servicio[servicio,<ip>,<puerto>]

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

Parámetros:

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

Ejemplo:

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

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

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

Parámetros:

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

Ejemplo:

net.udp.service.perf[ntp] #este elemento se puede utilizar para probar el tiempo de respuesta del servicio NTP

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[<nombre>,<usuario>,<tipo>,<cmdline>,<modo>,<zona>]

El porcentaje de utilización de la CPU del proceso.
Valor de retorno: Flotador.
Plataformas compatibles: Linux, Solaris^{[6](#notas al pie)}.

Parámetros:

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

Comentarios:

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

Ejemplos:

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

proc.get[<nombre>,<usuario>,<línea_comando>,<modo>]

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

Parámetros:

• nombre: el nombre del proceso (por defecto todos los procesos);
• usuario: el nombre de usuario (por defecto todos los usuarios);
• línea_comando: filtrar por línea de comandos (es una expresión regular). Este parámetro no es compatible con Windows; en otras plataformas no es compatible si el modo está establecido en 'summary'.
• modo: valores posibles:
  process (por defecto), thread (no compatible con NetBSD), summary. Consulte la lista de parámetros de proceso devueltos para cada modo y SO.

Comentarios:

• Si no se puede recuperar un valor, por ejemplo, debido a un error (el proceso ya ha terminado, falta de permisos, fallo de llamada al sistema), se devolverá -1;
• Consulte las notas sobre la selección de procesos con los parámetros nombre y línea_comando (específico de Linux).

Ejemplos:

proc.get[zabbix_server,zabbix,,process] #lista de todos los procesos zabbix_server ejecutándose 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 ejecutándose 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 de retorno: 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 del usuario (el valor predeterminado es all users);
• mode - valores posibles: avg, max, min o sum (predeterminado);
• cmdline - filtrar por línea de comandos (es una expresión regular);
• memtype - el tipo de memoria utilizado por el proceso

Comentarios:

• El parámetro memtype solo es compatible con Linux, FreeBSD, Solaris⁶, AIX;
• Cuando varios procesos utilizan memoria compartida, la suma de la memoria utilizada por los procesos puede dar como resultado valores grandes y poco realistas.
  
  Consulte notas sobre cómo seleccionar procesos con los parámetros name y cmdline (específicos de Linux).
  
  Cuando se invoca este elemento desde la línea de comandos y contiene un parámetro de línea de comandos (por ejemplo, utilizando el modo de prueba del agente: zabbix_agentd -t proc.mem[,,,apache2]), se contará un proceso adicional, ya que el agente se contará a sí mismo.

Ejemplos:

proc.mem[,root] #la memoria utilizada por todos los procesos que se ejecutan bajo el usuario "root" proc.mem[zabbix_server,zabbix] #la memoria utilizada por todos los procesos zabbix_server que se ejecutan bajo el usuario zabbix proc.mem[,oracle,max,oracleZABBIX] #la memoria utilizada por el proceso que consume más memoria y 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 de retorno: Integer.
Plataformas soportadas: Linux, FreeBSD, Solaris⁶, HP-UX, AIX, OpenBSD, NetBSD, Windows.

Parámetros:

• name - el nombre del proceso (por defecto todos los procesos);
• user - el nombre de usuario (por defecto todos los usuarios);
• state - valores posibles:
  all (por defecto),
  disk - espera ininterrumpible,
  run - ejecutándose,
  sleep - espera interrumpible,
  trace - detenido,
  zomb - zombi;
• cmdline - filtrar por línea de comandos (es una expresión regular);
• zone - la zona objetivo: current (por defecto), o all. Este parámetro solo se admite en Solaris.

Comentarios:

• Los parámetros de estado disk y trace solo se admiten en Linux, FreeBSD, OpenBSD, 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 del agent: zabbix_agentd -t proc.num[,,,apache2]), se contará un proceso adicional, ya que el agent se contará a sí mismo.
• Cuando se establece el parámetro zone en current (o por defecto) en caso de que el agent se haya compilado en un Solaris sin soporte de zonas, pero se ejecute en un Solaris más reciente donde se admiten zonas, entonces el agent devolverá NOTSUPPORTED (el agent no puede limitar los resultados solo a la zona actual). Sin embargo, all está soportado 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 ejecutándose bajo el usuario mysql
proc.num[apache2,www-data] #el número de procesos apache2 ejecutándose bajo el usuario www-data
proc.num[,oracle,sleep,oracleZABBIX] #el número de procesos en estado sleep ejecutándose bajo Oracle que tengan oracleZABBIX en su línea de comandos

sensor[device,sensor,<mode>]

Lectura de sensor de hardware.
Valor de retorno: Float.
Plataformas soportadas: 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 se especifica el modo, entonces device y sensor se tratan como expresiones regulares.
• En Linux 2.6+ y OpenBSD, o si se omite el modo, 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 CPUs

sistema.tiempo de arranque

La hora de inicio del sistema.
Valor de retorno: Entero (marca de tiempo Unix).
[Plataformas compatibles](#plataformas compatibles): 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 las plataformas compatibles.

system.cpu.intr

El dispositivo se interrumpe.
Valor de retorno: Entero.
[Plataformas compatibles](#plataformas compatibles): Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

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

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

Parámetros:

• cpu - valores posibles: all (predeterminado) o percpu (la carga total dividida por el recuento de CPU en línea);
• mode - valores posibles: avg1 (promedio de un minuto, predeterminado), 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 se soporta en Linux, FreeBSD, Solaris, MacOS X.

Ejemplo:

system.cpu.num

sistema.cpu.conmutadores

El recuento de cambios de contexto.
Valor de retorno: Entero.
[Plataformas compatibles](#plataformas compatibles): Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

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

El porcentaje de utilización de la CPU.
Valor devuelto: 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 posteriores, Solaris, AIX.
• El parámetro de tipo interrupt solo se soporta en Linux 2.6 y posteriores, FreeBSD, OpenBSD.
• Los parámetros de tipo softirq, steal, guest, guest_nice solo se soportan en Linux 2.6 y posteriores.
• 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[<tipo>,<transformación>]

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

Parámetros:

• tipo - valores posibles: netbios (predeterminado en Windows), host (predeterminado en Linux), shorthost (devuelve parte del nombre de host antes del primer punto, una cadena completa para nombres sin puntos) , fqdn (devuelve un nombre de dominio completo);
• transformar - valores posibles: ninguno (predeterminado) o inferior (convertir a minúsculas).

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

Ejemplos de valores devueltos:

sistema.nombredehost → linux-w7x1
sistema.nombredehost → ejemplo.com
system.hostname[shorthost] → ejemplo
sistema.nombre de host → WIN-SERV2008-I6
sistema.nombredehost[host] → Win-Serv2008-I6LonG
system.hostname[host,inferior] → win-serv2008-i6long
system.hostname[fqdn,inferior] → blog.zabbix.com

sistema.hw.chassis[<info>]

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

Parámetro:

• info - valores posibles: completo (predeterminado), modelo, serie, tipo o proveedor

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, intente leer directamente desde la memoria;
• Se requieren permisos de root porque el valor se adquiere leyendo desde sysfs o memoria.

Ejemplo:

system.hw.chassis[completo] → Hewlett-Packard HP Pro 3010 PC de factor de forma pequeño CZXXXXXXXXX Escritorio

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

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

Parámetros:

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

Comentarios:

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

Ejemplo:

system.hw.cpu[0,proveedor] → AuténticoAMD

sistema.hw.dispositivos[<tipo>]

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

Parámetro:

• tipo - pci (predeterminado) o usb

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

Ejemplo:

system.hw.devices → 00:00.0 Puente de host: Microdispositivos avanzados [AMD] Puente de host RS780

system.hw.macaddr[<interfaz>,<formato>]

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

Parámetros:

• interfaz - todos (predeterminado) o una [expresión] normal (/manual/regular_expressions#overview);
• formato - completo (predeterminado) o corto

Comentarios:

• Enumera las direcciones MAC de las interfaces cuyo nombre coincide con la [expresión] regular interfaz dada (/manual/regular_expressions#overview) (todas las listas para todas las interfaces);
• Si "formato" se especifica como corto, los nombres de interfaz y las direcciones MAC idénticas no aparecen en la lista.

Ejemplo:

system.hw.macaddr["eth0$",completo] → [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 - (por defecto) el tiempo desde la Época (00:00:00 UTC, 1 de enero de 1970), medido en segundos o local - la hora en el formato 'yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm'

Debe usarse como una comprobación pasiva para el agent de Zabbix; en el agent 2 de Zabbix 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 *Reloj* del dashboard.

system.run[comando,<modo>]

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

Parámetros:

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

Comentarios:

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

Ejemplo:

system.run[ls -l /] #devuelve una lista detallada de archivos del directorio raíz

system.stat[resource,<type>]

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

Parámetros:

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

Comentarios:

• Tenga en cuenta las siguientes limitaciones en estos elementos:
  system.stat[cpu,app]: solo compatible en AIX LPAR de tipo "Shared"
  system.stat[cpu,ec]: compatible en AIX LPAR de tipo "Shared" y "Dedicated" ("Dedicated" siempre devuelve 100 (por ciento))
  system.stat[cpu,lbusy]: solo compatible 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"

sistema.sw.arch

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

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

Ejemplo:

sistema.sw.arch → i686

system.sw.os[<info>]

La información del sistema operativo.
Valor de retorno: Cadena.
Plataformas compatibles: Linux, Windows.

Parámetro:

• info: valores posibles: full (por defecto), short o name

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

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

Ejemplos:

system.sw.os[short] → Ubuntu 2.6.35-28.50-generic 2.6.35.11
system.sw.os[full] → [s|Windows 10 Enterprise 22621.1.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 compatibles: Linux, Windows.

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

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

Parámetros:

• regexp - todos (predeterminado) o una [expresión] normal (/manual/regular_expressions#overview);
• administrador - todos (predeterminado) o un administrador de paquetes;
• formato - completo (predeterminado) o corto.

Comentarios:

• Enumera (alfabéticamente) los paquetes instalados cuyo nombre coincide con la [expresión] regular dada (/manual/regular_expressions#overview) (todos los enumera todos);
• Administradores de paquetes compatibles (comando ejecutado):
  dpkg (dpkg --get-selections)
  pkgtool (ls /var/log/packages)
  rpm (rpm -qa)
  pacman (pacman - Q)
  transporte
• Si formato se especifica como completo, los paquetes se agrupan por administradores de paquetes (cada administrador en una línea separada que comienza con su nombre entre corchetes);
• Si se especifica "formato" como corto, 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 de retorno: cadena JSON.
Plataformas compatibles: Linux.

Parámetros:

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

Comentarios:

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

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

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

Parámetros:

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

Comentarios:

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

Ejemplo:

system.swap.in[,páginas]

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

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

Parámetros:

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

Comentarios:

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

Ejemplo:

sistema.intercambio.out[,páginas]

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

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

Parámetros:

• device - especifica el dispositivo utilizado para swap (solo FreeBSD) o all (por defecto);
• type - valores posibles: free (espacio de swap libre, por defecto), pfree (espacio de swap libre, en porcentaje), pused (espacio de swap usado, en porcentaje), total (espacio de swap total), o used (espacio de swap 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 el dispositivo, el agent de Zabbix solo tendrá en cuenta los dispositivos de swap (archivos), la memoria física será ignorada. Por ejemplo, en sistemas Solaris el comando swap -s incluye una porción de memoria física y 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 de retorno: Integer.
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.

sistema.usuarios.num

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

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

vfs.dev.discovery

La lista de dispositivos de bloques y su tipo. Se utiliza para la detección a bajo nivel.
Valor de retorno: cadena JSON.
Plataformas compatibles: Linux.

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

El disco lee estadísticas.
Valor de retorno: Entero - con tipo en sectores, operaciones, bytes; Float - con type en sps, ops, bps.
Plataformas soportadas: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parámetros:

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

Comentarios:

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

Ejemplo:

vfs.dev.read[,operaciones]

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

Las estadísticas de escritura en disco.
Valor de retorno: Entero - con tipo en sectores, operaciones, bytes; Float - con type en sps, ops, bps.
Plataformas soportadas: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parámetros:

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

Comentarios:

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

Ejemplo:

vfs.dev.write[,operaciones]

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 número de entradas en el directorio.
Valor devuelto: Entero.
Ver plataformas soportadas.

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 todos si está vacío (valor por defecto);
• 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 ninguno si está vacío (valor por defecto);
• 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 (por defecto), es decir, "file,dir,sym,sock,bdev,cdev,fifo". Se deben separar varios tipos con comas y entre comillas.
• types excl - tipos de entradas de directorio (ver 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 ese tipo NO se cuentan.
• max depth - la profundidad máxima de subdirectorios a recorrer:
  -1 (por defecto) - ilimitado,
  0 - no descender a subdirectorios.
• min size - el tamaño mínimo (en bytes) para que el archivo sea contado. Los archivos más pequeños no se contarán. Se pueden usar sufijos de memoria.
• max size - el tamaño máximo (en bytes) para que el archivo sea contado. Los archivos más grandes no se contarán. Se pueden usar sufijos de memoria.
• min age - la antigüedad mínima (en segundos) de la entrada de directorio para ser contada. Las entradas más recientes no se contarán. Se pueden usar sufijos de tiempo.
• max age - la antigüedad máxima (en segundos) de la entrada de directorio para ser contada. Las entradas tan antiguas y más antiguas no se contarán (hora de modificación). Se pueden usar sufijos de tiempo.
• 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;
• No se admiten variables de entorno, por ejemplo, %APP_HOME%, $HOME y %TEMP%;
• Los pseudo-directorios "." y ".." nunca se cuentan;
• 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 calcular el número de entradas, pero se ignoran al elegir subdirectorios para 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 seg). Dado que el recorrido de directorios grandes puede tardar más que eso, no se devolverán datos y el item pasará a no soportado. 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ños cero, por ejemplo, el tamaño de /dev/sda1 no refleja el tamaño de la partición respectiva. 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] #monitorea el número de dispositivos en /dev (Linux)
vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] #monitorea 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 de retorno: cadena JSON.
Ver plataformas soportadas.

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 todos si está vacío (valor por defecto);
• 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 ninguno si está vacío (valor por defecto);
• 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 (por defecto), es decir, "file,dir,sym,sock,bdev,cdev,fifo". Se deben separar varios tipos con comas y entre comillas.
• types excl - tipos de entradas de directorio (ver 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 este tipo NO se listarán.
• max depth - la profundidad máxima de subdirectorios a recorrer:
  -1 (por defecto) - ilimitado,
  0 - no descender a subdirectorios.
• min size - el tamaño mínimo (en bytes) para que el archivo sea listado. Los archivos más pequeños no se listarán. Se pueden usar sufijos de memoria.
• max size - el tamaño máximo (en bytes) para que el archivo sea listado. Los archivos más grandes no se listarán. Se pueden usar sufijos de memoria.
• min age - la antigüedad mínima (en segundos) de la entrada de directorio a listar. Las entradas más recientes no se listarán. Se pueden usar sufijos de tiempo.
• max age - la antigüedad máxima (en segundos) de la entrada de directorio a listar. Las entradas tan antiguas y más antiguas no se listarán (hora de modificación). Se pueden usar sufijos de tiempo.
• 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;
• No se admiten variables de entorno, por ejemplo, %APP_HOME%, $HOME y %TEMP%;
• Los pseudo-directorios "." 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 elegir los subdirectorios a 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. Dado que el recorrido de directorios grandes puede tardar más que eso, no se devolverán datos y el item pasará a no soportado. 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ños cero, por ejemplo, el tamaño de /dev/sda1 no refleja el tamaño de la partición respectiva. 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 de retorno: Integer.
Plataformas soportadas: Linux, Windows. El item puede funcionar en otras plataformas tipo UNIX.

Parámetros:

• dir - la ruta absoluta al directorio;
• regex incl - una expresión regular que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) a incluir; incluir todos si está vacío (valor por defecto);
• 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 ninguno si está vacío (valor por defecto);
• mode - valores posibles: apparent (por defecto) - obtiene los tamaños aparentes de los archivos en lugar del uso en disco (actúa como du -sb dir), disk - obtiene el uso en 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 (por defecto) - ilimitado, 0 - no desciende 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 el contenido.
• Con directorios grandes o discos lentos, este item puede agotar el tiempo de espera debido al parámetro Timeout en los archivos de configuración del agent y del server/proxy. Aumente los valores de timeout según sea necesario.
• El límite de tamaño de archivo depende del soporte de archivos grandes.

Ejemplos:

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

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

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

Parámetros:

• file - la ruta completa al archivo;
• mode - crc32 (por defecto), 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 de 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: Texto.
Consulte las plataformas soportadas.

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 ser un riesgo de seguridad;
• El valor devuelto está limitado a 16MB (incluyendo los espacios en blanco finales que se truncan); 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,<tipos incl>,<tipos excl>]

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

Parámetros:

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

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede ser un riesgo de seguridad;
• Varios tipos deben separarse con una coma y todo el conjunto entrecomillado "";
• Si el mismo tipo está en ambos <tipos_incl> y <tipos_excl>, los archivos de este tipo se excluyen;
• El límite de tamaño de archivo depende del soporte de 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 devuelto: cadena JSON.
Consulte las plataformas compatibles.

Parámetro:

• file - la ruta completa al archivo

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede ser un riesgo de seguridad;
• Tipos de archivos 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 del soporte de archivos grandes.

Ejemplo:

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

vfs.file.md5sum[file]

La suma de comprobación MD5 del archivo.
Valor devuelto: Cadena de caracteres (hash MD5 del archivo).
Consulte las plataformas soportadas.

Parámetro:

• file - la ruta completa al archivo

Comentarios:

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

Ejemplo:

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

Ejemplo de valor devuelto:

b5052decb577e0fffd622d6ddc017e82

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

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

Parámetros:

• file - la ruta completa al archivo;
• ownertype - user (por defecto) o group (solo Unix);
• resulttype - name (por defecto) 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 del soporte de 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[archivo]

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

Parámetros:

• archivo - la ruta completa al archivo

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

Ejemplo:

vfs.file.permissions[/etc/passwd] #devuelve 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 (primera línea del archivo por defecto);
• end line: el número de la última línea a buscar (última línea del archivo por defecto);
• output: una plantilla de formato de salida opcional. La secuencia de escape \0 se reemplaza por la parte de 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 excede el número de grupos capturados).

Comentarios:

• En Windows, este item sigue rutas UNC, lo que puede ser un riesgo de seguridad;
• El límite de tamaño del archivo depende de la compatibilidad con 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 usando 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] → obtener el ID del usuario *zabbix*

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

Busca una cadena en el archivo⁷.
Valores de retorno: 0 - coincidencia no encontrada; 1 - encontrada.
Consulte las plataformas soportadas.

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 (primera línea del archivo por defecto);
• end line - el número de la última línea a buscar (última línea del archivo por defecto).

Comentarios:

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

Ejemplo:

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

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

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

Parámetros:

• file - la ruta completa al archivo;
• mode - valores posibles: bytes (por defecto) o 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 de archivos grandes.

Ejemplo:

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

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

La información de tiempo del archivo.
Valor devuelto: Integer (timestamp Unix).
Ver plataformas soportadas.

Parámetros:

• file - la ruta completa al archivo;
• mode - valores posibles:
  modify (por defecto) - la última vez que se modificó el contenido del archivo,
  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 ser un riesgo de seguridad;
• El límite de tamaño de archivo depende del soporte de 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 en disco disponible, estadísticas de inodos y opciones de montaje. Puede usarse para el descubrimiento de bajo nivel.
Valor de retorno: cadena JSON.
Plataformas soportadas: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Comentarios:

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

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

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

Parámetros:

• fs - el sistema de archivos;
• modo - valores posibles: total (predeterminado), gratis, usado, pfree (gratis, porcentaje) o pused (usado, porcentaje).

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

Ejemplo:

vfs.fs.inode[/,pfree]

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

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

Parámetros:

• fs - el sistema de archivos;
• modo - valores posibles: total (predeterminado), gratis, usado, pfree (gratis, 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 cuando se utiliza el modo libre.

Ejemplo:

vfs.fs.size[/tmp,gratis]

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.
Ver plataformas soportadas.

Parámetro:

• mode - valores posibles: total (por defecto), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (usado, 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,<ruta>,<puerto>]

Obtiene el contenido de una página web.
Valor de retorno: Código fuente de la página web como texto (incluyendo cabeceras).
Consulte las plataformas soportadas.

Parámetros:

• host - el nombre del host o URL (como scheme://host:port/path, donde solo host es obligatorio). Esquemas de URL permitidos: http, https⁴. Un esquema ausente se tratará como http. Si se especifica una URL, ruta y puerto 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 soporte de cURL ⁴. Punycode es compatible en nombres de host.
• ruta - la ruta a un documento HTML (por defecto es /);
• puerto - el número de puerto (por defecto es 80 para HTTP)

Comentarios:

• Este elemento se vuelve no soportado 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 la dirección IPv6 el agente Zabbix debe estar compilado con soporte para IPv6 habilitado.

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,<ruta>,<puerto>]

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

Parámetros:

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

Comentarios:

• Este elemento se vuelve no 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 la dirección IPv6, el agente Zabbix debe compilarse con soporte para IPv6 habilitado.

Ejemplos:

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

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

Busca 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 URL (como scheme://host:port/path, donde solo host es obligatorio). Los esquemas de URL permitidos son: http, https⁴. Un esquema ausente 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 soporte cURL ⁴. Se admite Punycode en los nombres de host.
• path: la ruta a un documento HTML (por defecto es /);
• port: el número de puerto (por defecto es 80 para HTTP)
• regexp: una expresión regular que describe el patrón requerido;
• length: el número máximo de caracteres a devolver;
• output: una plantilla de formato de salida opcional. 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 excede el número de grupos capturados).

Comentarios:

• Este item pasa a no soportado 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 la dirección IPv6 el agent de Zabbix debe estar compilado con soporte IPv6 habilitado.
• La extracción de contenido usando 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]

agente.hostmetadata

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

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

agente.nombre de host

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

Devoluciones:

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

agente.ping

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

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

agente.variante

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

agente.versión

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

Ejemplo de valor devuelto:

6.0.3

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

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

Parámetros:

• ip: la lista de IP/DNS/máscaras de red de los servers/proxies a consultar remotamente (por defecto es 127.0.0.1);
• port: el puerto del server/proxy a consultar remotamente (por defecto es 10051)

Comentarios:

• Este item devuelve un conjunto seleccionado de métricas internas. Para más detalles, consulte Supervisión remota de estadísticas de Zabbix.
• Tenga en cuenta que la solicitud de estadísticas solo será aceptada desde las direcciones listadas en el parámetro 'StatsAllowedIP' del 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 están retrasados en el server o proxy de Zabbix. Si se especifican ip y port, las métricas se recuperan de la instancia remota; de lo contrario, de la instancia local.
Valor de retorno: cadena JSON.
Consulte las plataformas soportadas.

Parámetros:

• ip - la lista de IP/DNS/máscara de red de los servers/proxies a consultar remotamente (por defecto es 127.0.0.1);
• port - el puerto del server/proxy a consultar remotamente (por defecto es 10051)
• queue - constante (para ser usada tal cual)
• from - retrasado al menos (por defecto es 6 segundos)
• to - retrasado como máximo (por defecto es infinito)

Tenga en cuenta que la solicitud de estadísticas solo será aceptada desde las direcciones listadas en el parámetro 'StatsAllowedIP' del server/proxy en la instancia de destino.

Notas al pie

¹Nota específica de Linux. El agent de Zabbix debe tener acceso de solo lectura al sistema de archivos /proc. Los parches del kernel de www.grsecurity.org limitan los derechos de acceso de los usuarios sin privilegios.

² vfs.dev.read[], vfs.dev.write[]: El agent de Zabbix finalizará 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 utilizan un intervalo de actualización de 3 horas o más, siempre devolverán '0'.

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

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

⁵ Los valores bytes y errors no son compatibles para interfaces de loopback en sistemas Solaris hasta e incluyendo Solaris 10 6/06, ya que las estadísticas de bytes, errores y utilización no son almacenadas y/o reportadas por el kernel. Sin embargo, si está monitorizando un sistema Solaris a través de net-snmp, se pueden devolver valores ya que net-snmp incluye código heredado de cmu-snmp de 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 supone que la longitud media de un paquete es de 308 octetos, lo que es una estimación muy aproximada, ya que el límite de MTU en sistemas Solaris para interfaces de loopback es de 8892 bytes. No se debe asumir que estos valores sean correctos o siquiera cercanos a la realidad. Son estimaciones. El agent de Zabbix no realiza ninguna suposició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 estaba 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 confidencial, ejecute el agent de Zabbix 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 utilizar claves de elementos con zabbix_agentd o zabbix_get desde la línea de comando también debes considerar la sintaxis del shell.

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

Ejemplos:

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

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

Configuración de la 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) se puede encontrar en la documentación de libiconv (Proyecto GNU) o en la documentación de Microsoft Windows SDK para "Identificadores de página de códigos". Tenga en cuenta que Microsoft a veces marca algunas páginas de códigos como "disponibles solo para aplicaciones administradas", es decir, expuestas solo a través del tiempo de ejecución de .NET y no disponibles a través de las API nativas de Win32. El 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 el 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 la codificación (o es una cadena vacía), se asume que es UTF-8, los datos se procesan "tal cual";
• Análisis de BOM: aplicable para 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 la resolución estándar (ver arriba).

Solución de problemas de elementos del agente

En el caso de comprobaciones pasivas, para evitar que ese elemento no obtenga ningún valor porque la solicitud del servidor al agente caduca primero, cabe señalar lo siguiente:

• Cuando la versión del agente es anterior a la versión del servidor, el valor de Tiempo de espera en la configuración del elemento (o [tiempo de espera global](/manual/web_interface/frontend_sections/administration/general #timeouts)) puede necesitar ser mayor que el valor de Timeout en el [archivo de configuración] del agente (/manual/appendix/config/zabbix_agentd#timeout).
• Cuando la versión del agente es más reciente que la versión del servidor, es posible que el valor de "Tiempo de espera" en el servidor [archivo de configuración] (/manual/appendix/config/zabbix_server#timeout) deba ser mayor que el valor de "Tiempo de espera" en el agente configuración archivo.