Documentation
Table of Contents
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.
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 comprovació de 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 Scheduling 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ó de Plugins paràmetre.
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 a sistemes basats en Linux mitjançant un dels mètodes següents:
- Paquets Zabbix: trieu 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 de Zabbix - descarregueu els fitxers font i compileu l'agent Zabbix configurant les fonts amb l'opció
--enable-agent2. Tingueu en compte que es requereix un entorn Go configurat amb una [versió Go] (https://go.dev/doc/devel/release#policy) compatible actualment per crear l'agent Zabbix 2.
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:
Per aturar, reiniciar o comprovar l'estat de l'agent Zabbix 2, feu servir les ordres següents:
Engegar manualment
Podeu engegar l'agent Zabbix buscant el binari zabbix_agent2 i executant-lo directament; per exemple:
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:
- Binaris de l'agent Zabbix precompilats - descarregueu el paquet d'instal·lació MSI de l'agent Zabbix i seguiu les instruccions de la pàgina Instal·lació de l'agent de Windows des de MSI.
- Fonts Zabbix - descarregueu els fitxers font i seguiu les instruccions de la pàgina Building Zabbix agent 2 a Windows. Tingueu en compte que es requereix un entorn Go configurat amb una [versió Go] (https://go.dev/doc/devel/release#policy) compatible actualment per crear l'agent Zabbix 2.
Les capacitats de monitoratge de l'agent 2 de Zabbix es poden ampliar amb connectors. Tot i que els connectors integrats estan disponibles de manera immediata, els connectors carregables a Windows s'han d'instal·lar per separat. Per obtindre més informació, veieu Connexions carregables de l'agent Zabbix 2.
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 delayedControl d'execució
El control d'execució ofereix algunes opcions per al control remot.
| Opció | Descripció |
|---|---|
| log_level_increase | Augmenta 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ó
Arxiu de configuració
La configuració de l'agent 2 és majoritàriament compatible amb l'agent Zabbix, però amb algunes excepcions.
| Nova configuració | Descripció |
|---|---|
| ControlSocket | La ruta al socket de control d'execució. L'agent 2 empra un sòcol de control per a ordres d'execució. |
| EnablePersistentBuffer, PersistentBufferFile, PersistentBufferPeriod |
Aquests paràmetres s'empren per configurar l'emmagatzematge persistent a l'agent 2 per als elements actius. |
| ForceActiveChecksOnStart | Determina si l'agent ha de fer comprovacions actives immediatament després del reinici o si es distribueixen uniformement al llarg del temps. |
| Plugins | Els plugins poden tindre els seus propis paràmetres, en format Plugins.<Plugin name>.<Parameter>=<value>. Un paràmetre de plugin comú és System.Capacity, que estableix el límit de comprovacions que es poden executar al mateix temps. |
| StatusPort | Port Agent 2 escoltarà la petició d'estat HTTP i mostrarà una llista de connectors configurats i alguns paràmetres interns |
| Dropped paràmeters | Description |
| AllowRoot,User | No s'admet perquè la demonització no és compatible. |
| LoadModule,LoadModulePath | No s'admeten els mòduls carregables. |
| StartAgents | Aquest paràmetre es va emprar a l'agent Zabbix per augmentar la concurrència de comprovacions passives o per desactivar-les. A l'Agent 2, la concurrència es configura a nivell de connector i es pot limitar per una configuració de capacitat, tot i que la desactivació de comprovacions passives actualment no és compatible. |
| HostInterface,HostInterfaceItem | Encara no és compatible. |
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.