Esta sección proporciona detalles sobre las claves de métricas que utilizan la comunicación con el agente de Zabbix para la recopilación de datos.
Hay comprobaciones pasivas y activas de agentes . Al configurar una métrica puede seleccionar el tipo requerido:
Tenga en cuenta que todas las claves de métricas admitidas por el agente Zabbix en Windows también son compatibles con el agente Zabbix 2 de nueva generación. Consulte las claves de métricas adicionales que puede usar solo con el agente 2.
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:
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.
Los parámetros sin corchetes angulares son obligatorios. Los parámetros marcados con corchetes angulares < > son opcionales.
La cantidad máxima de archivos abiertos admitidos por el sistema operativo.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.
El número máximo de procesos admitidos por el sistema operativo.
Valor de retorno: Entero.
Plataformas compatibles: Linux 2.6 y posteriores, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.
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).
La supervisión de un archivo de registro.
Valor de retorno: Registro.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
Ejemplos:
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.
El recuento de líneas coincidentes en un archivo de registro monitoreado.
Valor de retorno: Entero.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
La supervisión de un archivo de registro que se rota.
Valor de retorno: Registro.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
Ejemplos:
logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] #este elemento 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 elemento recopilará datos de archivos como "logfile_abc_1" o "archivo de registro__001"
Ejemplo de uso del parámetro "salida" para extraer un número del registro:
logrt[/app1/^test.*log$,"tarea ejecutada [0-9.]+ segundos, registros procesados ([0-9]+), [0-9]+ errores",,,,\1] #este elemento coincidirá con un registro "2015-11-13 10:08:26 tarea ejecutada 6,08 segundos, procesado 6080 registros, 0 errores" y enviará solo '6080' al servidor. Debido a que se envía un valor numérico, el "Tipo de información" para 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:
logrt[/app1/^test.*log$,"([0-9 :-]+) tarea ejecutada ([0-9.]+) segundos, registros procesados ([0-9]+), ([0 -9]+) errores",,,,"\1 REGISTROS: \3, ERRORES: \4, DURACIÓN: \2"] #este elemento coincidirá con un registro "2015-11-13 10:08:26 tarea ejecute 6,08 segundos, procesó 6080 registros, 0 errores" y envíe un registro modificado "2015-11-13 10:08:26 REGISTROS: 6080, ERRORES: 0, DURACIÓN: 6,08" al servidor. |
El recuento de líneas coincidentes en un archivo de registro monitoreado que se rota.
Valor de retorno: Entero.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
Lee datos Modbus.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux.
Parámetros:
protocol://connection_string
;Consulte una descripción detallada de parámetros.
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:
Comentarios:
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, SRVEjemplos:
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]
Comprueba el rendimiento de un servicio DNS.
Valor de retorno: Float (0: el servicio está inactivo; segundos: la cantidad de segundos transcurridos esperando una respuesta del servicio).
Consulte plataformas compatibles.
Parámetros:
Comentarios:
tipo
son:Ejemplos:
net.dns.perf[198.51.100.1,ejemplo.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 ]
Realiza una consulta DNS.
Valor de retorno: una cadena de caracteres con el tipo de información requerida.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
tipo
son:Ejemplos:
registro.net.dns[198.51.100.1,ejemplo.com,MX,2,1]
registro.net.dns[,198.51.100.1,PTR]
registro.net.dns[,1.100.51.198.in-addr.arpa,PTR]
registro.net.dns[,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 ]
El número de colisiones fuera de la ventana.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. Se requieren privilegios de root en NetBSD.
Parámetro:
La lista de interfaces de red. Se utiliza para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.
Las estadísticas del tráfico entrante en una interfaz de red.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Se requieren privilegios de root en NetBSD.
Parámetros:
Comentarios:
Ejemplos:
Las estadísticas de tráfico saliente en una interfaz de red.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Se requieren privilegios de root en NetBSD.
Parámetros:
Comentarios:
Ejemplos:
La suma de las estadísticas de tráfico entrante y saliente en una interfaz de red.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. Se requieren privilegios de root en NetBSD.
Parámetros:
Comentarios:
net.if.in
como net.if.out
funcionan para paquetes descartados en su plataforma.Ejemplos:
Comprueba si este puerto TCP está en estado ESCUCHA.
Valores de retorno: 0: no está en estado ESCUCHA; 1 - está en estado ESCUCHA.
Plataformas compatibles: Linux, FreeBSD, Solaris, MacOS X.
Parámetro:
En los kernels de Linux 2.6.14 y superiores, la información sobre la escucha de sockets TCP se obtiene de la interfaz NETLINK del kernel, si es posible. De lo contrario, la información se recupera de los archivos /proc/net/tcp y /roc/net/tcp6.
Ejemplo:
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:
Comentarios:
net.tcp.service.perf[tcp,<ip>,<port>]
;Ejemplo:
net.tcp.port[,80] #este elemento se puede utilizar para probar la disponibilidad del servidor web que se ejecuta en el puerto 80
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:
Comentarios:
net.tcp.port[]
para comprobaciones como estas.Ejemplo:
net.tcp.service[ftp,,45] #este elemento se puede utilizar para probar la disponibilidad del servidor FTP en el puerto TCP 45
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:
Comentarios:
net.tcp.service.perf[tcp,<ip>,<port>]
para comprobaciones como estas.Ejemplo:
net.tcp.service.perf[ssh] #este elemento se puede utilizar para probar la velocidad de respuesta inicial del servidor SSH
Devuelve el número de sockets TCP que coinciden con los parámetros.
Valor de retorno: Entero.
Plataformas compatibles: Linux.
Parámetros:
Ejemplo:
net.tcp.socket.count[,80,,,establecido] #el número de conexiones al puerto TCP local 80 en el estado establecido
Comprueba si este puerto UDP está en estado ESCUCHA.
Valores de retorno: 0: no está en estado ESCUCHA; 1 - está en estado ESCUCHA.
Plataformas compatibles: Linux, FreeBSD, Solaris, MacOS X.
Parámetro:
Ejemplo:
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:
Ejemplo:
net.udp.service[ntp,,45] #este elemento se puede utilizar para probar la disponibilidad del servicio NTP en el puerto UDP 45
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:
Ejemplo:
net.udp.service.perf[ntp] #este elemento se puede utilizar para probar el tiempo de respuesta del servicio NTP
Devuelve el número de sockets UDP que coinciden con los parámetros.
Valor de retorno: Entero.
Plataformas compatibles: Linux.
Parámetros:
Ejemplo:
El porcentaje de utilización de la CPU del proceso.
Valor de retorno: Flotador.
Plataformas compatibles: Linux, Solaris6.
Parámetros:
Comentarios:
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
La lista de procesos del sistema operativo y sus parámetros. Se puede utilizar para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Plataformas soportadas: Linux, FreeBSD, Windows, OpenBSD, NetBSD.
Parámetros:
Comentarios:
-1
;name
y cmdline
(específicos de Linux).Ejemplos:
proc.get[zabbix_server,zabbix,,process] #lista de todos los procesos zabbix_server que se ejecutan bajo el usuario zabbix, devuelve una entrada por PID
proc.get[java,,,thread] #lista de todos los procesos Java, devuelve una entrada por hilo
proc.get[,zabbix,,summary] #datos combinados para procesos de cada tipo que se ejecutan bajo el usuario zabbix, devuelve una entrada por nombre de proceso
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:
Comentarios:
memtype
solo es compatible con Linux, FreeBSD, Solaris6, AIX;name
y cmdline
(específicos de Linux).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
El número de procesos.
Valor de retorno: Integer.
Plataformas compatibles: Linux, FreeBSD, Solaris6, HP-UX, AIX, OpenBSD, NetBSD.
Parámetros:
Comentarios:
zabbix_agentd -t proc.num[,,,apache2]
), se contará un proceso adicional, ya que el agente se contará a sí mismo;zone
como current (o predeterminado) en caso de que el agente haya sido compilado en un Solaris sin soporte de zona, pero que se ejecute 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, all es compatible en este caso.name
y cmdline
(específico de Linux).Ejemplos:
proc.num[,mysql] #la cantidad de procesos que se ejecutan bajo el usuario mysql
proc.num[apache2,www-data] #la cantidad de procesos apache2 que se ejecutan bajo el usuario www-data
proc.num[,oracle,sleep,oracleZABBIX] #la cantidad de procesos en estado de suspensión que se ejecutan bajo Oracle que tiene oracleZABBIX en su línea de comandos
Lectura del sensor de hardware.
Valor de retorno: Flotador.
Plataformas compatibles: Linux, OpenBSD.
Parámetros:
Comentarios:
Ejemplo:
sensor[w83781d-i2c-0-2d,temp1]
sensor[cpu0,temp0] #la temperatura de una CPU
sensor["cpu[0-2]$",temp,avg] #la temperatura promedio de las tres primeras CPUs
La hora de inicio del sistema.
Valor de retorno: Entero (marca de tiempo Unix).
Plataformas compatibles: Linux, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.
La lista de CPU/núcleos de CPU detectados. Se utiliza para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Consulte plataformas compatibles.
El dispositivo se interrumpe.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.
La carga de CPU.
Valor de retorno: Flotante.
Consulte plataformas compatibles.
Parámetros:
Ejemplo:
system.cpu.load[,avg5]
El número de CPU.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.
Parámetro:
El parámetro de tipo max solo se admite en Linux, FreeBSD, Solaris y MacOS X.
Ejemplo:
El recuento de cambios de contexto.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.
El porcentaje de utilización de la CPU.
Valor de retorno: Flotante.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.
Parámetros:
Comentarios:
Ejemplo:
El nombre del host del sistema.
Valor de retorno: Cadena.
Consulte plataformas compatibles.
Parámetros:
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
La información del chasis.
Valor de retorno: Cadena.
Plataformas compatibles: Linux.
Parámetro:
Comentarios:
Ejemplo:
system.hw.chassis[completo] → Hewlett-Packard HP Pro 3010 PC de factor de forma pequeño CZXXXXXXXXX Escritorio
La información de la CPU.
Valor de retorno: Cadena o Entero.
Plataformas compatibles: Linux.
Parámetros:
Comentarios:
/proc/cpuinfo
y /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq
;Ejemplo:
El listado de dispositivos PCI o USB.
Valor de retorno: Texto.
Plataformas compatibles: Linux.
Parámetro:
Devuelve el resultado de la utilidad lspci o lsusb (ejecutada sin ningún parámetro).
Ejemplo:
La lista de direcciones MAC.
Valor de retorno: Cadena.
Plataformas compatibles: Linux.
Parámetros:
Comentarios:
interfaz
dada (/manual/regular_expressions#overview) (todas las listas para todas las interfaces);Ejemplo:
La hora del sistema.
Valor de retorno: Entero - con tipo
como utc; Cadena - con tipo
como local.
Consulte plataformas compatibles.
Parámetros:
Debe usarse como verificación pasiva únicamente.
Ejemplo:
system.localtime[local] #crea un elemento usando esta clave y luego úsala para mostrar la hora del host en el widget del panel *Reloj*.
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:
Comentarios:
Ejemplo:
Las estadísticas del sistema.
Valor de retorno: Entero o flotante.
Plataformas compatibles: AIX.
Parámetros:
Comentarios:
system.stat[cpu,app]
: compatible solo con AIX LPAR de tipo "Compartido"system.stat[cpu,ec]
- compatible con AIX LPAR de tipo "Compartido" y "Dedicado" ("Dedicado" siempre devuelve 100 (por ciento))system.stat[cpu,lbusy]
: compatible solo con AIX LPAR de tipo "Compartido"system.stat[cpu,pc]
- compatible con AIX LPAR de tipo "Compartido" y "Dedicado"system.stat[ent]
- compatible con AIX LPAR de tipo "Compartido" y "Dedicado"
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:
La información del sistema operativo.
Valor de retorno: Cadena.
Plataformas compatibles: Linux, Windows.
Parámetro:
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
(completo) en Linux;/proc/version_signature
(corto) en Linux;/etc/os-release
en sistemas Linux que lo soporten o /etc/issue.net
(nombre);HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion
en Windows.Ejemplos:
system.sw.os[corto] → Ubuntu 2.6.35-28.50-generic 2.6.35.11
system.sw.os[completo] → [s|Windows 10 Enterprise 22621.1.asd64fre.ni_release.220506-1250 Build 22621.963]
Información detallada sobre el sistema operativo (versión, tipo, nombre de distribución, versión menor y mayor, etc.).
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux, Windows.
La lista de paquetes instalados.
Valor de retorno: Texto.
Plataformas compatibles: Linux.
Parámetros:
Comentarios:
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);Ejemplo:
Una lista detallada de los paquetes instalados.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux.
Parámetros:
Comentarios:
Las estadísticas de intercambio (del dispositivo a la memoria).
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, OpenBSD.
Parámetros:
Comentarios:
Ejemplo:
Las estadísticas de intercambio (de la memoria al dispositivo).
Valor de retorno: Entero.
Plataformas soportadas: Linux, FreeBSD, OpenBSD.
Parámetros:
Comentarios:
/proc/swaps
, /proc/partitions
, /proc/stat
(Linux 2.4)/proc/swaps
, /proc/diskstats
, /proc/vmstat
(Linux 2.6)Ejemplo:
El tamaño del espacio de intercambio en bytes o en porcentaje del total.
Valor de retorno: Entero - para bytes; Flotante - para porcentaje.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, OpenBSD.
Parámetros:
Comentarios:
swap -s
incluye una parte de la memoria física y los dispositivos de intercambio (a diferencia de swap -l
).Ejemplo:
Identificación del sistema.
Valor de retorno: Cadena.
Consulte plataformas compatibles.
Comentarios:
Ejemplo:
system.uname → FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: lunes noviembre i386
system.uname → Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86
El tiempo de actividad del sistema en segundos.
Valor de retorno: Entero.
Plataformas compatibles: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD.
En configuración de la métrica, use unidades s o uptime para obtener valores legibles.|
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.
La lista de dispositivos de bloque y su tipo. Se utiliza para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux.
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:
type
en: sps, ops, bps.Comentarios:
mode
solo se admite en Linux, FreeBSD;sda
), así como un prefijo /dev/ opcional (por ejemplo, /dev/sda
);Ejemplo:
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:
type
en: sps, ops, bps.Comentarios:
mode
solo se admite en Linux, FreeBSD;sda
), así como un prefijo /dev/ opcional (por ejemplo, /dev/sda
);Ejemplo:
El recuento de entradas del directorio.
Valor de retorno: Entero.
Consulte plataformas compatibles.
Parámetros:
tipos incluidos
) que NO se cuentan. Si algún tipo de entrada está tanto en "tipos incluidos" como en "tipos excluidos", las entradas de directorio de este tipo NO se cuentan.Comentarios:
regex incl
como regex excl
se aplican a archivos y directorios al calcular el recuento de entradas, pero se ignoran al seleccionar los subdirectorios para recorrer (si regex incl
es “(?i)^.+\ .zip$” y max Depth
no están configurados, entonces se recorrerán todos los subdirectorios, pero solo se contarán los archivos de tipo zip).<min_size>
y <max_size>
, es recomendable especificar <types_incl>
como "archivo", para evitar sorpresas.Ejemplos:
vfs.dir.count[/dev] #monitorea la cantidad de dispositivos en /dev (Linux)
vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] #monitorea la cantidad de archivos en un directorio temporal
La lista de entradas del directorio.
Valor de retorno: objeto JSON.
Consulte plataformas compatibles.
Parámetros:
tipos incluidos
) para NO enumerar. Si algún tipo de entrada está tanto en "tipos incluidos" como en "tipos excluidos", las entradas de directorio de este tipo NO se enumeran.regex excl
)Comentarios:
regex incl
como regex excl
se aplican a archivos y directorios al generar la lista de entradas, pero se ignoran al seleccionar subdirectorios para recorrer (si regex incl
es “(?i)^.+\ .zip$” y max Depth
no están configurados, entonces se recorrerán todos los subdirectorios, pero solo se contarán los archivos de tipo zip).min size
y max size
, es recomendable especificar types incl
como "archivo", para evitar sorpresas.Ejemplos:
vfs.dir.get[/dev] #recupera la lista de dispositivos en /dev (Linux)
vfs.dir.get["C:\Users\ADMINI~1\AppData\Local\Temp"] # recupera la lista de archivos en un directorio temporal
El tamaño del directorio (en bytes).
Valor de retorno: Entero.
Plataformas compatibles: Linux. El elemento puede funcionar en otras plataformas similares a UNIX.
Parámetros:
du -sb dir
), disk - obtiene el uso del disco (actúa como du -s -B1 directorio
). A diferencia del comando du
, el elemento vfs.dir.size tiene en cuenta los archivos ocultos al calcular el tamaño del directorio (actúa como du -sb .[^.]* *
dentro del directorio).regex excl
)Comentarios:
Ejemplos:
vfs.dir.size[/tmp,log] #calcula el tamaño de todos los archivos en /tmp que contienen 'log' en sus nombres
vfs.dir.size[/tmp,log,^.+\.old$] #calcula el tamaño de todos los archivos en /tmp que contienen 'log' en sus nombres, excluyendo los archivos con nombres que terminan en '.old'
La suma de comprobación del archivo, calculada mediante el algoritmo cksum de UNIX.
Valor de retorno: Integer - con mode
como crc32, String - con mode
como md5, sha256.
Consulte plataformas compatibles.
Parámetros:
El límite de tamaño de archivo depende de compatibilidad con archivos grandes.
Ejemplo:
Ejemplo de valores devueltos (crc32/md5/sha256 respectivamente):
675436101
9845acf68b73991eb7fd7ee0ded23c44
ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc
Recuperando el contenido de un archivo7.
Valor de retorno: Texto.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
Ejemplo:
Comprueba si el archivo existe.
Valor de retorno: 0 - no encontrado; 1: existe un archivo del tipo especificado.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
Ejemplos:
vfs.file.exists[/tmp/application.pid]
vfs.file.exists[/tmp/application.pid,"archivo,dir,sym"]
vfs.file.exists[/tmp/application_dir,dir]
Devuelve información sobre un archivo.
Valor de retorno: objeto JSON.
Consulte plataformas compatibles.
Parámetro:
Comentarios:
Ejemplo:
vfs.file.get[/etc/passwd] #devuelve un JSON con información sobre el archivo /etc/passwd (tipo, usuario, permisos, SID, uid, etc.)
La suma de comprobación MD5 del archivo.
Valor de retorno: cadena de caracteres (hash MD5 del archivo).
Consulte plataformas compatibles.
Parámetro:
El límite de tamaño de archivo depende de compatibilidad con archivos grandes.
Ejemplo:
Ejemplo de valor devuelto:
Recupera el propietario de un archivo.
Valor de retorno: Cadena.
Consulte plataformas compatibles.
Parámetros:
El límite de tamaño de archivo depende de compatibilidad con archivos grandes.
Ejemplo:
vfs.file.owner[/tmp/zabbix_server.log] #devuelve el propietario del archivo de /tmp/zabbix_server.log
vfs.file.owner[/tmp/zabbix_server.log,,id] #devuelve el ID del propietario del archivo /tmp/zabbix_server.log
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:
El límite de tamaño de archivo depende de compatibilidad con archivos grandes.
Ejemplo:
Recuperar una cadena en el archivo7.
Valor de retorno: la línea que contiene la cadena coincidente, o según lo especificado por el parámetro opcional salida
.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
Ejemplos:
vfs.file.regexp[/etc/passwd,zabbix]
vfs.file.regexp[/ruta/a/algún/archivo,"([0-9]+)$",,3,5,\1]
vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] → obteniendo el ID del usuario *zabbix*
Busque una cadena en el archivo7.
Valores de retorno: 0 - coincidencia no encontrada; 1 - encontrado.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
Ejemplo:
El tamaño del archivo (en bytes).
Valor de retorno: Entero.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
Ejemplo:
La información de la hora del archivo.
Valor de retorno: Entero (marca de tiempo Unix).
Consulte plataformas compatibles.
Parámetros:
El límite de tamaño de archivo depende de compatibilidad con archivos grandes.
Ejemplo:
La lista de sistemas de archivos montados con su tipo y opciones de montaje. Se utiliza para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.
La lista de sistemas de archivos montados con su tipo, espacio disponible en disco, estadísticas de inodos y opciones de montaje. Se puede utilizar para descubrimiento de bajo nivel.
Valor de retorno: objeto JSON.
Plataformas compatibles: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.
Comentarios:
El número o porcentaje de inodos.
Valor de retorno: Entero - para número; Flotador - para porcentaje.
Consulte plataformas compatibles.
Parámetros:
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:
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:
Comentarios:
Ejemplo:
El tamaño de la memoria en bytes o en porcentaje del total.
Valor de retorno: Entero - para bytes; Flotador - para porcentaje.
Consulte plataformas compatibles.
Parámetro:
Comentarios:
Ejemplo:
Obtener el contenido de una página web.
Valor de retorno: fuente de la página web como texto (incluidos los encabezados).
Consulte plataformas compatibles.
Parámetros:
scheme://host:port/path
, donde solo host es obligatorio). Esquemas de URL permitidos: http, https4. Un esquema faltante será tratado como http. Si se especifica una URL, "ruta" y "puerto" deben estar vacíos. Especificar el nombre de usuario/contraseña al conectarse a servidores que requieren autenticación, por ejemplo: http://usuario:contraseñ[email protected]
solo es posible con soporte cURL 4 . Punycode se admite en los nombres de host.Comentarios:
host
puede ser un nombre de host, un nombre de dominio, una dirección IPv4 o IPv6. Pero para la dirección IPv6, el agente Zabbix debe compilarse con la compatibilidad con IPv6 habilitada.Ejemplo:
página.web.get[www.ejemplo.com,index.php,80]
página.web.get[https://www.ejemplo.com]
web.page.get[https://blog.example.com/?s=zabbix]
web.página.get[localhost:80]
web.page.get["[::1]/estado-del-servidor"]
El tiempo de carga de una página web completa (en segundos).
Valor de retorno: Flotador.
Consulte plataformas compatibles.
Parámetros:
scheme://host:port/path
, donde solo host es obligatorio). Esquemas de URL permitidos: http, https4. Un esquema faltante será tratado como http. Si se especifica una URL, "ruta" y "puerto" deben estar vacíos. Especificar el nombre de usuario/contraseña al conectarse a servidores que requieren autenticación, por ejemplo: http://usuario:contraseñ[email protected]
solo es posible con soporte cURL 4 . Punycode es compatible con los nombres de host.Comentarios:
host
puede ser un nombre de host, un nombre de dominio, una dirección IPv4 o IPv6. Pero para la dirección IPv6, el agente Zabbix debe compilarse con la compatibilidad con IPv6 habilitada.Ejemplo:
Busque una cadena en la página web.
Valor de retorno: la cadena coincidente, o según lo especificado por el parámetro opcional salida
.
Consulte plataformas compatibles.
Parámetros:
scheme://host:port/path
, donde solo host es obligatorio). Esquemas de URL permitidos: http, https4. Un esquema faltante será tratado como http. Si se especifica una URL, "ruta" y "puerto" deben estar vacíos. Especificar el nombre de usuario/contraseña al conectarse a servidores que requieren autenticación, por ejemplo: http://usuario:contraseñ[email protected]
solo es posible con soporte cURL 4 . Punycode es compatible con los nombres de host.Comentarios:
host
puede ser un nombre de host, un nombre de dominio, una dirección IPv4 o IPv6. Pero para la dirección IPv6, el agente Zabbix debe compilarse con la compatibilidad con IPv6 habilitada.Ejemplo:
página.web.regexp[www.ejemplo.com,index.php,80,OK,2]
página.web.regexp[https://www.ejemplo.com,,,OK,2]|
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.
El nombre de host del agente.
Valor de retorno: Cadena.
Consulte plataformas compatibles.
Devoluciones:
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.
La variante del agente Zabbix (agente Zabbix o agente Zabbix 2).
Valor de retorno: 1 - Agente Zabbix; 2 - Agente Zabbix 2.
Consulte plataformas compatibles.
La versión del agente Zabbix.
Valor de retorno: Cadena.
Consulte plataformas compatibles.
Ejemplo de valor devuelto:
Devuelve un conjunto de métricas internas del servidor Zabbix o del proxy de forma remota.
Valor de retorno: objeto JSON.
Consulte plataformas compatibles.
Parámetros:
Comentarios:
Devuelve la cantidad de elementos monitoreados en la cola que están retrasados en el servidor Zabbix o en el proxy de forma remota.
Valor de retorno: objeto JSON.
Consulte plataformas compatibles.
Parámetros:
Tenga en cuenta que la solicitud de estadísticas solo se aceptará desde las direcciones enumeradas en el parámetro 'StatsAllowedIP' servidor/proxy en la instancia de destino. .
Las claves de métricas que puede utilizar con el agente Zabbix se enumeran a continuación.
Las claves de las métricas se enumeran sin parámetros ni información adicional. Haga clic en la clave de la métrica para ver todos los detalles.
Clave de métrica | Descripción | Grupo de métricas |
---|---|---|
kernel.maxfiles | El número máximo de archivos abiertos admitidos por el sistema operativo. | Kernel |
kernel.maxproc | El número máximo de procesos admitidos por el sistema operativo. | |
kernel.openfiles | El número de descriptores de archivos abiertos actualmente. | |
log | El monitoreo de un archivo de registro. | Monitoreo de registro |
log.count | El recuento de líneas coincidentes en un archivo de registro monitoreado. | |
logrt | La supervisión de un archivo de registro que se rota. | |
logrt.count | El recuento de líneas coincidentes en un archivo de registro monitoreado que se rota. | |
modbus.get | Lee datos Modbus. | Modbus |
net.dns | Comprueba si el servicio DNS está activo. | Red |
net.dns.perf | Comprueba el rendimiento del servicio DNS. | |
net.dns.record | Realiza una consulta DNS. | |
net.if.collisions | El número de colisiones fuera de ventana. | |
net.if.discovery | La lista de interfaces de red. | |
net.if.in | Las estadísticas del tráfico entrante en una interfaz de red. | |
net.if.out | Las estadísticas de tráfico saliente en una interfaz de red. | |
net.if.total | La suma de las estadísticas de tráfico entrante y saliente en una interfaz de red. | |
net.tcp.listen | Comprueba si este puerto TCP está en estado LISTEN. | |
net.tcp.port | Comprueba si es posible realizar una conexión TCP al puerto especificado. | |
net.tcp.service | Comprueba si un servicio se está ejecutando y acepta conexiones TCP. | |
net.tcp.service.perf | Comprueba el rendimiento de un servicio TCP. | |
net.tcp.socket.count | Devuelve el número de sockets TCP que coinciden con los parámetros. | |
net.udp.listen | Comprueba si este puerto UDP está en estado LISTEN. | |
net.udp.service | Comprueba si un servicio se está ejecutando y respondiendo a solicitudes UDP. | |
net.udp.service.perf | Comprueba el rendimiento de un servicio UDP. | |
net.udp.socket.count | Devuelve el número de sockets UDP que coinciden con los parámetros. | |
proc.cpu.util | El porcentaje de utilización de CPU del proceso. | Procesos |
proc.get | La lista de procesos del sistema operativo y sus parámetros. | |
proc.mem | La memoria utilizada por el proceso en bytes. | |
proc.num | El número de procesos. | |
sensor | Lectura del sensor de hardware. | Sensores |
system.boottime | La hora de inicio del sistema. | Sistema |
system.cpu.discovery | La lista de CPU/núcleos de CPU detectados. | |
system.cpu.intr | El dispositivo se interrumpe. | |
system.cpu.load | La carga de la CPU. | |
system.cpu.num | El número de CPU. | |
system.cpu.switches | El recuento de cambios de contexto. | |
system.cpu.util | El porcentaje de utilización de la CPU. | |
system.hostname | El nombre del equipo del sistema. | |
system.hw.chassis | La información del chasis. | |
system.hw.cpu | La información de la CPU. | |
system.hw.devices | El listado de dispositivos PCI o USB. | |
system.hw.macaddr | La lista de direcciones MAC. | |
system.localtime | La hora del sistema. | |
system.run | Ejecute el comando especificado en el equipo. | |
system.stat | Las estadísticas del sistema. | |
system.sw.arch | La información de la arquitectura del software. | |
system.sw.os | La información del sistema operativo. | |
system.sw.os.get | Información detallada sobre el sistema operativo (versión, tipo, nombre de distribución, versión menor y mayor, etc.). | |
system.sw.packages | La lista de paquetes instalados. | |
system.sw.packages.get | Una lista detallada de los paquetes instalados. | |
system.swap.in | Las estadísticas de intercambio (del dispositivo a la memoria). | |
system.swap.out | Las estadísticas de intercambio (de la memoria al dispositivo). | |
system.swap.size | El tamaño del espacio de intercambio en bytes o en porcentaje del total. | |
system.uname | Identificación del sistema. | |
system.uptime | El tiempo de actividad del sistema en segundos. | |
system.users.num | El número de usuarios conectados. | |
vfs.dev.discovery | La lista de dispositivos de bloque y su tipo. | Sistemas de archivos virtuales |
vfs.dev.read | Las estadísticas de lectura del disco. | |
vfs.dev.write | Las estadísticas de escritura en disco. | |
vfs.dir.count | El recuento de entradas del directorio. | |
vfs.dir.get | La lista de entradas del directorio. | |
vfs.dir.size | El tamaño del directorio. | |
vfs.file.cksum | La suma de comprobación del archivo, calculada mediante el algoritmo cksum de UNIX. | |
vfs.file.contents | Recuperando el contenido de un archivo. | |
vfs.file.exists | Comprueba si el archivo existe. | |
vfs.file.get | Devuelve información sobre un archivo. | |
vfs.file.md5sum | La suma de comprobación MD5 del archivo. | |
vfs.file.owner | Recupera el propietario de un archivo. | |
vfs.file.permissions | Devuelve una cadena de 4 dígitos que contiene el número octal con permisos UNIX. | |
vfs.file.regexp | Recuperar una cadena en el archivo. | |
vfs.file.regmatch | Busca una cadena en el archivo. | |
vfs.file.size | El tamaño del archivo. | |
vfs.file.time | La información de hora del archivo. | |
vfs.fs.discovery | La lista de sistemas de archivos montados con su tipo y opciones de montaje. | |
vfs.fs.get | La lista de sistemas de archivos montados con su tipo, espacio disponible en disco, estadísticas de inodos y opciones de montaje. | |
vfs.fs.inode | El número o porcentaje de inodos. | |
vfs.fs.size | El espacio en disco en bytes o en porcentaje del total. | |
vm.memory.size | El tamaño de la memoria en bytes o en porcentaje del total. | Memoria virtual |
web.page.get | Obtener el contenido de una página web. | Monitoreo web |
web.page.perf | El tiempo de carga de una página web completa. | |
web.page.regexp | Buscar una cadena en la página web. | |
agent.hostmetadata | Los metadatos del host del agente. | Zabbix |
agent.hostname | El nombre de equipo del agente. | |
agent.ping | La verificación de disponibilidad del agente. | |
agent.variant | La variante del agente Zabbix (agente Zabbix o agente Zabbix 2). | |
agent.version | La versión del agente Zabbix. | |
zabbix.stats | Devuelve un conjunto de métricas internas del servidor Zabbix o del proxy de forma remota. | |
zabbix.stats | Devuelve el número de elementos monitoreados en la cola que están retrasados en el servidor Zabbix o en el proxy de forma remota. |
1Una nota específica de Linux. El agente de Zabbix debe tener acceso de solo lectura al sistema de archivos /proc. Los parches del kernel de www.grsecurity.org limitan los derechos de acceso de los usuarios no privilegiados.
2 vfs.dev.read[]
, vfs.dev.write[]
: el agente Zabbix terminará las conexiones de dispositivos "obsoletas" si no se accede a los valores de la métrica durante más de 3 horas. Esto puede suceder si un sistema tiene dispositivos con rutas cambiando dinámicamente o si un dispositivo se elimina manualmente. Tenga en cuenta también que estas métricas, si utilizan un intervalo de actualización de 3 horas o más, siempre se devolverán '0'.
3 vfs.dev.read[]
, vfs.dev.write[]
: si se usa all por defecto para el primer parámetro, la clave devolverá estadísticas resumidas, incluidos todos los dispositivos de bloque como sda, sdb y sus particiones (sda1, sda2, sdb3...) y múltiples dispositivos (MD raid) basados en esos bloques dispositivos/particiones y volúmenes lógicos (LVM) basados en esos bloques dispositivos/particiones. En tales casos, se deben considerar los valores devueltos. sólo como valor relativo (dinámico en el tiempo) pero no como valores absolutos.
4 SSL (HTTPS) solo se admite si el agente se compila con soporte cURL. De lo contrario, la métrica quedará sin soporte.
5 Los valores bytes
y errors
no se admiten para interfaces de bucle invertido en sistemas Solaris hasta Solaris 10 6/06 inclusive, ya que el sistema no almacena ni informa estadísticas de bytes, errores y utilización. núcleo. Sin embargo, si está monitoreando un sistema Solaris a través de net-snmp, es posible que se devuelvan valores ya que net-snmp contiene un código heredado de cmu-snmp con fecha de 1997 que, al no poder leer los valores de bytes de las estadísticas de la interfaz, devuelve el contador de paquetes (que existe en las interfaces loopback) multiplicado por un valor arbitrario de 308. Esto supone que la longitud promedio de un paquete es 308 octetos, lo cual es una estimación muy aproximada ya que el límite de MTU en los sistemas Solaris para interfaces loopback es 8892 bytes. No se debe suponer que estos valores sean correctos o incluso muy precisos. Son estimaciones aproximadas. El agente Zabbix no hace ninguna conjetura, pero net-snmp devolverá un valor para estos campos.
6 La línea de comando en Solaris, obtenida de /proc/pid/psinfo, está limitada a 80 bytes y contiene la línea de comando tal como estaba cuando se inició el proceso.
7 Las métricas vfs.file.contents[]
, vfs.file.regexp[]
, vfs.file.regmatch[]
se pueden utilizar para recuperar el contenido del archivo. Si desea restringir el acceso a archivos específicos con información confidencial, ejecute el agente Zabbix con un usuario que no tenga permisos de acceso para ver estos archivos.
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]
Para asegurarse de que los datos adquiridos no estén dañados, puede especificar la codificación correcta para procesar la comprobación (por ejemplo, 'vfs.file.contents') en el parámetro codificación
. La lista de codificaciones admitidas (identificadores de página de códigos) se pueden encontrar en la documentación para libiconv (Proyecto GNU) o en la Documentación del SDK de Microsoft Windows para "Identificadores de página de códigos".
Si no se especifica ninguna codificación en el parámetro "codificación", se aplican las siguientes estrategias de resolución:
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:
Timeout
en el [archivo de configuración] del agente (/manual/appendix/config/zabbix_agentd#timeout).