Documentation
Table of Contents
3 Agent 2
Vista general
L'agent Áú»¢¶Ä²© 2 ¨¦s una nova generaci¨® d'agent Áú»¢¶Ä²© i es pot emprar en lloc de l'agent Áú»¢¶Ä²©. Áú»¢¶Ä²© 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 complements. Un connector hauria d'esser capa? de:
- proporcionar comprovacions trivials que consisteixen nom¨¦s en unes poques l¨ªnies de codi senzilles
- proporcionar 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 Áú»¢¶Ä²© (ja que la funcionalitat anterior ¨¦s ¨¦s compatible)
L'Agent 2 s'ha escrit en llenguatge de programaci¨® Go (amb algun codi C de l'agent Áú»¢¶Ä²© reutilitzat). Es requereix un entorn Go configurat amb una [versi¨® de Go] (https://go.dev/doc/devel/release#policy) compatible per crear l'agent Áú»¢¶Ä²© 2.
L'agent 2 no t¨¦ suport integrat per a la demonitzaci¨® a Linux; es pot executar com a servei de Windows.
Les comprovacions passives funcionen de manera similar a l'agent Áú»¢¶Ä²©. Les comprovacions actives admeten intervals programats/flexibles i comproven la 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. For?ar comprovacions actives a l'inici ¨¦s compatible des de Áú»¢¶Ä²© 6.0.2.
Comprova la 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 (100 per defecte) que es pot reduir mitjan?ant la configuraci¨® Plugins.<PluginName>.System.Capacity=N a la configuraci¨® de Plugins ±è²¹°ù¨¤³¾±ð³Ù°ù±ð. El nom anterior d'aquest ±è²¹°ù¨¤³¾±ð³Ù°ù±ð Plugins.<PluginName>.Capacity encara ¨¦s compatible, per¨° ha quedat obsolet a Áú»¢¶Ä²© 6.0.
Veieu tamb¨¦: Directrius de desenvolupament de complements.
Plataformes admeses
L'agent Áú»¢¶Ä²© 2 s'admet a les plataformes seg¨¹ents:
- Windows (totes les versions d'escriptori i servidor des de Windows 10/Server 2016) - tamb¨¦ disponible com a binari pre-compliat o a les fonts de Áú»¢¶Ä²©
- Linux - disponible als paquets de la distribuci¨® o a les fonts de Áú»¢¶Ä²©Áú»¢¶Ä²© sources
Des de Áú»¢¶Ä²© 6.0.35, els paquets de l'agent 2 de Áú»¢¶Ä²© ja no s¨®n pas disponibles per a perqu¨¨ Go 1.22 (i m¨¦s recent) s¨®n incompatibles amb GCC 4.4.7 proporcionat per RHEL 6, el que provoca errors de compilaci¨®. Tingueu en compte, per¨°, que els paquets d'agent Áú»¢¶Ä²© encara s¨®n compatibles.
±õ²Ô²õ³Ù²¹±ô¡¤±ô²¹³¦¾±¨®
Per instal¡¤lar l'agent Áú»¢¶Ä²© 2, hi ha disponibles les opcions seg¨¹ents:
Windows:
- des d'un binari precompilat: descarregueu el binari i seguiu les directrius generals per instal¡¤lar programari a Windows
- des de fonts - veieu Creaci¨® de l'agent Áú»¢¶Ä²© 2 a Windows
Linux:
- des dels paquets de distribuci¨®: seguiu les instruccions de la p¨¤gina Paquets Áú»¢¶Ä²©, disponible escollint la vostra distribuci¨® i el component Agent 2
- des de les fonts - veieu les instruccions d'onstal¡¤laci¨® des de les fonts; tingueu en compte que heu de configurar les fonts especificant l'opci¨® de configuraci¨®
--enable-agent2
Les capacitats de monitoratge de l'agent 2 de Áú»¢¶Ä²© es poden ampliar amb connectors. Tot i que els plugins integrats s¨®n disponibles per defecte, els plugins carregables s'han d'instal¡¤lar per separat. Per obtindre m¨¦s informaci¨®, veieu Plugins.
Opcions
Els ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs de l¨ªnia de comandes seg¨¹ents es poden emprar amb l'agent Áú»¢¶Ä²© 2:
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|
| -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). |
| -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¨®. |
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
Control 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. Suportat des de Áú»¢¶Ä²© 6.0.2. |
| Connectors | Els connectors poden tindre els seus propis ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs, en format Connectors.<Nom del connector>.<±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð>=<valor>. Un ±è²¹°ù¨¤³¾±ð³Ù°ù±ð de connector 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
A partir de la versi¨® 4.4.8, 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.