Documentation
Table of Contents
2 Agente
Visi¨®n general
El agente Áú»¢¶Ä²© se implementa en un objetivo de monitoreo para monitorear activamente recursos locales y aplicaciones (estad¨ªsticas de discos duros, memoria, procesador, etc.).
El agente re¨²ne informaci¨®n operativa localmente y reporta datos al Servidor Áú»¢¶Ä²© para su posterior procesamiento. En caso de fallas (como un disco duro que se est¨¢ llenando o un proceso de servicio colapsado), el servidor Áú»¢¶Ä²© puede alertar activamente a los administradores de la m¨¢quina en particular que inform¨® el fracaso.
Los agentes de Áú»¢¶Ä²© son extremadamente eficientes debido al uso de llamadas nativas para la recopilaci¨®n de informaci¨®n estad¨ªstica.
Controles pasivos y activos
Los agentes de Áú»¢¶Ä²© pueden realizar controles pasivos y activos.
En un comprobaci¨®n pasiva el agente responde a una solicitud de datos. El servidor Áú»¢¶Ä²© (o proxy) solicita datos, por ejemplo, la carga de la CPU y el agente Áú»¢¶Ä²© devuelve el resultado.
Comprobaciones activas requieren un procesamiento m¨¢s complejo. El agente primero debe recuperar una lista de elementos del servidor Áú»¢¶Ä²© para procesamiento independiente. Luego env¨ªa peri¨®dicamente nuevos valores al servidor.
La realizaci¨®n de comprobaciones pasivas o activas se configura seleccionando el seguimiento respectivo tipo de elemento. El agente de Áú»¢¶Ä²© procesa elementos de tipo 'Agente Áú»¢¶Ä²©' o 'Agente Áú»¢¶Ä²© (activo)'.
Plataformas soportadas
El agente Áú»¢¶Ä²© es compatible con las siguientes plataformas:
- 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 del agente Áú»¢¶Ä²© heredado para NetBSD y HP-UX, y son compatibles con la versi¨®n actual del servidor/proxy de Áú»¢¶Ä²©.
Agente en sistemas tipo UNIX
El agente Áú»¢¶Ä²© en sistemas similares a UNIX se ejecuta en el host que se est¨¢ monitoreando.
±õ²Ô²õ³Ù²¹±ô²¹³¦¾±¨®²Ô
Ver la secci¨®n instalaci¨®n de paquete para las instrucciones sobre c¨®mo instalar el agente Áú»¢¶Ä²© como paquete.
Alternativamente, vea las instrucciones para instalaci¨®n manual si no desea utilizar paquetes.
En general, los agentes Áú»¢¶Ä²© de 32 bits funcionar¨¢n en sistemas 64 bits , pero puede fallar en algunos casos.
Si se instala como paquete
El agente Áú»¢¶Ä²© se ejecuta como un proceso daemon. El agente puede ser iniciado ejecutando:
Esto funcionar¨¢ en la mayor¨ªa de los sistemas GNU/Linux. En otros sistemas, puede que necesite ejecutar:
Del mismo modo, para detener/reiniciar/ver el estado del agente Áú»¢¶Ä²©, use los siguientes comandos:
Iniciar manualmente
Si lo anterior no funciona, debe iniciarlo manualmente. encuentre el camino al binario zabbix_agentd y ejecute:
Agente en sistemas Windows
El agente de Áú»¢¶Ä²© en Windows se ejecuta como un servicio de Windows.
±Ê°ù±ð±è²¹°ù²¹³¦¾±¨®²Ô
El agente Áú»¢¶Ä²© se distribuye como un archivo zip. Despu¨¦s de descargar el archivo que necesita para descomprimirlo. Elija cualquier carpeta para almacenar el agente Áú»¢¶Ä²© y el archivo de configuraci¨®n, es decir.
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.
±õ²Ô²õ³Ù²¹±ô²¹³¦¾±¨®²Ô
Una vez hecho esto, use el siguiente comando para instalar el agente Áú»¢¶Ä²© como Servicio de Windows:
Ahora deber¨ªa poder configurar el servicio "Agente Áú»¢¶Ä²©" normalmente como cualquier otro servicio de Windows.
Ver m¨¢s detalles](/manual/appendix/install/windows_agent#installing_agent_as_windows_service) sobre la instalaci¨®n y ejecuci¨®n del agente Áú»¢¶Ä²© en Windows.
Otras opciones del agente
Es posible ejecutar varias instancias del agente en un equipo. Una ¨²nica 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 pueden utilizar el archivo de configuraci¨®n predeterminado).
Los siguientes par¨¢metros de l¨ªnea de comando se pueden usar con el agente Áú»¢¶Ä²©:
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|
| Agente UNIX y Windows | |
| -c --config <archivo-config> | 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_agentd.conf o seg¨²n lo establecido por las variables tiempo de compilaci¨®n --sysconfdir o --prefix En Windows, el valor predeterminado es c:?_agentd.conf |
| -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 m¨¦trica> | Pruebe la m¨¦trica especificada 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). |
| -h --help | Mostrar informaci¨®n de ayuda |
| -V --version | Mostrar n¨²mero de versi¨®n |
| S¨®lo agente UNIX | |
| -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 funciones -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. |
| Solo agente de Windows (funciones) | |
| -i --install | Instalar el agente Áú»¢¶Ä²© para Windows como servicio |
| -d --uninstall | Desinstalar el servicio de agente de Windows Áú»¢¶Ä²© |
| -s --start | Iniciar el servicio del agente de Windows Áú»¢¶Ä²© |
| -x --stop | Detener el servicio del agente de Windows Áú»¢¶Ä²© |
Ejemplos espec¨ªficos del uso de par¨¢metros de l¨ªnea de comando:
- imprimir todos los elementos 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 "Áú»¢¶Ä²© Agent" para Windows usando el valor predeterminado ruta al archivo de configuraci¨®n c:\zabbix_agentd.conf
- instalar un servicio "Áú»¢¶Ä²© Agent [Hostname]" para Windows usando el archivo de configuraci¨®n zabbix_agentd.conf ubicado en el mismo carpeta como agente ejecutable y hacer que el nombre del servicio sea ¨²nico extendi¨¦ndolo por el valor del nombre de host del archivo de configuraci¨®n
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.confControl en tiempo de ejecuci¨®n
Con las opciones de control en tiempo de ejecuci¨®n, puede cambiar el nivel de registro del agente.
| °¿±è³¦¾±¨®²Ô | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | 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, oyente) Ver todos los tipos de procesos de agente. tipo de proceso,N - tipo y n¨²mero de proceso (por ejemplo, oyente,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 oyente
- aumento del nivel de registro del proceso con PID 1234
- disminuci¨®n 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
zabbix_agentd -R log_level_decrease="active checks"El control en tiempo de ejecuci¨®n no es compatible con OpenBSD, NetBSD y 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²©, consulte las opciones del archivo de configuraci¨®n zabbix_agentd o Agente de Windows.
°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô 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
Antes de la versi¨®n 2.2, el agente Áú»¢¶Ä²© devolv¨ªa 0 en caso de salida exitosa y 255 en caso de falla. A partir de la versi¨®n 2.2 y superior Áú»¢¶Ä²© agent devuelve 0 en caso de salida exitosa y 1 en caso de falla.