3 Agent 2

Vista general

L'agent Zabbix 2 és una nova generació d'agent Zabbix, escrit en llenguatge de programació Go (amb algun codi C de l'agent Zabbix reutilitzat). Zabbix agent 2 s'ha desenvolupat per:

  • reduir el nombre de connexions TCP
  • proporcionar una concurrència millorada de les validacions
  • ser fàcilment extensible amb plugins, que proporcionen comprovacions trivials que consisteixen només en unes poques línies de codi senzilles i comprovacions complexes que consisteixen en scripts de llarga durada i recollida de dades autònoma amb enviament periòdic de les dades
  • ésser un substitut directe de l'agent Zabbix, admetent totes les característiques anteriors.

Totes les mètriques admeses per Zabbix agent 2 es recullen per plugins.

Comprovacions actives i passives

L'agent Zabbix 2 admet comprovacions passives i actives, de manera similar a l'agent Zabbix. A més, les comprovacions actives de l'agent 2 de Zabbix admeten intervals flexibles/de programació i comprovar la concurrència dins d'un servidor actiu.

Per defecte, l'agent Zabbix 2 programarà la primera recollida de dades per a comprovacions actives en un moment condicionalment aleatori dins de l'interval d'actualització de l'element per evitar pics en l'ús dels recursos. Per realitzar comprovacions actives que no tinguin programació intervals d'actualització programats, immediatament després de reiniciar l'agent, configureu el paràmetre ForceActiveChecksOnStart (nivell global) o Plugins.<Nom del connector>.System.ForceActiveChecksOnStart (afecta només comprovacions específiques del connector) al fitxer de configuració. El paràmetre de nivell de connector, si s'estableix, anul·larà el paràmetre global.

Comprovar concurrència

Les comprovacions de diferents connectors es poden executar simultàniament. El nombre de comprovacions simultànies dins d'un connector és limitat per la configuració de capacitat del connector. Cada connector pot tindre una configuració de capacitat codificada (1000 per defecte) que es pot reduir mitjançant la configuració Plugins.<PluginName>.System.Capacity=N a la configuració del paràmetre de Plugins.

Plataformes compatibles

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

Agent 2 a sistemes Unix

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

Instal·lació

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

  • Paquets Zabbix: seleccioneu el component Agent 2 (després de seleccionar la vostra versió de 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-agent2.

Les capacitats de monitoratge de l'agent 2 de Zabbix es poden ampliar amb complements carregables, que sóndisponibles per separat. Per a més detalls, consulteu Complements carregables.

Des de Zabbix 7.0.5, els paquets de l'agent 2 de Zabbix ja no estan disponibles per a RHEL 6 perquè Go 1.22 (i més recent) és incompatible amb GCC 4.4.7 proporcionat per RHEL 6, que genera errors de compilació. Tingueu en compte, però, que paquets d'agent Zabbix encara són compatibles.

Si s'ha instal·lat com a paquet

L'agent Zabbix 2 s'executa com a procés en primer pla i es basa en un gestor de serveis extern (per exemple, systemd) per a l'execució en segon pla. L'agent Zabbix 2 no té suport de demonització integrat a Linux.

L'agent es pot iniciar executant:

    systemctl start zabbix-agent2

Per aturar, reiniciar o comprovar l'estat de l'agent Zabbix 2, feu servir les ordres següents:

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

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

    zabbix_agent2d

Agent 2 a sistemes Windows

L'agent Zabbix 2 s'executa com un procés autònom; tanmateix, també es pot executar com a servei de Windows.

Instal·lació

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

Les capacitats de monitoratge de l'agent 2 de Zabbix es poden ampliar amb connectors carregables, disponibles per separat. Per obtenir més informació, veieu Connexions carregables.

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

Opcions

Els paràmetres de línia de comandes següents es poden emprar amb l'agent Zabbix 2:

Paràmetre Descripció
Agent a UNIX i Windows
-c --config <config-file> Camí al fitxer de configuració.
Podeu emprar aquesta opció per especificar un fitxer de configuració no predeterminat.
A UNIX, per defecte és /usr/local/etc/zabbix _agent2.conf o tal com defineixen les variables temps de compilació --sysconfdir o --prefix
-f --foreground Executar l'agent Zabbix en primer pla (per defecte: cert).
-p --print Mostra els elements coneguts i surt.
Nota: Per retornar també els resultats dels paràmetres d'usuari, heu d'especificar el fitxer de configuració (si no es troba a la ubicació predeterminada).
-t --test <clau d'element> Prova l'element especificat i surt.
Nota: Per retornar també els resultats dels paràmetres d'usuari, heu d'especificar el fitxer de configuració (si no es troba a la ubicació predeterminada).
-T --test-config Valida l'arxiu de configuració i surt.
-h --help Mostra informació d'ajuda i surt.
-v --verbose Mostra la informació de depuració. Empreu aquesta opció amb els paràmetres -p i -t.
-V --version Mostra la versió de l'agent i la informació de la llicència.
-R --runtime-control <opció> Realitzar funcions administratives. Veieu control d'execució.
Només agent de Windows
-m --multiple-agents Empreu múltiples instàncies d'agent (amb opcions -i, -d, -s, -x).
Per distingir els noms de servei de les instàncies, cada nom de servei inclourà el valor del nom d'equip del fitxer de configuració especificat.
-S --startup-type <valor> Defineix el tipus d'inici del servei d'agent de Windows Zabbix. Valors permesos:
automàtic - (per defecte) inicia el servei automàticament a l'inici de Windows;
delayed - endarrereix l'inici del servei després que els serveis iniciats automàticament hagin engegat;
manual - iniciar el servei manualment (per un usuari o aplicació);
disabled - desactiva el servei, de manera que un usuari o una aplicació no pugui iniciar-lo.
Podeu emprar aquesta opció juntament amb l'opció -i, o per separat per modificar el tipus d'inici d'un servei ja instal·lat.
-i --install Instal·la l'agent Zabbix Windows com a servei.
-d --uninstall Desinstal·la el servei d'agent de Windows Zabbix.
-s --start Iniciar el servei d'agent Zabbix Windows.
-x --stop Atura el servei d'agent de Windows Zabbix.

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

  • mostra tots els elements de l'agent integrat amb els seus valors.
  • prova un paràmetre d'usuari amb la clau mysql.ping definida al fitxer de configuració especificat.
  • instal·la un servei Zabbix Agent per a Windows amb la ruta predeterminada al fitxer de configuració C:\\Fitxers de programa\\Zabbix Agent 2\\zabbix\_agent2.conf.
  • modifica el tipus d'inici d'un servei "Zabbix Agent" instal·lat per a Windows, emprant el fitxer de configuració zabbix\_agent2.conf situat a la mateixa carpeta de l'agent executable.
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 d'execució

El control d'execució ofereix algunes opcions per al control remot.

Opció Descripció
log\_level\_increase Puja el nivell de registre.
log\_level\_decrease Disminueix el nivell de registre.
metrics Llista les mètriques disponibles.
version Mostra la versió de l'agent.
userparameter\_reload Torneu a carregar els valors de les opcions UserParameter i Include des del fitxer de configuració actual
help Mostra informació d'ajuda del control d'execució.

Exemples:

  • Augmentar del nivell de registre per a l'agent 2
  • Visualitzar opcions de control d'execució
    zabbix_agent2 -R log_level_increase
    zabbix_agent2 -R help

Des de Zabbix 7.0.17, les comandes de control d'execució de l'agent 2 escriuen la sortida a stdout (sortida estàndard) en lloc de stderr (error estàndard).

Fitxer de configuració

La ruta per defecte al fitxer de configuració és:

  • A UNIX, per defecte és /usr/local/etc/zabbix_agent2.conf o com s'estableix per compile-time variables --sysconfdir o --prefix.
  • A Windows, per defecte és C:\\Fitxers de programa\\Zabbix Agent 2\\zabbix_agent2.conf. Si una sola instància de l'agent s'està executant en un equip, pot utilitzar el fitxer de configuració per defecte o un fitxer de configuració especificat a la línia d'ordres. En el cas de múltiples instàncies, cada instància de l'agent ha de tenir el seu propi fitxer de configuració (una de les instàncies pot utilitzar el fitxer de configuració per defecte).

Els paràmetres de configuració de l'agent Zabbix 2 coincideixen majoritàriament amb els de l'agent Zabbix, amb algunes excepcions:

Paràmetres < Descripció
Zabbix agent 2 - paràmetres de configuració específics < <<
ControlSocket La ruta de presa de control en temps d'execució. Zabbix agent 2 utilitza un sòcol de control per ordres de temps d'execució.
EnablePersistentBuffer,
PersistentBufferFile,
PersistentBufferPeriod		 Aquests paràmetres s'utilitzen per configurar l'emmagatzematge persistent a l'agent Zabbix 2 per a elements actius.
ForceActiveChecksOnStart Determina si l'agent ha de realitzar comprovacions actives de seguida després de reiniciar-se o estendre's uniformement amb el temps.
Plugins Plugins poden tenir els seus propis paràmetres, en el format Plugins. <Nom del plugin>. <Paràmetre>=<valor>. Un paràmetre de plugin comú és System.Capacity, establint el límit de comprovacions que es poden executar al mateix temps.
StatusPort L'agent de port Zabbix 2 escoltarà la petició d'estat HTTP i la visualització d'un llistat de plugins configurats i alguns paràmetres interns.
Paràmetres de configuració específics de l'agent de Zabbix, no admesos a l'agent 2 de Zabbix < <
AllowRoot,
Usuari		 No admès a l'agent Zabbix 2 perquè no suporta la daemonització.
EnableRemoteCommands Ja no és disponible; s'utilitzen els paràmetres AllowKey i DenyKey als dos agents.
ListenBacklog Ús en l'agent Zabbix per definir el nombre màxim de connexions pendents a la cua TCP. No és compatible amb l'agent de Zabbix 2.
LoadModule,
LoadModulePath		 Els mòduls Loadable no són compatibles amb l'agent Zabbix 2.
MaxLinesParSecond,
LogRemoteCommands		 A Zabbix agent 2, Plugins.Log.MaxLinesParSecond i Plugins.SystemRun.LogRemoteCommands s'utilitzen en el seu lloc.
StartAgents Aquest paràmetre s'utilitza en l'agent Zabbix per augmentar la concurrència de comprovació passiva o desactivar-los. A Zabbix agent 2, la concurrència es configura a nivell de connector i es pot limitar mitjançant una configuració de capacitat. Les comprovacions passives estan desactivades a Zabbix Agent 2 si no s'especifica el paràmetre Server.

Per obtindre més informació, veieu les opcions del fitxer de configuració per a zabbix_agent2.

Codis de sortida

L''agent Zabbix 2 es pot compilar amb les versions antigues d'OpenSSL (1.0.1, 1.0.2).

En aquest cas, Zabbix proveeix mutexes per blocar, a OpenSSL. Si un mutex blocat o desblocat falla, s'escriurà un missatge d'error al flux d'errors estàndard (STDERR) i l'agent 2 surt amb el codi d'error 2 o 3, respectivament.