2 Plugins

Vista general

Els connectors ofereixen una opció per ampliar les capacitats de monitoratge de Zabbix. Els connectors són escrits en llenguatge de programació Go i només són compatibles amb l'agent 2 de Zabbix. Els connectors proporcionen una alternativa als mòduls carregables (escrits en C) i altres mètodes per ampliar la funcionalitat de Zabbix.

Les funcions següents són específiques de l'agent 2 i els seus connectors:

• suport d'intervals programats i flexibles per a controls passius i actius;
• gestió de la cua de tasques pel que fa a la planificació i la concurrència de tasques;
• temps d'espera a nivell de connector;
• comprovació de compatibilitat de l'agent Zabbix 2 i els seus connectors a l'inici.

Des de Zabbix 6.0.0, els connectors no s'han d'integrar directament a l'agent 2 i es poden afegir com a connectors carregables, facilitant així el procés de creació de connectors addicionals per recollir noves mètriques de monitoratge.

Aquesta pàgina llista els connectors natius i carregables de Zabbix i es descriuen els principis de configuració dels connectors des de la perspectiva de l'usuari.

Per obtindre instruccions i tutorials sobre com escriure els vostres propis connectors, consulteu Centre de desenvolupadors.

Per obtindre més informació sobre el procés de comunicació entre l'agent Zabbix 2 i un connector carregable, així com sobre el procés de recollida de mètriques, veieu Diagrama de connexió.

Configurar plugins

Aquesta secció proporciona principis comuns de configuració de connectors i pràctiques recomanades.

Tots els connectors es configuren mitjançant el paràmetre Plugins.*, que pot formar part de l'agent de Zabbix 2 fitxer de configuració o del fitxer de configuració propi d'un connector /config/zabbix_agent2_plugins). Si un connector empra un fitxer de configuració independent, la ruta d'aquest fitxer s'ha d'especificar al paràmetre Include del fitxer de configuració de l'agent Zabbix 2.

Un paràmetre de connector típic té l'estructura següent:

Plugins.<PluginName>.<Parameter>=<Value>

A més, hi ha dos grups específics de paràmetres:

• Plugins.<PluginName>.Default.<Parameter>=<Value> emprat per definir valors dels paràmetres per defecte.

• Plugins.<PluginName>.<SessionName>.<Parameter>=<Value> s'empra per definir conjunts separats de paràmetres per a diferents objectius de monitoratge mitjançant sessions nomenades.

Tots els noms de paràmetre han de complir els requisits següents:

• es recomana posar en majúscula els noms dels vostres connectors;
• el paràmetre s'ha de posar en majúscula;
• No es permeten caràcters especials;
• la nidificació no és limitada per un nivell màxim;
• el nombre de paràmetres no és limitat.

Per exemple, per fer comprovacions actives que no tinguin Programació interval d'actualització just després de reiniciar l'agent només per al connector Uptime, establiu Plugins.Uptime.System.ForceActiveChecksOnStart=1 al fitxer de configuració. De la mateixa manera, per establir un límit personalitzat per a comprovacions concurrents per al connector de la CPU, establiu Plugins.CPU.System.Capacity=N al fitxer de configuració.

Valors per defecte

Des de Zabbix 6.4.3, podeu establir els valors per defecte per als paràmetres relatius a les connexions (URI, usuari, mot de pas, etc.) a l'arxiu de configuració, en aquest format:

Plugins.<PluginName>.Default.<Parameter>=<Value>

Per exemple, Plugins.Mysql.Default.Username=zabbix, Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017, etc.

Si no es proporciona un valor de cada paràmetre a una clau d'element dels paràmetres de la sessió anomenada, el plugin emprarà el valor per defecte. Si algun paràmetre no s'ha definit, s'empraran els valors en brut.

Sessions nomenades

Les sessions amb nom representen un nivell addicional de paràmetres de connectors i es poden emprar per especificar conjunts separats de paràmetres d'autenticació per a cadascuna de les instàncies que es siguin monitorant. Cada paràmetre de sessió anomenada hauria de tindre l'estructura següent:

Plugins.<PluginName>.Sessions.<SessionName>.<Parameter>=<Value>

Un nom de sessió es pot emprar com a paràmetre de clau d'element connString en lloc d'especificar un URI, un nom d'usuari i/o un mot de pas per separat.

A les claus d'element, el primer paràmetre pot ser un connString o un URI. Si el primer paràmetre de clau no coincideix amb cap nom de sessió, es tractarà com un URI. Tingueu en compte que no s'admet incrustar credencials en un URI, feu servir paràmetres de sessió amb nom.

La llista de [paràmetres de sessió anomenats] disponibles (/manual/appendix/config/zabbix_agent2_plugins) depèn del connector.

A les versions 6.4.0-6.4.2 de Zabbix, quan es proporciona una connString (nom de sessió) als paràmetres clau, els paràmetres clau de l'element per al nom d'usuari i el mot de pas han de ser buits. Els valors es prendran dels paràmetres de sessió. Si no s'especifica un paràmetre d'autenticació per a la sessió anomenada, s'emprarà un valor predeterminat codificat en cru.

Des de Zabbix 6.4.2, és possible anul·lar els paràmetres de sessió especificant nous valors als paràmetres clau de l'element (veieu exemple).

Des de Zabbix 6.4.3, si no es defineix un paràmetre per a la sessió anomenada, l'agent Zabbix 2 emprarà el valor definit al paràmetre del connector predeterminat.

Parameter priority

Zabbix agent 2 plugins search for connection-related parameter values in the following order:

1. The first item key parameter is compared to session names. If no match is found, it is treated as an actual value; in this case, step 3 will be skipped. If a match is found, the parameter value (usually, a URI) must be defined in the named session.
2. Other parameters will be taken from the item key if defined.
3. If an item key parameter (for example, password) is empty, plugin will look for the corresponding named session parameter.
4. If the session parameter is also not specified, the value defined in the corresponding default parameter will be used.
5. If all else fails, the plugin will use the hardcoded default value.

Exemple 1

Monitoratge de dues instàncies “MySQL1” i “MySQL2”.

Paràmetres de configuració:

Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306
       Plugins.Mysql.Sessions.MySQL1.User=mysql1_user
       Plugins.Mysql.Sessions.MySQL1.Password=unique_password
       Plugins.Mysql.Sessions.MySQL2.Uri=tcp://192.0.2.0:3306
       Plugins.Mysql.Sessions.MySQL2.User=mysql2_user
       Plugins.Mysql.Sessions.MySQL2.Password=different_password

Com a resultat d'aquesta configuració, cada nom de sessió es pot emprar com a connString a una clau d'element, com ara mysql.ping[MySQL1] o mysql .ping[MySQL2].

Exemple 2

Proporcionant alguns paràmetres a la clau d'element (admès des de Zabbix 6.4.2).

Paràmetres de configuració:

Plugins.Postgres.Sessions.Session1.Uri=tcp://192.0.2.234:5432
       Plugins.Postgres.Sessions.Session1.User=old_username
       Plugins.Postgres.Sessions.Session1.Password=session_password

Clau d'element: pgsql.ping[session1,new_username,,postgres]

Com a resultat de la configuració, l'agent es connectarà a PostgreSQL emprant els paràmetres següents:

• Paràmetre URI de la sessió: 192.0.2.234:5432
• Usuari de la clau d'element: new_username
• Mot de pas del paràmetre de la sessió (des que s'ha omès a la clau d'element): session_password
• Nom de la base de dades per la clau d'element: postgres

Exemple 3

Recollint una mètrica emprant els paràmetres de configuració per defecte. Paràmetres de configuració:

Plugins.Postgres.Default.Uri=tcp://192.0.2.234:5432
       Plugins.Postgres.Default.User=zabbix
       Plugins.Postgres.Default.Password=password

Clau d'element: pgsql.ping[,,,postgres]

Com a resultat de la configuració, l'agent es connectarà a PostgreSQL emprant els paràmetres següents:

• URI per defecte: 192.0.2.234:5432
• Usuari per defecte: zabbix
• Mot de pas per defecte: password
• Nom de la base de dades per la clau d'element: postgres

Connexions

Alguns connectors admeten la recollida de mètriques de diverses instàncies simultàniament. Es poden controlar tant les instàncies locals com les remotes. S'admeten tant les connexions de socket TCP com Unix.

Es recomana configurar connectors per mantindre les connexions d'instància en estat obert. Els avantatges són la reducció de la congestió de la xarxa, la latència i l'ús de la CPU i la memòria a causa de menys connexions. La biblioteca del client s'encarrega d'això.

Plugins

Totes les mètriques admeses per l'agent Zabbix 2 són recollides per els plugins.

Built-in

Els connectors següents per a l'agent Zabbix 2 són disponibles de manera immediata. Feu clic al nom del connector per anar al repositori de connectors amb informació addicional.

Carregable

Feu clic al nom del connector per anar al repositori de connectors amb informació addicional.

Veieu també: Creació de plugins carregables.