Esta es una traducción de la página de documentación original en español. Ayúdanos a mejorarla.

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.

En una comprobación pasiva el agente responde a una solicitud de datos. El servidor Zabbix (o proxy) solicita datos, por ejemplo, la carga de la CPU y el agente Zabbix devuelve el resultado.

Las comprobaciones activas requieren un procesamiento más complejo. El agente primero debe recuperar una lista de métricas del servidor Zabbix para su procesamiento independiente. Luego envía periódicamente nuevos valores al servidor.

Si las comprobaciones son pasivas o activas se configura seleccionando el respectivo tipo de métrica de monitoreo. El agente Zabbix procesa métricas de tipo 'Agente Zabbix' o 'Agente Zabbix (activo)'.

Plataformas compatibles

Los archivos binarios precompilados del agente Zabbix están disponibles para las plataformas compatibles:

  • Windows (todas las versiones de escritorio y servidor desde XP)
  • Linux (también disponible en paquetes de distribución)
  • Mac OS
  • IBM AIX
  • FreeBSD
  • OpenBSD
  • Solaris

También es posible descargar archivos binarios antiguos del agente Zabbix para NetBSD y HP-UX, que son compatibles con la versión actual del servidor/proxy de Zabbix.

Agente en sistemas tipo UNIX

El agente Zabbix en sistemas similares a UNIX se ejecuta en el equipo que se está monitoreando.

Instalación

Ver la sección instalación de paquetes para obtener las instrucciones sobre cómo instalar el agente Zabbix como paquete.

Alternativamente, vea las instrucciones para la instalación manual si no desea utilizar paquetes.

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

Si se instala como paquete

El agente Zabbix se ejecuta como un proceso daemon. El agente puede ser iniciado 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

Del mismo modo, para detener/reiniciar/ver el estado del agente Zabbix, use los siguientes comandos:

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

Si lo anterior no funciona, debe iniciarlo manualmente. Encuentre el camino al binario zabbix_agentd y ejecute:

zabbix_agentd

Agente en sistemas Windows

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

Preparación

El agente Zabbix se distribuye como un archivo zip. Después de descargar el archivo que necesita para descomprimirlo. Elija cualquier carpeta para almacenar el agente Zabbix y el archivo de configuración, es decir.

C:\zabbix

Copie los archivos bin\zabbix_agentd.exe y conf\zabbix_agentd.conf en c:\zabbix.

Edite el archivo c:\zabbix\zabbix_agentd.conf según sus necesidades, asegurándose de para especificar un parámetro "Hostname" correcto.

Instalación

Una vez hecho esto, use el siguiente comando para instalar el agente Zabbix como servicio de Windows:

C:\> c:\zabbix\zabbix_agentd.exe -c c:\zabbix\zabbix_agentd.conf -i

Ahora debería poder configurar el servicio "Zabbix agent" normalmente como cualquier otro servicio de Windows.

Ver más detalles sobre la instalación y ejecución del agente Zabbix en 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 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 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 activos
  • collector - proceso para la recopilación de datos
  • listener - 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.