Documentation
Table of Contents
2 Agente
Descripción general
El agente Zabbix se implementa en un objetivo de monitoreo para monitorear activamente recursos y aplicaciones locales (estadísticas de discos duros, memoria, procesador, etcétera).
El agente recopila información operativa localmente y reporta datos al servidor Zabbix para su posterior procesamiento. En caso de fallas (como un disco duro que se está llenando o un proceso de servicio colapsado), el servidor Zabbix puede alertar activamente a los administradores de la máquina en particular que informó el fallo.
Los agentes Zabbix son altamente eficientes debido al uso de llamadas nativas del sistema para la recopilación de información estadística.
Comprobaciones pasivas y activas
Los agentes de Zabbix pueden realizar comprobaciones pasivas y activas:
- Comprobaciones pasivas: 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.
- Comprobaciones activas: el agente de Zabbix recopila y envía datos sin esperar una solicitud del servidor Zabbix (o proxy). Primero, obtiene una lista de elementos de monitoreo del servidor (carga de CPU, memoria disponible, etc.), luego recopila los datos requeridos y periódicamente envía los nuevos valores de vuelta al servidor.
El tipo de comprobación del agente se configura seleccionando el tipo de elemento de monitoreo correspondiente. El agente de Zabbix procesa elementos 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 Zabbix en sistemas similares a UNIX se ejecuta en el equipo que se está monitoreando.
Instalación
El agente Zabbix se puede instalar 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 Zabbix configurando las fuentes con la opción
--enable-agent.
En general, los agentes Zabbix de 32 bits funcionarán en sistemas de 64 bits, pero pueden fallar en algunos casos.
Los binarios precompilados del agente Zabbix están disponibles para descargar para macOS, IBM AIX, FreeBSD, OpenBSD y Solaris. Los binarios heredados, compatibles con la versión actual del servidor/proxy 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:
Esto funcionará en la mayoría de los sistemas GNU/Linux. En otros sistemas puede que necesite ejecutar:
Para detener, reiniciar o comprobar el estado del agente Zabbix, utilice los siguientes comandos:
Iniciar manualmente
Puede iniciar el agente Zabbix localizando el binario zabbix_agentd y ejecutándolo directamente; por ejemplo:
Agente en sistemas Windows
El agente de Zabbix en Windows se ejecuta como un servicio de Windows.
Instalación
El agente de Zabbix se puede instalar en Windows utilizando uno de los siguientes métodos:
- Binarios precompilados del agente de Zabbix: descargue el paquete instalador MSI del agente de Zabbix y siga las instrucciones en la página Instalación del agente de Windows desde MSI.
- Fuentes de Zabbix: descargue los archivos fuente y siga las instrucciones en la página Compilación del agente de Zabbix en Windows.
Consulte la página Agente de Zabbix en Microsoft Windows para obtener detalles adicionales sobre la instalación del agente de Zabbix (desde un archivo ZIP) como un servicio de Windows.
Opciones
Es posible ejecutar varias instancias del agente en un equipo. Una instancia puede usar el archivo de configuración predeterminado o un archivo de configuración especificado en la línea de comando. En caso de múltiples instancias cada instancia de agente 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 comando se pueden usar con el agente Zabbix:
| Parámetro | Descripción |
|---|---|
| Agente UNIX y Windows | |
| -c --config <archivo de configuración> | 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 predeterminado es /usr/local /etc/zabbix_agentd.conf o según lo establecido por las variables compile-time , --sysconfdir o --prefix En Windows, el valor predeterminado es C:\Program Files\Zabbix Agent\zabbix_agentd.conf |
| -f --foreground | Ejecutar el agente Zabbix en primer plano (por defecto: true). |
| -p --print | Imprimir métricas conocidas y salir. Nota: Para devolver también los resultados de los parámetro de usuario, debe especificar el archivo de configuración (si no está en la ubicación predeterminada). |
| -t --test <clave métrica> | Prueba la métrica especificada y sale. Nota: Para devolver también los resultados de parámetro de usuario, debe especificar el archivo de configuración (si no está en la ubicación predeterminada). |
| -h --help | Mostrar información de ayuda |
| -V --version | Mostrar número de versión |
| Solo agente UNIX | |
| -R --runtime-control <opción> | Realizar funciones administrativas. Consulte control en tiempo de ejecución. |
| Solo agente Windows | |
| -m --multiple-agents | Utilice varias instancias de agente (con funciones -i,-d,-s,-x). Para distinguir los nombres de servicio de las instancias, cada nombre de servicio incluirá el valor de nombre de equipo especificado en el archivo de configuración. |
| -S --startup-type <valor> | Configura el tipo de inicio del servicio del agente Zabbix para Windows. Valores permitidos:automatic - (por defecto) inicia el servicio automáticamente cuando se inicia Windows;delayed - Retrasa el inicio del servicio despues de que los servicios con inicio automático hayan completado su inicio (disponible en Windows Server 2008/Vista y versiones posteriores);manual - inicio del servicio manual (por un usuario o aplicación);disabled - deshabilita el servicio, de forma que no puede ser iniciado por un usuario ni por una aplicación.Puede usar esta opción junto con la opción -i, o de forma separada para modificar el tipo de inicio de un servicio ya instalado. |
| -i --install | Instala el agente de Windows de Zabbix como servicio |
| -d --uninstall | Desinstalar el servicio de agente de Windows de Zabbix |
| -s --start | Iniciar el servicio de agente de Windows de Zabbix |
| -x --stop | Detener el servicio de agente de Zabbix Windows |
Ejemplos específicos del uso de parámetros de línea de comandos:
- imprimir todas las métricas de agente integradas 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 agente ejecutable y hacer que el nombre del servicio sea único extendiéndolo con el valor de Hostname en el archivo de configuración
- modificar el tipo de inicio de un servicio instalado de "Agente Zabbix" 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 delayedControl 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 | Objetivo |
|---|---|---|
| log_level_increase[=<destino>] | Aumentar el nivel de registro. Si no se especifica el objetivo, todos los procesos se ven afectados. |
El objetivo se puede especificar como: tipo de proceso - todos los procesos del tipo especificado (por ejemplo, listener) Ver todos los tipos de procesos del agente. tipo de proceso,N - tipo y número de proceso (por ejemplo, listener,3)<br >pid - identificador de proceso (1 a 65535). Para valores mayores, especifique el destino como 'tipo de proceso,N'. |
| log_level_decrease[=<target>] | Disminuye el nivel de registro. Si no se especifica el objetivo, todos los procesos se ven afectados. |
|
| userparameter_reload | Recargar 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 proceso del tercer listener
- aumentar del nivel de registro del proceso con PID 1234
- disminuir del nivel de registro de todos los procesos de verificación activos.
zabbix_agentd -R log_level_increase
zabbix_agentd -R log_level_increase=listener,3
zabbix_agentd -R log_level_increase=1234
shezabbix_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 de agentes
controles activos- proceso para realizar controles activoscollector- proceso para la recopilación de datoslistener- proceso para escuchar cheques pasivos
El archivo de registro del agente se puede utilizar para observar estos tipos de procesos.
Procesos de usuario
El agente Zabbix en UNIX está diseñado para ejecutarse como usuario no root. se ejecutará como cualquier usuario no root con el que se inicie. Para que pueda ejecutar el agente como cualquier usuario no root sin ningún problema.
Si intenta ejecutarlo como 'root', cambiará a un codificado usuario 'zabbix', que debe estar presente en su sistema. solo puedes correr agente como 'root' si modifica el parámetro 'AllowRoot' en el archivo de configuración del agente .
Archivo de configuración
Para obtener detalles sobre la configuración del agente Zabbix, consulte las opciones del archivo de configuración zabbix_agentd o Agente de Windows.
Configuración regional
Tenga en cuenta que el agente requiere una configuración regional UTF-8 para que algún agente textual los elementos pueden devolver el contenido esperado. La mayoría de los sistemas similares a Unix modernos tener una configuración regional UTF-8 por defecto, sin embargo, hay algunos sistemas donde puede ser necesario establecer específicamente.
Código de salida
El agente Zabbix devuelve 0 en caso de salida exitosa y 1 en caso de fallo.