Documentation
Table of Contents
3 Agente 2
Descripción general
Zabbix agent 2 es una nueva generación de agente Zabbix, escrito en Go (con algo de código C reutilizado del agente Zabbix). Está diseñado para:
- Reducir el número de conexiones TCP.
- Proporcionar una mejor concurrencia de comprobaciones.
- Ser fácilmente ampliable con plugins, que proporcionan comprobaciones simples con un código mínimo y admiten comprobaciones complejas que consisten en scripts de larga duración y recopilación de datos independiente con informes periódicos.
- Funcionar como un reemplazo del agente Zabbix, admitiendo todas las funciones anteriores.
Comprobaciones pasivas y activas
El agente Zabbix 2 admite comprobaciones pasivas y activas, de manera similar al agente Zabbix. Además, las comprobaciones activas del agente Zabbix 2 admiten intervalos flexibles/programados y concurrencia de comprobaciones dentro de un mismo servidor activo.
Por defecto, después de un reinicio, el agente Zabbix 2 programará la primera recopilación de datos para comprobaciones activas en un momento condicionalmente aleatorio dentro del intervalo de actualización del elemento para evitar picos en el uso de recursos. Para realizar comprobaciones activas que no tengan Intervalo de actualización programado inmediatamente después del reinicio del agente, establezca el parámetro ForceActiveChecksOnStart (a nivel global) o Plugins.<Plugin name>.System.ForceActiveChecksOnStart (afecta solo a comprobaciones de un plugin específico) en el archivo de configuración. El parámetro a nivel de plugin, si se establece, anulará el parámetro global.
Verificar simultaneidad
Se pueden ejecutar comprobaciones de diferentes complementos al mismo tiempo. El número de comprobaciones simultáneas dentro de un complemento está limitada por la configuración de capacidad del complemento. Cada complemento puede tener una configuración de capacidad codificada (siendo 1000 el valor predeterminado) que se puede reducir usando la configuración Plugins.<PluginName>.System.Capacity=N en el parámetro de configuración de Plugins.
Plataformas compatibles
Para conocer las plataformas compatibles, consulte la página de Requisitos.
Agente 2 en sistemas tipo UNIX
El agente 2 de Zabbix en sistemas tipo UNIX se ejecuta en el equipo que se está monitorizando.
Instalación
El agente Zabbix 2 puede instalarse en sistemas basados en Linux utilizando uno de los siguientes métodos:
- Paquetes de Zabbix: seleccione el componente Agente 2 (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-agent2. Tenga en cuenta que se requiere un entorno Go configurado con una versión de Go actualmente soportada para compilar el agente Zabbix 2.
Desde Zabbix 7.0.5, los paquetes del agente Zabbix 2 ya no están disponibles para RHEL 6 debido a que Go 1.22 (y versiones más recientes) no son compatibles con GCC 4.4.7 proporcionado por RHEL 6, lo que resulta en errores de compilación. Sin embargo, tenga en cuenta que los paquetes del agente Zabbix aún son compatibles.
Si se instala como paquete
El agente Zabbix 2 se ejecuta como un proceso en primer plano y depende de un gestor de servicios externo (por ejemplo, systemd) para la ejecución en segundo plano; El agente Zabbix 2 no tiene soporte de demonización incorporado en Linux.
El agente puede iniciarse ejecutando:
Para detener, reiniciar o comprobar el estado del agente Zabbix 2, utilice los siguientes comandos:
Iniciar manualmente
Puede iniciar el agente Zabbix localizando el binario zabbix_agent2 y ejecutándolo directamente; por ejemplo:
Agente 2 en sistemas Windows
El agente 2 de Zabbix se ejecuta como un proceso independiente; sin embargo, también puede ejecutarse como un servicio de Windows.
Instalación
El agente Zabbix 2 puede instalarse en Windows utilizando uno de los siguientes métodos:
- Binarios precompilados del agente Zabbix: descargue el paquete instalador MSI del agente Zabbix y siga las instrucciones en la página Instalación del agente en Windows desde MSI.
- Fuentes de Zabbix: descargue los archivos fuente y siga las instrucciones en la página Compilación del agente Zabbix 2 en Windows. Tenga en cuenta que se requiere un entorno Go configurado con una versión de Go actualmente soportada para compilar el agente Zabbix 2.
Las capacidades de monitorización del agente Zabbix 2 pueden ampliarse con plugins. Mientras que los plugins integrados están disponibles por defecto, los plugins cargables en Windows deben instalarse por separado. Para más información, consulte Plugins cargables.
Consulte la página Agente Zabbix en Microsoft Windows para obtener detalles adicionales sobre la instalación del agente Zabbix 2 (desde un archivo ZIP) como un servicio de Windows.
Opciones
Los siguientes parámetros de línea de comandos se pueden utilizar con Zabbix Agent 2:
| Parámetro | Descripción |
|---|---|
| Agente 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 que no sea el predeterminado. En UNIX, el valor predeterminado es /usr/local /etc/zabbix_agent2.conf o según lo establecido por las variables tiempo de compilación --sysconfdir o --prefix En Windows, el valor predeterminado es C: de programa\Zabbix Agent 2\zabbix_agent2.conf |
| -f --foreground | Ejecute el agente Zabbix en primer plano (predeterminado: verdadero). |
| -p --print | Imprime elementos conocidos y sale. Nota: Para devolver también los resultados de parámetro de usuario, debe especificar el archivo de configuración (si es no en la ubicación predeterminada). |
| -t --test <clave de elemento> | Pruebe el elemento especificado y salga. 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). |
| -T --test-config | Validar el archivo de configuración y salir. |
| -h --help | Imprimir información de ayuda y salir. |
| -v --verbose | Imprimir información de depuración. Utilice esta opción con las opciones -p y -t. |
| -V --version | Imprime la versión del agente y la información de licencia. |
| -R --runtime-control <opción> | Realizar funciones administrativas. Consulte control de tiempo de ejecución. |
| Sólo agente de Windows | |
| -m --multiple-agents | Utilice múltiples instancias de agente (con opciones -i, -d, -s, -x). Para distinguir los nombres de servicio de las instancias, cada nombre de servicio incluirá el valor de Nombre de host del especificado archivo de configuración. |
| -S --startup-type <valor> | Establece el tipo de inicio del servicio del agente de Windows Zabbix. Valores permitidos:automático - (predeterminado) inicia el servicio automáticamente al iniciar Windows;retrasado: retrasa el inicio del servicio después de que los servicios iniciados automáticamente hayan completado el inicio;manual - iniciar el servicio manualmente (por un usuario o aplicación);disabled: deshabilita el servicio, para que un usuario o una aplicación no pueda iniciarlo.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 | Instala el agente Zabbix para Windows como servicio. |
| -d --uninstall | Desinstalar el servicio de agente de Windows Zabbix. |
| -s --start | Inicia el servicio del agente de Windows Zabbix. |
| -x --stop | Detener el servicio del agente de Windows Zabbix. |
Ejemplos específicos del uso de parámetros de línea de comandos:
- mostrar todas las métricas del agente integrados 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 el valor predeterminado ruta al archivo de configuración C:\Program Files\Zabbix Agent 2\zabbix_agent2.conf
- modificar el tipo de inicio de un servicio "Zabbix Agent" instalado para Windows utilizando el archivo de configuración zabbix_agent2.conf ubicado en el mismo carpeta como agente ejecutable
zabbix_agent2 --print
zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agent2.exe -i
zabbix_agent2.exe -c zabbix_agent2.conf -S delayedControl de tiempo de ejecución
El control de tiempo de ejecución proporciona algunas opciones para el control remoto.
| Opción | Descripción |
|---|---|
| log_level_increase | Aumentar el nivel de registro. |
| log_level_decrease | Disminuir el nivel de registro. |
| metrics | Listar las métricas disponibles. |
| version | Mostrar la versión del agente. |
| userparameter_reload | Recargar los valores de las opciones UserParameter e Include desde el archivo de configuración actual. |
| help | Mostrar información de ayuda sobre el control de tiempo de ejecución. |
Ejemplos:
- aumentar el nivel de registro para el agente 2
- imprimir las opciones de control de tiempo de ejecución
Desde Zabbix 7.0.17, los comandos de control de tiempo de ejecución del agente 2 escriben la salida en stdout (salida estándar) en lugar de stderr (error estándar).
Archivo de configuración
Los parámetros de configuración del agente 2 son en su mayoría compatibles con los del Agente Zabbix con algunas excepciones.
| Nuevos parámetros | Descripción |
|---|---|
| ControlSocket | La ruta del socket de control en tiempo de ejecución. El agente 2 usa un socket de control para [comandos de tiempo de ejecución] (#runtime_control). |
| EnablePersistentBuffer, PersistentBufferFile, PersistentBufferPeriod |
Estos parámetros se utilizan para configurar el almacenamiento persistente en el agente 2 para elementos activos. |
| Plugins | Los complementos pueden tener sus propios parámetros, en el formato Plugins.<Nombre del complemento>.<Parámetro>=<valor>. Un parámetro de complemento común es System.Capacity, que establece el límite de comprobaciones que se pueden ejecutar al mismo tiempo. |
| StatusPort | El agente de puerto 2 escuchará la solicitud de estado HTTP y mostrará una lista de complementos configurados y algunos parámetros internos |
| Parámetros eliminados | Descripción |
| AllowRoot, User | No se admite porque no se admite la daemonización. |
| LoadModule, LoadModulePath | Los módulos cargables no son compatibles. |
| StartAgents | Este parámetro se usó en el agente Zabbix para aumentar la concurrencia de verificación pasiva o deshabilitarla. En el Agente 2, la concurrencia se configura a nivel de complemento y se puede limitar mediante una configuración de capacidad. Mientras que actualmente no se admite la desactivación de comprobaciones pasivas. |
| HostInterface, HostInterfaceItem | Todavía no soportados. |
Para obtener más detalles, consulte las opciones del archivo de configuración para zabbix_agent2.
Códigos de salida
Zabbix Agent 2 también se puede compilar con versiones anteriores de OpenSSL (1.0.1, 1.0.2).
En este caso, Zabbix proporciona exclusiones mutuas para bloquear OpenSSL. Si un bloqueo o desbloqueo de mutex falla y se imprime un mensaje de error en el flujo estándar de error (STDERR) y el Agente 2 sale con el código de retorno 2 o 3, respectivamente.