14 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 Zabbix 2.

Els connectors ofereixen una alternativa als mòduls carregables (escrits en C) i altres mètodes per ampliar la funcionalitat de Zabbix, com ara paràmeteres d'usuari (agent de mètriques), comprovacions externes (monitoratge sense agent) i l'element de l'agent Zabbix system.run[].

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

• suport per a intervals programats i flexibles per a controls passius i actius;
• gestió de la cua de tasques pel que fa al temps i la concurrència de tasques;
• temps d'espera a nivell de connector;
• Comprovació de compatibilitat de l'agent Zabbix 2 i el seu connector 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ó de connectors des de la perspectiva de l'usuari. Per obtindre instruccions sobre com escriure els vostres propis connectors, consulteu les directrius de desenvolupament de connectors.

Configuració dels plugins

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

Tots els pluginses configuren mitjançant el paràmetre Plugins.*, que pot formar part del fitxer de configuració de l'agent Zabbix 2 o el seu propi fitxer de configuració del plugin. Si un plugin empra un fitxer de configuració independent, el camí d'accés a aquest fitxer s'ha d'especificar al paràmetre inclòs del fitxer de configuració de l'agent Zabbix 2.

Cada paràmetre del plugin ha de tindre l'estructura següent:

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

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

-Plugins.<PluginName>.Default.<Parameter>=<Value> emprat per definir els valors del paràmetre per defecte.

-Plugins.<PluginName>.<SessionName>.<Parameter>=<Value> emprat per definir el joc de paràmetres separats per els objectius a monitorar via les sessions anomenades.

Els noms dels paràmetres han de complir els requisits següents:

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

Sessions anomenades

Les sessions amb nom representen un nivell addicional de configuració del connector i es poden emprar per definir conjunts separats de paràmetres d'autenticació per a cada instància monitorada. Cada paràmetre de sessió anomenada ha 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 un mot de pas per separat. A les claus d'element, el primer paràmetre pot ésser un connString o un URI. Si el primer paràmetre clau coincideix amb un nom de sessió especificat al fitxer de configuració, la comprovació s'executarà mitjançant els paràmetres de sessió indicats. Si el primer paràmetre de clau no coincideix amb cap nom de sessió, es tractarà com a URI.

La llista dels paràmetres de sessions anomenades disponibles depenen del plugin.

A les versions de Zabbix anteriors a la 6.0.17, quan es proporcioni una connString (nom de sessió) als paràmetres clau, els paràmetres clau d'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.0.17, podeu substituir els paràmetres de sessió especificant nous valors als paràmetres clau de l'element. En aquest cas:

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

Prioritat dels paràmetres

Des de la versió 6.4.3, els plugins de l'agent 2 de Zabbix cerquen els valors de paràmetres relatius a les connexions en l'ordre següent:

1. El paràmetre clau del primer element es compara amb els noms de sessió. Si no es troba cap coincidència, es tractarà com un valor real; en aquest cas, s'ometrà el pas 3. Si es troba una coincidència, el valor del paràmetre (normalment, un URI) s'ha de definir a la sessió anomenada.
2. Altres paràmetres es prendran de la clau d'element si està definit.
3. Si un paràmetre de clau d'element (per exemple, mot de pas) és buit, el plugin cercarà el paràmetre de sessió corresponent.
4. Si tampoc s'especifica el paràmetre de sessió, s'emprarà el valor definit al paràmetre predeterminat corresponent.
5. Si tot falla, el plugin emprarà el valor predeterminat codificat en cru.

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.0.17).

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

Valors per defecte

Des de Zabbix 6.0.18, 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.

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.

Per defecte

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

Carregable

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

Veieu també: Creació de connectors carregables.

Nota al peu

¹ - Des de Zabbix 6.0.13, els plugins carregables han començat a emprar el mateix sistema de versionat que el del Zabbix. Per això, la versió del plugin de MongoDB ha canviat d'1.2.0 a 6.0.13 i la versió del plugin de PostgreSQL ha canviat de la 1.2.1 a la 6.0.13.