2 Agente
Descripción general
El agent de Zabbix se despliega en un objetivo de monitorización para monitorizar activamente los recursos y aplicaciones locales (discos duros, memoria, estadísticas del procesador, etc.).
El agent recopila información operativa localmente y reporta los datos al server de Zabbix para su posterior procesamiento. En caso de fallos (como un disco duro lleno o un proceso de servicio caído), el server de Zabbix puede alertar activamente a los administradores de la máquina que reportó el fallo.
Los agents de Zabbix son altamente eficientes debido al uso de llamadas nativas del sistema para recopilar información estadística.
Comprobaciones pasivas y activas
Los agentes de Zabbix pueden realizar comprobaciones pasivas y activas:
- Comprobaciones pasivas - El agent de Zabbix responde a una solicitud del server de Zabbix (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 del server de Zabbix (o proxy). Primero, obtiene del server una lista de items de monitorización (carga de CPU, memoria disponible, etc.); luego recopila los datos requeridos y le envía periódicamente los nuevos valores.
El tipo de comprobación del agent se configura seleccionando el tipo de item de monitorización correspondiente. El agent de Zabbix procesa items del tipo "Zabbix agent" o "Zabbix agent (active)".
Plataformas compatibles
Para conocer las plataformas compatibles, consulte la página de Requisitos.
Agente en sistemas tipo UNIX
El agente Zabbix en sistemas similares a UNIX se ejecuta en el equipo que se está monitoreando.
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 sistema operativo y versión del sistema operativo) 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 descargar para macOS, IBM AIX, FreeBSD, OpenBSD y Solaris. Los binarios heredados, compatibles con la versión actual del server/proxy de Zabbix, 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-agentEsto funcionará en la mayoría de los sistemas GNU/Linux. En otros sistemas puede que necesite ejecutar:
/etc/init.d/zabbix-agent startPara 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-agentIniciar manualmente
Puede iniciar el agent de Zabbix localizando el binario zabbix_agentd y ejecutándolo directamente; por ejemplo:
zabbix_agentdAgente en sistemas Windows
El agente de Zabbix en Windows se ejecuta como un servicio de Windows.
Instalación
El agent de Zabbix puede instalarse en Windows utilizando uno de los siguientes métodos:
- Binarios precompilados de Zabbix agent - descargue el paquete instalador MSI de Zabbix agent y siga las instrucciones de la página Instalación de Windows agent desde MSI.
- Fuentes de Zabbix - descargue los archivos fuente y siga las instrucciones de la página Compilación de Zabbix agent en Windows.
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 un servicio de Windows.
Opciones
Es posible ejecutar múltiples instancias del agent en un host. Una sola instancia puede usar el archivo de configuración predeterminado o un archivo de configuración especificado en la línea de comandos. En caso de múltiples instancias, cada instancia del agent debe tener su propio archivo de configuración (una de las instancias puede usar el archivo de configuración predeterminado).
Los siguientes parámetros de línea de comandos pueden utilizarse con Zabbix agent:
| Parameter | Description |
|---|---|
| agent de UNIX y Windows | |
| -c --config <config-file> | Ruta al archivo de configuración. Puede usar esta opción para especificar un archivo de configuración distinto del predeterminado. En UNIX, el valor predeterminado es /usr/local/etc/zabbix_agentd.conf o el establecido por las variables de tiempo de compilación --sysconfdir o --prefix En Windows, el valor predeterminado es C:\Program Files\Zabbix Agent\zabbix_agentd.conf |
| -f --foreground | Ejecutar Zabbix agent en primer plano (predeterminado: true). |
| -p --print | Imprimir los items conocidos 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 predeterminada). |
| -t --test <item key> | Probar el item especificado 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 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 de UNIX | |
| -R --runtime-control <option> | Realizar funciones administrativas. Consulte control en tiempo de ejecución. |
| Solo agent de Windows | |
| -m --multiple-agents | Usar múltiples 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 Zabbix Windows agent. Valores permitidos:automatic - iniciar el servicio automáticamente al arrancar Windows (predeterminado);delayed - retrasar el inicio del servicio hasta que los servicios iniciados automáticamente hayan completado el arranque (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, de modo que no pueda ser iniciado por un usuario o una 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 Zabbix Windows agent como servicio. |
| -d --uninstall | Desinstalar el servicio Zabbix Windows agent. |
| -s --start | Iniciar el servicio Zabbix Windows agent. |
| -x --stop | Detener el servicio Zabbix Windows agent. |
Ejemplos específicos de uso de parámetros de línea de comandos:
- imprimir todos los items integrados del agent 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 predeterminada 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 agent y haciendo que el nombre del servicio sea único al ampliarlo con el valor Hostname del archivo de configuración
- modificar el tipo de inicio de un servicio "Zabbix Agent" instalado para Windows usando el archivo de configuración zabbix_agentd.conf 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 delayedControl de ejecución
Con las opciones de control 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 verán afectados. |
El destino puede especificarse como: tipo de proceso - todos los procesos del tipo especificado (p. ej., listener) Vea todos los tipos de proceso del agent. tipo de proceso,N - tipo y número de proceso (p. ej., listener,3) pid - identificador del proceso (1 a 65535). Para valores mayores, especifique el destino como 'process-type,N'. |
| log_level_decrease[=<target>] | Disminuye el nivel de registro. Si no se especifica el destino, todos los procesos se verán afectados. |
|
| 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 de ejecución no es compatible con OpenBSD, NetBSD ni Windows.
Tipos de procesos del agent
active checks- proceso para realizar comprobaciones activascollector- proceso para la recopilación de datoslistener- proceso para escuchar comprobaciones pasivas
El archivo de registro del agent puede utilizarse para observar estos tipos de procesos.
Desde Zabbix 7.4.6, el archivo de registro del agent se crea con permisos de lectura y escritura sólo para el propietario del archivo. Además, el archivo es legible por el grupo propietario. Se deniegan todos los demás permisos.
Usuario del proceso
El agent de Zabbix en UNIX está diseñado para ejecutarse como un usuario que no sea root. Se ejecutará como cualquier usuario que no sea root con el que se inicie. Por lo tanto, puede ejecutar el agent como cualquier usuario que no sea 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 agent como 'root' si modifica el parámetro 'AllowRoot' en el archivo de configuración del agent en consecuencia.
Archivo de configuración
Para obtener detalles sobre la configuración del agent de Zabbix, consulte las opciones del archivo de configuración para zabbix_agentd o agent de Windows.
Configuración regional
Tenga en cuenta que el agent requiere una configuración regional UTF-8 para que algunos items de texto del agent puedan devolver el contenido esperado. La mayoría de los sistemas modernos similares a Unix tienen una configuración regional UTF-8 por defecto, sin embargo, hay algunos sistemas donde puede ser necesario configurarla específicamente.
Código de salida
El agente Zabbix devuelve 0 en caso de salida exitosa y 1 en caso de fallo.