Documentation
Table of Contents
3 Agent 2
Vista general
L'agent Áú»¢¶Ä²© 2 ¨¦s una nova generaci¨® d'agent Áú»¢¶Ä²©, escrit en llenguatge de programaci¨® Go (amb algun codi C de l'agent Áú»¢¶Ä²© reutilitzat). Áú»¢¶Ä²© 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 Áú»¢¶Ä²©, admetent totes les caracter¨ªstiques anteriors.
Comprovacions actives i passives
L'agent Áú»¢¶Ä²© 2 admet comprovacions passives i actives, de manera similar a l'agent Áú»¢¶Ä²©. A m¨¦s, les comprovacions actives de l'agent 2 de Áú»¢¶Ä²© admeten intervals flexibles/de programaci¨® i comprovaci¨® de concurr¨¨ncia dins d'un servidor actiu.
Per defecte, l'agent Áú»¢¶Ä²© 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 ±è²¹°ù¨¤³¾±ð³Ù°ù±ð ForceActiveChecksOnStart (nivell global) o Plugins .<Nom del connector>.System.ForceActiveChecksOnStart (afecta nom¨¦s comprovacions espec¨ªfiques del connector) al fitxer de configuraci¨®. El ±è²¹°ù¨¤³¾±ð³Ù°ù±ð de nivell de connector, si s'estableix, anul¡¤lar¨¤ el ±è²¹°ù¨¤³¾±ð³Ù°ù±ð 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 ±è²¹°ù¨¤³¾±ð³Ù°ù±ð.
Plataformes compatibles
Per obtindre les plataformes compatibles, consulteu la p¨¤gina Requisits.
Agent 2 a sistemes Unix
L¡¯agent 2 de Áú»¢¶Ä²© a sistemes Unix s'executa a un equip monitorat.
±õ²Ô²õ³Ù²¹±ô¡¤±ô²¹³¦¾±¨®
L'agent Áú»¢¶Ä²© 2 es pot instal¡¤lar a sistemes basats en Linux mitjan?ant un dels m¨¨todes seg¨¹ents:
- Paquets Áú»¢¶Ä²©: trieu el component Agent 2 (despr¨¦s de seleccionar la vostra versi¨® de Áú»¢¶Ä²©, la distribuci¨® del sistema operatiu i la versi¨® del sistema operatiu) i seguiu les instruccions proporcionades.
- Fonts de Áú»¢¶Ä²© - descarregueu els fitxers font i compileu l'agent Áú»¢¶Ä²© 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 Áú»¢¶Ä²© 2.
Si s'ha instal¡¤lat com a paquet
L'agent Áú»¢¶Ä²© 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²© 2, feu servir les ordres seg¨¹ents:
Engegar manualment
Podeu engegar l'agent Áú»¢¶Ä²© buscant el binari zabbix_agent2 i executant-lo directament; per exemple:
Agent 2 a sistemes Windows
L'agent Áú»¢¶Ä²© 2 s'executa com un proc¨¦s aut¨°nom; tanmateix, tamb¨¦ es pot executar com a servei de Windows.
±õ²Ô²õ³Ù²¹±ô¡¤±ô²¹³¦¾±¨®
L'agent Áú»¢¶Ä²© 2 es pot instal¡¤lar a Windows mitjan?ant un dels m¨¨todes seg¨¹ents:
- Binaris de l'agent Áú»¢¶Ä²© precompilats - descarregueu el paquet d'instal¡¤laci¨® MSI de l'agent Áú»¢¶Ä²© i seguiu les instruccions de la p¨¤gina ±õ²Ô²õ³Ù²¹±ô¡¤±ô²¹³¦¾±¨® de l'agent de Windows des de MSI.
- Fonts Áú»¢¶Ä²© - descarregueu els fitxers font i seguiu les instruccions de la p¨¤gina Building Áú»¢¶Ä²© 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 Áú»¢¶Ä²© 2.
Les capacitats de monitoratge de l'agent 2 de Áú»¢¶Ä²© 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 Áú»¢¶Ä²© 2.
Consulteu la p¨¤gina Agent Áú»¢¶Ä²© a Microsoft Windows per obtindre informaci¨® addicional sobre la instal¡¤laci¨® de l'agent Áú»¢¶Ä²© 2 (des d'un arxiu ZIP) com a servei de Windows.
Opcions
Els ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs de l¨ªnia de comandes seg¨¹ents es poden emprar amb l'agent Áú»¢¶Ä²© 2:
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|
| 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 Áú»¢¶Ä²© en primer pla (per defecte: cert). |
| -p --print | Mostra els elements coneguts i surt. Nota: Per retornar tamb¨¦ els resultats dels ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs 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 ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs 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 ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs -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 Áú»¢¶Ä²©. Valors permesos:²¹³Ü³Ù´Ç³¾¨¤³Ù¾±³¦ - (per defecte) inicia el servei ²¹³Ü³Ù´Ç³¾¨¤³Ù¾±³¦ament a l'inici de Windows;delayed - endarrereix l'inici del servei despr¨¦s que els serveis iniciats ²¹³Ü³Ù´Ç³¾¨¤³Ù¾±³¦ament 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 Áú»¢¶Ä²© Windows com a servei. |
| -d --uninstall | Desinstal¡¤la el servei d'agent de Windows Áú»¢¶Ä²©. |
| -s --start | Iniciar el servei d'agent Áú»¢¶Ä²© Windows. |
| -x --stop | Atura el servei d'agent de Windows Áú»¢¶Ä²©. |
Exemples ±ð²õ±è±ð³¦¨ª´Ú¾±³¦²õ d'¨²s de ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs de l¨ªnia d'ordres:
- mostra tots els elements de l'agent integrat amb els seus valors
- prova un ±è²¹°ù¨¤³¾±ð³Ù°ù±ð d'usuari amb la clau "mysql.ping" definida al fitxer de configuraci¨® especificat
- instal¡¤la un servei "Áú»¢¶Ä²© Agent" per a Windows amb la ruta predeterminada al fitxer de configuraci¨® C:\Fitxers de programa\Áú»¢¶Ä²© Agent 2\zabbix_agent2.conf
- modifica el tipus d'inici d'un servei "Áú»¢¶Ä²© 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.
| °¿±è³¦¾±¨® | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|
| 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 Áú»¢¶Ä²©, per¨° amb algunes excepcions.
| Nova configuraci¨® | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|
| 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 ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs 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 ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs, en format Plugins.<Plugin name>.<Parameter>=<value>. Un ±è²¹°ù¨¤³¾±ð³Ù°ù±ð 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 ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs 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 ±è²¹°ù¨¤³¾±ð³Ù°ù±ð es va emprar a l'agent Áú»¢¶Ä²© 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 Áú»¢¶Ä²© 2 es pot compilar amb les versions antigues d'OpenSSL (1.0.1, 1.0.2).
En aquest cas, Áú»¢¶Ä²© 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.