Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

2 Agente

Descripción general

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

El agente recopila información operativa localmente y reporta los datos al servidor Zabbix para su posterior procesamiento. En caso de fallos (como un disco duro lleno o un proceso de servicio caído), el servidor Zabbix puede alertar activamente a los administradores del equipo en particular que reportó el fallo.

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

Chequeos pasivos y activos

Los agentes de Zabbix pueden realizar chequeos pasivos y activos:

  • Chequeos pasivos: el agente de Zabbix responde a una solicitud del servidor Zabbix (o proxy). Por ejemplo, el servidor solicita datos (por ejemplo, carga de CPU) y el agente devuelve el resultado.
  • Chequeos activos: el agente de Zabbix recopila y envía datos sin esperar una solicitud del servidor Zabbix (o proxy). Primero, obtiene una lista de métricas de monitorización del servidor (carga de CPU, memoria disponible, etc.), luego recopila los datos requeridos y periódicamente envía los nuevos valores de vuelta.

El tipo de chequeo del agente se configura seleccionando el tipo de métrica de monitorización correspondiente. El agente de Zabbix procesa métricas de tipo "Agente Zabbix" o "Agente Zabbix (activo)".

Plataformas compatibles

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

Agente en sistemas tipo UNIX

El agente de Zabbix en sistemas tipo UNIX se ejecuta en el equipo que se está monitorizando.

Instalación

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

  • Paquetes de Zabbix: seleccione el componente Agente (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 agente de Zabbix configurando las fuentes con la opción --enable-agent.

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

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

Si se instala como paquete

El agente Zabbix se ejecuta como un proceso demonio. El agente 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 agente Zabbix, utilice los siguientes comandos:

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

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

zabbix_agentd

Agente en sistemas Windows

El agente de Zabbix en Windows se ejecuta como un servicio de Windows.

Instalación

El agente Zabbix puede instalarse en Windows utilizando uno de los siguientes métodos:

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

Opciones

Es posible ejecutar múltiples instancias del agente en un equipo. Una sola instancia puede usar el archivo de configuración por defecto o un archivo de configuración especificado en la línea de comandos. En caso de múltiples instancias, cada instancia del agente debe tener su propio archivo de configuración (una de las instancias puede usar el archivo de configuración por defecto).

Los siguientes parámetros de línea de comandos pueden usarse con el agente de Zabbix:

Parámetro Descripción
Agente UNIX y Windows
-c --config <archivo-config> Ruta al archivo de configuración.
Puede usar esta opción para especificar un archivo de configuración que no sea el predeterminado.
En UNIX, el valor por defecto es /usr/local/etc/zabbix_agentd.conf o como se establezca mediante las variables de tiempo de compilación --sysconfdir o --prefix
En Windows, el valor por defecto es C:\Program Files\Zabbix Agent\zabbix_agentd.conf
-f --foreground Ejecutar el agente de Zabbix en primer plano (por defecto: true).
-p --print Imprimir las métricas conocidas y salir.
Nota: Para devolver también los resultados de parámetros de usuario, debe especificar el archivo de configuración (si no está en la ubicación por defecto).
-t --test <clave-métrica> Probar la métrica especificada y salir.
Nota: Para devolver también los resultados de parámetros de usuario, debe especificar el archivo de configuración (si no está en la ubicación por defecto).
-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 agente UNIX
-R --runtime-control <opción> Realizar funciones administrativas. Ver control en tiempo de ejecución.
Solo agente Windows
-m --multiple-agents Usar múltiples instancias del agente (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 <valor> Establecer el tipo de inicio del servicio del agente de Zabbix para Windows. Valores permitidos:
automatic - (por defecto) iniciar el servicio automáticamente al arrancar 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 aplicación);
disabled - deshabilitar el servicio, de modo que no pueda ser iniciado por un usuario o aplicación.
Puede usar 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 el agente de Zabbix para Windows como servicio.
-d --uninstall Desinstalar el servicio del agente de Zabbix para Windows.
-s --start Iniciar el servicio del agente de Zabbix para Windows.
-x --stop Detener el servicio del agente de Zabbix para Windows.

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

  • imprimir todas las métricas integradas del agente con valores
  • probar un parámetro de usuario con la clave "mysql.ping" definida en el archivo de configuración especificado
  • instalar un servicio "Zabbix Agent" para Windows usando la ruta por defecto al archivo de configuración C:\Program Files\Zabbix Agent\zabbix_agentd.conf
  • instalar un servicio "Zabbix Agent [Hostname]" para Windows usando el archivo de configuración zabbix_agentd.conf ubicado en la misma carpeta que el ejecutable del agente y haciendo que el nombre del servicio sea único extendiéndolo con el valor de Hostname del archivo de configuración
  • modificar el tipo de inicio de un servicio "Zabbix Agent" ya instalado para Windows usando el archivo de configuración zabbix_agentd.conf ubicado en la misma carpeta que el ejecutable del agente
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 agente.

Opción Descripción Destino
log_level_increase[=<destino>] Aumenta el nivel de registro.
Si no se especifica el destino, se ven afectados todos los procesos.
El destino puede especificarse como:
tipo de proceso - todos los procesos del tipo especificado (por ejemplo, listener)
Consulte todos los tipos de procesos del agente.
tipo de proceso,N - tipo de proceso y número (por ejemplo, listener,3)
pid - identificador de proceso (1 a 65535). Para valores mayores, especifique el destino como 'tipo-de-proceso,N'.
log_level_decrease[=<destino>] Disminuye el nivel de registro.
Si no se especifica el destino, se ven afectados todos los procesos.
userparameter_reload Recarga los valores de las opciones UserParameter e Include desde el 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
  • disminuir el nivel de registro de todos los procesos de comprobaciones activas
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 agente

  • active checks - proceso para realizar comprobaciones activas
  • collector - proceso para la recopilación de datos
  • listener - proceso para escuchar comprobaciones pasivas

El archivo de registro del agente se puede utilizar para observar estos tipos de procesos.

Usuario del proceso

El agente Zabbix en UNIX está diseñado para ejecutarse como un usuario sin privilegios de root. Se ejecutará como cualquier usuario sin privilegios de root con el que se inicie. Por lo tanto, puede ejecutar el agente como cualquier usuario sin privilegios de root sin ningún problema.

Si intenta ejecutarlo como 'root', cambiará a un usuario 'zabbix' predefinido, que debe estar presente en su sistema. Solo puede ejecutar el agente como 'root' si modifica el parámetro 'AllowRoot' en el archivo de configuración del agente en consecuencia.

Archivo de configuración

Para obtener detalles sobre la configuración del agente Zabbix, consulte las opciones del archivo de configuración para zabbix_agentd o agente de Windows.

Configuración regional

Tenga en cuenta que el agente requiere una configuración regional UTF-8 para que algunas métricas textuales del agente puedan devolver el contenido esperado. La mayoría de los sistemas modernos tipo Unix tienen una configuración regional UTF-8 por defecto, sin embargo, hay algunos sistemas donde esto puede necesitar ser configurado específicamente.

Código de salida

El agente Zabbix devuelve 0 en caso de salida exitosa y 1 en caso de fallo.