3 Agente 2

Descripción general

Zabbix Agent 2 es una nueva generación de Zabbix Agent y puede usarse en lugar del agente Zabbix. Zabbix Agent 2 ha sido desarrollado para:

  • reducir el número de conexiones TCP
  • proporcionar una mejor simultaneidad de controles
  • ser fácilmente ampliable con complementos. Un complemento debería poder:
    • proporcionar controles triviales que constan sólo de unas pocas líneas simples de código
    • proporcionar comprobaciones complejas que constan de scripts de larga duración y recopilación de datos independiente con envío periódico de los datos
  • ser un reemplazo directo para el agente Zabbix (ya que es compatible con todos la funcionalidad anterior)

El Agente 2 está escrito en el lenguaje de programación Go (con algo de código C del agente Zabbix reutilizado). Un entorno Go configurado con una versión Go actualizada y compatible
es necesario para construir el agente Zabbix 2.

El Agente 2 no tiene soporte de demonización integrado en Linux; se puede ejecutar como un servicio de Windows.

Comprobaciones pasivas y activas

Las comprobaciones pasivas funcionan de manera similar al agente Zabbix. Soporta comprobaciones activas a intervalos programados/flexibles y comprueba la simultaneidad dentro de un servidor activo.

De forma predeterminada, después de reiniciar, el agente 2 de Zabbix programará la primera recopilación de datos para comprobaciones activas en un momento condicionalmente aleatorio dentro del intervalo de actualización de la métrica para evitar picos en el uso de recursos. Para realizar comprobaciones activas que no tienen intervalo de actualización programada inmediatamente después del reinicio del agente, configure el parámetro ForceActiveChecksOnStart (nivel global) o Plugins .<Nombre del complemento>.System.ForceActiveChecksOnStart (afecta solo a comprobaciones de complementos específicos) en el archivo de configuración. El parámetro a nivel de complemento, si está configurado, reemplazará 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

Zabbix Agent 2 es compatible con las siguientes plataformas:

Agent 2 on UNIX-like systems

Zabbix agent 2 on UNIX-like systems is run on the host being monitored.

Instalación

Para instalar Zabbix Agent 2, están disponibles las siguientes opciones:

Windows:

Linux:

  • desde paquetes de distribución - siga las instrucciones en la página paquetes Zabbix, disponible eligiendo su distribución y el Componente del agente 2
  • desde fuentes: consulte Instalación desde fuentes; tenga en cuenta que debe configurar las fuentes especificando la opción de configuración --enable-agent2

Las capacidades de monitoreo del agente 2 de Zabbix se pueden ampliar con complementos. Si bien los complementos integrados están disponibles listos para usar, los complementos cargables deben instalarse por separado. Para obtener más información, consulte Complementos.

If installed as package

Zabbix agent 2 runs as a foreground process and relies on an external service manager (e.g., systemd) for background execution; Zabbix agent 2 does not have built-in daemonization support on Linux.

The agent can be started by executing:

systemctl start zabbix-agent2

To stop, restart, or check the status of Zabbix agent 2, use the following commands:

systemctl stop zabbix-agent2
systemctl restart zabbix-agent2
systemctl status zabbix-agent2
Start up manually

You can start Zabbix agent by locating the zabbix_agent2 binary and running it directly; for example:

zabbix_agent2

Agent 2 on Windows systems

Zabbix agent 2 runs as a standalone process; however, it can also be run as a Windows service.

Installation

Zabbix agent 2 can be installed on Windows using one of the following methods:

Zabbix agent 2 monitoring capabilities can be extended with plugins. While built-in plugins are available out-of-the-box, loadable plugins on Windows must be installed separately. For more information, see Zabbix agent 2 loadable plugins.

See the Zabbix agent on Microsoft Windows page for additional details on installing Zabbix agent 2 (from a ZIP archive) as a Windows service.

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:\ \Archivos 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 delayed
Control de tiempo de ejecución

El control en 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 Lista de métricas disponibles.
version Mostrar versión del agente.
userparameter_reload Recargar los valores de las opciones UserParameter e Include del archivo de configuración actual.
help Mostrar información de ayuda sobre el control del tiempo de ejecución.

Ejemplos:

  • aumentar el nivel de registro para el agente 2
  • mostrar opciones de control de tiempo de ejecución
zabbix_agent2 -R log_level_increase
zabbix_agent2 -R help

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.