2 Agent

Vista general

L'agent Zabbix es desplega a un destí per supervisar els recursos i aplicacions locals (discs durs, memòria, estadístiques de processador, etc.).

L'agent recull detalls operacionals localment i transmet les dades al servidor Zabbix per tractar-les posteriorment. En cas d'errades (per exemple, disc dur ple o servei fallit), el servidor Zabbix pot alertar els administradors de la màquina on s'ha aturat el servei.

Els agents Zabbix són altament eficients perquè empren sistemes nadius per recollir dades estadístiques.

Verificacions passives i actives

Els agents Zabbix poden fer verificacions passives i actives.

  • Verificacions passives - l'agent respon a una petició de dades del servidor Zabbix (o el proxy). Per exemple, demana informació de la càrrega de processador, i l'agent Zabbix retorna el resultat.

  • Verificacions actives - L'agent ha de recuperar i enviar informació sense esperar una petició del servidor Zabbix (o proxy). Primer, recupera una llista d'elements monitorats del servidor (càrrega de CPU, memòria disponible, etc...). Després, recull la informació necessària i envia periòdicament nous valors al servidor.

El tipus de verificació es configura escollint un tipus d'element. L'agent Zabbix tracta els elements de tipus "Agent Zabbix" o "Agent Zabbix (actiu)".

Plataformes compatibles

Per obtindre les plataformes compatibles, consulteu la pàgina Requisits.

Agent a sistemes Unix

L’agent Zabbix a sistemes Unix s'executa a un equip monitorat.

Instal·lació

L'agent Zabbix es pot instal·lar en sistemes basats en Linux mitjançant un dels mètodes següents:

  • Paquets Zabbix: seleccioneu el component Agent (després de seleccionar la vostra versió Zabbix, la distribució del sistema operatiu i la versió del sistema operatiu) i seguiu les instruccions proporcionades.
  • Fonts Zabbix - descarregueu els fitxers font i compileu l'agent Zabbix configurant les fonts amb l'opció --enable-agent.

::: nota important En general, els agents Zabbix de 32 bits funcionaran en sistemes de 64 bits, però pot fallar en alguns casos. :::

Els binaris d'agent Zabbix precompilats estan disponibles per a descàrrega per a macOS, IBM AIX, FreeBSD, OpenBSD i Solaris. Els binaris heretats, compatibles amb la versió actual del servidor/proxy de Zabbix, són disponibles per a NetBSD i HP-UX.

Si s'instal·la com a paquet

L’agent Zabbix s'executa com un procés dimoni. L'agent es pot engegar executant:

systemctl start zabbix-agent

Això funcionarà a la majoria de sisetmes GNU/Linux. Sota altres sistemes haureu d'executar aquesta comanda:

/etc/init.d/zabbix-agent start

Per aturar/reiniciar/veure l'estat de l'agent Zabbix, empreu aquestes comandes:

systemctl stop zabbix-agent
       systemctl restart zabbix-agent
       systemctl status zabbix-agent
Engegar manualment

Podeu engegar l'agent Zabbix buscant el binari zabbix_agentd2 i executant-lo directament; per exemple:

zabbix_agentd2

Agent als sistemes Windows

L'agent Zabbix sota Windows s'executa com a servei de Windows.

Instal·lació

L'agent Zabbix es pot instal·lar a Windows mitjançant un dels mètodes següents:

Consulteu la pàgina Agent Zabbix a Microsoft Windows per obtindre informació addicional sobre la instal·lació de l'agent Zabbix (des d'un arxiu ZIP) com a servei de Windows.

Altres opcions de l'agent

Es poden executar múltiples instàncies de l'agent sota un equip. Una sola instància pot emprar l'arxiu de configuració per defecte especificat a la línia de comandes. En el cas d'instàncies múltiples, cada instància d'agent ha de tindre el seu propi fitxer de configuració (una de les instàncies pot emprar l'arxiu de configuració per defecte).

Els paràmetres de línia de comanda següents poden emprar-se amb l'agent Zabbix :

Paràmetre Descripció
Agent UNIX i Windows
-c --config <config-file> Ruta del fitxer de configuració.
Haureu d'emprar aquesta opció per especificar l'arxiu de configuració que no sigui el que hi ha per defecte.
Sota UNIX, l'arxiu per defecte és /usr/local/etc/zabbix_agentd.conf o com s'especifiqui a les variables compile-time --sysconfdir o --prefix
Sota Windows, l'arxiu per defecte és c:\zabbix_agentd.conf
-f --foreground Executa l'agent de Zabbix en primer pla (per defecte: cert).
-p --print Imprimir els elements coneguts i tancar.
Note: Per retornar igualment els resultats dels paràmetres d'usuari, haureu d'especificar l'arxiu de configuració (si no és a la ruta per defecte).
-t --test <item key> Proveu l'element especificat i tanqueu.
Note: Per retornar igualment els resultats dels paràmetres d'usuari, haureu d'especificar l'arxiu de configuració (si no és pas a la ruta per defecte).
-T --test-config Validar l'arxiu de configuració i sortir.
-h --help Mostra la informació d'ajuda
-V --version Mostra el nombre de versió
Només agent UNIX
-R --runtime-control <option> Gestiona funcions administratives. Veieu runtime control.
Només agent Windows
-m --multiple-agents Empra diverses instàncies de l'agent (amb les funcions -i,-d,-s,-x).
Per distingir els noms dels serveis dels de les instàncies, cada nom de servei inclourà el valor Hostname de l'arxiu de configuració especificat.
Només agent Windows (funcions)
-i --install Instal·la l'agent Windows Zabbix com a servei
-d --uninstall Desinstal·la el servei de l'agent Windows Zabbix
-s --start Engega el servei de l'agent Windows Zabbix
-x --stop Atura el servei de l'agent Windows Zabbix

Exemples específics d'ús dels paràmetres de línia de comandes:

  • imprimir tots els elements d'agent integrats amb valors
  • prova d'un paràmetre d'usuari amb la clau "mysql.ping" definida a l'arxiu de configuració especificat
  • instal·lació d'un servei "Agent Zabbix" per Windows emprant el camí per defecte de l'arxiu de configuració c:\zabbix_agentd.conf
  • instal·lació d'un servei "Agent Zabbix [Hostname]" per Windows emprant l'arxiu de configuració zabbix_agentd.conf ubicat a la mateixa carpeta que l'executable de l'agent i fer el nom de servei únic estenguent-lo per al valor Hostname de l'arxiu config
  • modificar el tipus d'inici d'un servei "Zabbix Agent" instal·lat a windows, emprant l'arxiu de configuració zabbix_agentd.conf ubicat al mateix lloc que l'agent executable
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 d'execució

Amb les opcions de control d'execució, podreu canviar el nivell de registre dels processos de l’agent.

Opció Descripció Objectiu
log_level_increase[=<target>] Augmentar el nivell de registre.
Si no s'especifica l'objectiu, tots els processos es veuran afectats.
Es pot especificar l'objectiu de la manera següent:
process type - tots els processos de tipus especificats (ex : listener)
Veieu tots els tipus de processos de l'agent.
process type,N - tipus de processos i nombre (ex : listener,3)
pid - identificador de processos (1 a 65535). Per valors més grans, especifiqueu l'objectiu com a 'process-type,N'.
log_level_decrease[=<target>] Disminuir el nivell de registre.
Si l'objectiu no s'especifica, es veuen afectats tots els processos.
userparameter_reload Recarregar els paràmetres d'usuari a partir de l'arxiu de configuració actual.
Veieu que UserParameter és la única opció de configuració de l'agent que es recarregarà.

Exemples :

  • augmentar el nivell de registre de tots els processos
  • augmentar el nivell de registre del tercer procés que escolta
  • augmentar el nivell de registre dels processos amb el PID 1234
  • disminuir el nivell de registre de tots els processos de validació actius
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 d'execució no s'admet pas sota OpenBSD, NetBSD i Windows.

Tipus de processos Agent

  • ​active checks​ - processos que fan verificacions actives
  • ​collector​ - processos per recollir dades
  • ​listener​ - processos que escolten les verificacions passives

L'arxiu de registre de l'agent es pot emprar per observar aquests tipus de processos.

Processos d'usuari

L'agent Zabbix sota UNIX s'ha pensat per executar com a usuari i no pas com a root. Funcionarà amb l'usuari no-root hagi iniciat. Podeu doncs executar l'agent com un usuari no-root sense problemes.

Si proveu d'executar-lo com a 'root', aquest passarà a un usuari 'zabbix' codi en brut, que ha d'ésser present al vostre sistema. Podeu executar només l'agent com a 'root' si modifiqueu el paràmetre 'AllowRoot' a l'arxiu de configuració de l'agent associat.

Arxiu de configuració

Per tindre més detalls de la configuració de l'agent Zabbix, veieu les opcions de l'arxiu de configuració per zabbix_agentd o l'[agent Windows]/manual/appendix/config/zabbix_agentd_win).

Entorn Local

Veieu que a l'agent li cal un entorn local UTF-8 per tal que determinats elements d'agent textuals retornar el contingut esperat. La majoria dels sistemes moderns de tipus Unix tenen un paràmetre regional UTF-8 per defecte; de tota manera, alguns sistemes poden haver d'ésser definits específicament.

Codi de sortida

L'agent Zabbix retorna 0 en cas de sortida correcta i 1 en cas de fallida.