agent

Resumen

Zabbix agent se despliega en un objetivo de monitorización para supervisar de forma activa los recursos y aplicaciones locales (discos duros, memoria, estadísticas del procesador, etc.).

El agent recopila información operativa localmente e informa los datos a Zabbix server para su procesamiento posterior. En caso de fallos (como un disco duro lleno o un proceso de servicio bloqueado), Zabbix server puede alertar de forma activa a los administradores de la máquina concreta que informó del fallo.

Los Zabbix agents son muy eficientes debido al uso de llamadas nativas del sistema para recopilar información estadística.

Es posible ejecutar varias instancias del agent en un host.

Véase también:

Comprobaciones pasivas y activas

Los agentes de Zabbix pueden realizar comprobaciones pasivas y activas:

  • Comprobaciones pasivas - El agent de Zabbix responde a una solicitud de Zabbix server (o proxy). Por ejemplo, el server solicita datos (p. ej., carga de CPU), y el agent devuelve el resultado.
  • Comprobaciones activas - El agent de Zabbix recopila y envía datos sin esperar una solicitud de Zabbix server (o proxy). Primero, obtiene una lista de items de monitoreo del server (carga de CPU, memoria disponible, etc.), luego recopila los datos requeridos y envía periódicamente nuevos valores de vuelta a este.

El tipo de comprobación del agent se configura seleccionando el correspondiente tipo de item de monitoreo. El agent de Zabbix procesa items de tipo Zabbix agent o Zabbix agent (active).

Plataformas compatibles

Para las plataformas compatibles, consulte la página Requisitos.

Agent en sistemas tipo Unix

Zabbix agent en sistemas tipo Unix se ejecuta en el host que se está supervisando.

Instalación

El agent de Zabbix puede instalarse en sistemas basados en Linux utilizando uno de los siguientes métodos:

  • Paquetes de Zabbix: seleccione el componente Agent (después de seleccionar su versión de Zabbix, distribución del SO y versión del SO) y siga las instrucciones proporcionadas.
  • Fuentes de Zabbix: descargue los archivos fuente y compile el agent de Zabbix configurando las fuentes con la opción --enable-agent.

En general, los agents de Zabbix de 32 bits funcionarán en sistemas de 64 bits, pero pueden fallar en algunos casos.

Los binarios precompilados del agent de Zabbix están disponibles para descarga para macOS, IBM AIX, FreeBSD, OpenBSD y Solaris. Los binarios heredados, compatibles con la versión actual de Zabbix server/proxy, están disponibles para NetBSD y HP-UX.

Si se instala como paquete

El agent de Zabbix se ejecuta como un proceso demonio. El agent puede iniciarse ejecutando:

systemctl start zabbix-agent

Esto funcionará en la mayoría de los sistemas GNU/Linux. En otros sistemas puede que necesite ejecutar:

/etc/init.d/zabbix-agent start

Para detener, reiniciar o comprobar el estado del agent de Zabbix, utilice los siguientes comandos:

systemctl stop zabbix-agent
systemctl restart zabbix-agent
systemctl status zabbix-agent
Iniciar manualmente

Puede iniciar el agent de Zabbix localizando el binario zabbix_agentd y ejecutándolo directamente; por ejemplo:

zabbix_agentd

Agent en sistemas Windows

Zabbix agent en Windows se ejecuta como un servicio de Windows.

Instalación

Zabbix agent se puede instalar en Windows mediante uno de los siguientes métodos:

Consulte la página Zabbix agent en Microsoft Windows para obtener detalles adicionales sobre la instalación de Zabbix agent (desde un archivo ZIP) como servicio de Windows.

Opciones

Los siguientes parámetros de línea de comandos se pueden utilizar con Zabbix agent:

Parámetro Descripción
agent UNIX y Windows
-c --config <config-file> Ruta al archivo de configuración.
Puede utilizar esta opción para especificar un archivo de configuración que no sea el predeterminado.
-f --foreground Ejecutar Zabbix agent en primer plano (valor predeterminado: true).
-p --print Mostrar los items conocidos y salir.
Tenga en cuenta que, para devolver también los resultados de los parámetros de usuario, debe especificar el archivo de configuración (si no se encuentra en la ubicación predeterminada).
-t --test <item key> Probar el item especificado y salir.
Tenga en cuenta que, para devolver también los resultados de los parámetros de usuario, debe especificar el archivo de configuración (si no se encuentra en la ubicación predeterminada).
-T --test-config Validar el archivo de configuración y salir.
-h --help Mostrar información de ayuda.
-V --version Mostrar el número de versión.
Solo agent UNIX
-R --runtime-control <option> Realizar funciones administrativas. Consulte control en tiempo de ejecución.
Solo agent Windows
-m --multiple-agents Utilizar varias instancias del agent (con las opciones -i, -d, -s, -x).
Para distinguir los nombres de servicio de las instancias, cada nombre de servicio incluirá el valor de Hostname del archivo de configuración especificado.
-S --startup-type <value> Establecer el tipo de inicio del servicio de Zabbix Windows agent. Valores permitidos:
automatic - (predeterminado) iniciar el servicio automáticamente al iniciar Windows;
delayed - retrasar el inicio del servicio hasta que los servicios iniciados automáticamente hayan completado su inicio (disponible en Windows Server 2008/Vista y versiones posteriores);
manual - iniciar el servicio manualmente (por un usuario o una aplicación);
disabled - deshabilitar el servicio para que no pueda ser iniciado por un usuario o una aplicación.
Puede utilizar esta opción junto con la opción -i o por separado para modificar el tipo de inicio de un servicio ya instalado.
-i --install Instalar Zabbix Windows agent como servicio.
-d --uninstall Desinstalar el servicio de Zabbix Windows agent.
-s --start Iniciar el servicio de Zabbix Windows agent.
-x --stop Detener el servicio de Zabbix Windows agent.

Ejemplos específicos del uso de parámetros de línea de comandos:

  • Mostrar todos los items integrados del agent con sus valores.
  • Probar un parámetro de usuario con la clave mysql.ping definida en el archivo de configuración especificado.
  • Instalar un servicio de Zabbix Agent para Windows utilizando la ruta predeterminada al archivo de configuración.
  • Instalar un servicio de Zabbix Agent [Hostname] para Windows utilizando el archivo de configuración ubicado en la misma carpeta que el ejecutable del agent y hacer que el nombre del servicio sea único ampliándolo con el valor de Hostname del archivo de configuración.
  • Modificar el tipo de inicio de un servicio de Zabbix Agent para Windows instalado utilizando el archivo de configuración ubicado en la misma carpeta que el ejecutable del agent.
zabbix_agentd --print
zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agentd.exe -i
zabbix_agentd.exe -i -m -c zabbix_agentd.conf
zabbix_agentd.exe -c zabbix_agentd.conf -S delayed
Control en tiempo de ejecución

Con las opciones de control en tiempo de ejecución puede cambiar el nivel de registro de los procesos del agent.

Opción Descripción Destino
log_level_increase[=<target>] Aumenta el nivel de registro.
Si no se especifica el destino, todos los procesos se ven afectados.		 El destino se puede especificar como:
tipo de proceso: todos los procesos del tipo especificado (por ejemplo, listener)
Consulte todos los tipos de procesos del agent.
tipo de proceso,N: tipo y número de proceso (por ejemplo, listener,3)
pid: identificador del proceso (1 a 65535). Para valores mayores, especifique el destino como «tipo de proceso,N».
log_level_decrease[=<target>] Reduce el nivel de registro.
Si no se especifica el destino, todos los procesos se ven afectados.
userparameter_reload Vuelve a cargar los valores de las opciones UserParameter e Include del archivo de configuración actual.

Ejemplos:

  • Aumentar el nivel de registro de todos los procesos
  • Aumentar el nivel de registro del tercer proceso listener
  • Aumentar el nivel de registro del proceso con PID 1234
  • Reducir el nivel de registro de todos los procesos de comprobación activa
zabbix_agentd -R log_level_increase
zabbix_agentd -R log_level_increase=listener,3
zabbix_agentd -R log_level_increase=1234
zabbix_agentd -R log_level_decrease="active checks"

El control en tiempo de ejecución no es compatible con OpenBSD, NetBSD ni Windows.

Tipos de procesos del agent

Los tipos de procesos del agent son los siguientes:

  • active checks - proceso para realizar active checks;
  • collector - proceso para la recopilación de datos;
  • listener - proceso para escuchar passive checks.

El archivo de registro del agent puede utilizarse para observar estos tipos de procesos.

El archivo de registro del agent se crea con permisos de lectura y escritura solo para el propietario del archivo. Además, el archivo es legible por el grupo propietario. Todos los demás permisos están denegados.

Ejecutar como usuario

Zabbix agent en UNIX está diseñado para ejecutarse como un usuario que no sea root. Se ejecutará con el usuario que no sea root con el que se inicie. Por lo tanto, puede ejecutar el agent con cualquier usuario que no sea root sin problemas.

Si intenta ejecutarlo como «root», cambiará al usuario «zabbix» codificado de forma fija, que debe estar presente en su sistema. Solo puede ejecutar el agent como «root» si modifica adecuadamente el parámetro AllowRoot en el archivo de configuración del agent.

Archivo de configuración

La ruta predeterminada al archivo de configuración depende del sistema operativo y del método de instalación de Zabbix:

  • En UNIX, la ruta predeterminada es:
    • Para la instalación desde las fuentes: /usr/local/etc/zabbix_agentd.conf, o la establecida mediante las variables de compilación --sysconfdir o --prefix.
    • Para la instalación desde paquetes y el appliance: /etc/zabbix/zabbix_agentd.conf.
  • En Windows, la ruta predeterminada es C:\Program Files\Zabbix Agent\zabbix_agentd.conf.

Si se está ejecutando una única instancia del agent en un host, puede utilizar el archivo de configuración predeterminado o un archivo de configuración especificado en la línea de comandos. En caso de varias instancias, cada instancia del agent debe tener su propio archivo de configuración (una de las instancias puede utilizar el archivo de configuración predeterminado).

Para obtener más información sobre la configuración del agent de Zabbix, consulte las opciones del archivo de configuración del agent de Zabbix para Unix o del agent de Zabbix para Windows.

Configuración regional

Tenga en cuenta que el agent requiere una configuración regional UTF-8 para que algunos items textuales del agent puedan devolver el contenido esperado. La mayoría de los sistemas Unix modernos tienen una configuración regional UTF-8 como predeterminada; sin embargo, hay algunos sistemas en los que puede ser necesario configurarla específicamente.

Código de salida

Zabbix agent devuelve 0 en caso de salida correcta y 1 en caso de fallo.