6 MongoDB spraudnis

Pārskats

Zabbix aģents 2 konfigurācijas fails tiek izmantots spraudņu konfigurēšanai. Šie Zabbix aģents 2 konfigurācijas parametri tiek atbalstīti MongoDB spraudņa darbībai.

Ieteicams tos norādīt atsevišķā konfigurācijas failā (piem., mongo.conf) un pēc tam izmantot direktīvu Include, lai pievienotu šo failu Zabbix aģents 2 konfigurācijai.

MongoDB spraudnis ir ielādējams spraudnis, un tas ir pieejams un pilnībā aprakstīts MongoDB spraudņa repozitorijā.

Ņemiet vērā:

  • Noklusējuma vērtības atspoguļo procesa noklusējuma iestatījumus, nevis vērtības piegādātajos konfigurācijas failos.
  • Vērtības atbalsta vides mainīgos.
  • Zabbix atbalsta konfigurācijas failus tikai UTF-8 kodējumā bez BOM.
  • Komentāri, kas sākas ar "#", tiek atbalstīti tikai rindas sākumā.

Opcijas

Parameter Description
-V --version Izdrukāt spraudņa versiju un licences informāciju.
-h --help Izdrukāt palīdzības informāciju (saīsināti).
-t, --test <item key> Palaist spraudni testēšanai (spraudņa konfigurācija tiek ignorēta).

Parametri

Savienojoties ar MongoDB, spraudnis pārbauda savu konfigurāciju noteiktā secībā, kas nosaka, kura vērtība tiks izmantota. Secība no augstākās līdz zemākajai prioritātei ir šāda:

  1. Parametri, kas norādīti savienojuma URI (piem., vaicājuma parametri, kas definēti aiz ? sadaļā Plugins.MongoDB.Sessions.<session_name>.Uri, ir ar visaugstāko prioritāti).
  2. Parametri Zabbix aģenta 2 vienuma atslēgā (piem., mongodb.collection.stats).
  3. Parametri, kas definēti nosauktā sesijā (piem., Plugins.MongoDB.Sessions.<SessionName>.User, Plugins.MongoDB.Sessions.<SessionName>.Password).
  4. Noklusējuma vērtības (piem., Plugins.MongoDB.Default.User, Plugins.MongoDB.Default.Password).

Piemēram:

  • Ja autentificēšanās savienojumam ar MongoDB serveri datubāzi norādāt parametrā *.<SessionName>.Uri (piem., Plugins.MongoDB.Sessions.<session_name>.Uri=mongodb://user:[email protected]:27017/?authSource=admin), tad spraudnis uzskatīs, ka parametrs *.<SessionName>.AuthSource ir iestatīts uz admin, pat ja parametrs *.<SessionName>.AuthSource ir iestatīts uz citu vērtību.
  • Ja norādāt URI parametrā *.<SessionName>.Uri (piem., Plugins.MongoDB.Sessions.<session_name>.Uri=mongodb://127.0.0.1:27017), bet lietotājvārdu un paroli norādāt Zabbix aģenta 2 vienuma atslēgā, spraudnis izmantos lietotājvārdu un paroli no vienuma atslēgas, pat ja ir konfigurēti Plugins.MongoDB.Sessions.<SessionName>.User un Plugins.MongoDB.Sessions.<SessionName>.Password.

Ja tiek izmantota shēma mongodb+srv://, URI var iegūt parametrus no DNS TXT ieraksta. No šī TXT ieraksta iegūtie parametri pārraksta visas pārējās konfigurācijas, tostarp URI parametrus, Zabbix Agent 2 vienuma atslēgas parametrus un sesijas parametrus.
Savienojuma virknē izmantotajam resursdatora nosaukumam drīkst būt tikai viens TXT ieraksts.

Parameter Mandatory Range Default Description
Plugins.MongoDB.System.Path no MongoDB spraudņa izpildāmā faila ceļš.
Lietošanas piemērs: Plugins.MongoDB.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mongodb
Plugins.MongoDB.Timeout no 1-30 global timeout Pieprasījuma izpildes noildze (laiks sekundēs, cik ilgi gaidīt pieprasījuma pabeigšanu pirms tā pārtraukšanas).
Plugins.MongoDB.KeepAlive no 60-900 300 Maksimālais gaidīšanas laiks (sekundēs) pirms neizmantotie spraudņa savienojumi tiek slēgti.
Plugins.MongoDB.Sessions.<SessionName>.Uri no tcp://127.0.0.1:27017 Nosauktas sesijas savienojuma virkne.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.

Jāatbilst URI formātam.
Atbalstītās shēmas: mongodb:// un mongodb+srv://; shēma tcp:// ir novecojusi un saglabāta atpakaļsavietojamībai ar esošajām konfigurācijām.
Portu var nenorādīt (noklusējums=27017).
Piemēri: mongodb://127.0.0.1:27017, mongodb+srv://example.com, localhost.
Plugins.MongoDB.Sessions.<SessionName>.User no Nosauktas sesijas lietotājvārds.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.
Plugins.MongoDB.Sessions.<SessionName>.Password no Nosauktas sesijas parole.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.
Plugins.MongoDB.Sessions.<SessionName>.Direct no false Savienojuma metode, ko izmanto, lai noteiktu, vai MongoDB replica set mezglu automātiskā noteikšana ir jāiespējo vai jāatspējo.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.

Atbalstītās vērtības:
true - spraudnis savienosies tikai ar norādīto serveri, ignorējot citus replica set dalībniekus;
false - spraudnis automātiski noteiks visus replica set mezglus.
Ja tiek izmantota shēma tcp:// (novecojusi), parametrs pēc noklusējuma tiek iestatīts uz true.
Plugins.MongoDB.Sessions.<SessionName>.AuthMechanism no Autentifikācijas mehānisms savienojumam ar MongoDB serveri.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.

Atbalstītās vērtības: SCRAM-SHA-1, SCRAM-SHA-256 un MONGODB-X509.
Plugins.MongoDB.Sessions.<SessionName>.AuthSource no admin Datubāze autentificēšanai savienojumam ar MongoDB serveri.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.

Ja tiek izmantots autentifikācijas mehānisms MONGODB-X509, šis parametrs automātiski tiek iestatīts uz $external; tā modificēšana uz jebkuru citu vērtību izraisīs kļūdu palaišanas laikā.
Plugins.MongoDB.Sessions.<SessionName>.ReplicaSet no Replica set nosaukums, ko izmanto MongoDB replica set mezglu automātiskai noteikšanai.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.

Ja šis parametrs tiek izmantots kopā ar shēmu mongodb+srv://, tas darbosies tā, it kā būtu norādīti vairāki URL; DNS serverī var būt TXT ieraksts, kas var pārrakstīt šo (vai jebkuru citu) parametru.

Nav pieejams, ja parametrs Plugins.MongoDB.Sessions.<SessionName>.Direct ir iestatīts uz true, aģents neizdosies startēties.
Plugins.MongoDB.Sessions.<SessionName>.ReadPreference no Secība savienojumam ar MongoDB replica set mezgliem vai rezerves mezglu.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.

Atbalstītās vērtības: PrimaryMode, PrimaryPreferredMode, SecondaryMode, SecondaryPreferredMode un NearestMode.
Nav pieejams, ja parametrs Plugins.MongoDB.Sessions.<SessionName>.Direct ir iestatīts uz true, aģents neizdosies startēties.
Plugins.MongoDB.Sessions.<SessionName>.TLSConnect no Šifrēšanas veids saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.

Atbalstītās vērtības:
required - pieprasa TLS savienojumu;
verify\_ca - pārbauda sertifikātus;
verify\_full - pārbauda sertifikātus un IP adresi.

Atbalstīts kopš spraudņa versijas 1.2.1.
Plugins.MongoDB.Sessions.<SessionName>.TLSCAFile yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSConnect is set to one of: verify_ca, verify_full Pilns faila ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudža sertifikāta pārbaudei, ko izmanto šifrētai saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.
Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile is specified Pilns faila ceļš uz failu, kurā ir aģenta sertifikāts vai sertifikātu ķēde, ko izmanto šifrētai saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.
Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile is specified Pilns faila ceļš uz failu, kurā ir datubāzes privātā atslēga, ko izmanto šifrētai saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienuma atslēgās.
Plugins.MongoDB.Default.Uri no tcp://127.0.0.1:27017 Noklusējuma URI savienojumam ar MongoDB.

Jāatbilst URI formātam.
Atbalstītās shēmas: mongodb:// un mongodb+srv://.
Novecojusi shēma: tcp:// (tiek izmantota kā noklusējums atpakaļsavietojamībai ar esošajām konfigurācijām).
Portu var nenorādīt (noklusējums=27017).
Piemēri: mongodb://127.0.0.1:27017, mongodb+srv://example.com, localhost.
Plugins.MongoDB.Default.User no Noklusējuma lietotājvārds savienojumam ar MongoDB.
Plugins.MongoDB.Default.Password no Noklusējuma parole savienojumam ar MongoDB.
Plugins.MongoDB.Default.Direct no false Noklusējuma savienojuma metode, ko izmanto, lai noteiktu, vai MongoDB replica set mezglu automātiskā noteikšana ir jāiespējo vai jāatspējo.

Atbalstītās vērtības:
true - spraudnis savienosies tikai ar norādīto serveri, ignorējot citus replica set dalībniekus;
false - spraudnis automātiski noteiks visus replica set mezglus.
Ja tiek izmantota shēma tcp:// (novecojusi), parametrs pēc noklusējuma tiek iestatīts uz true.
Plugins.MongoDB.Default.AuthMechanism no Noklusējuma autentifikācijas mehānisms savienojumam ar MongoDB serveri.

Atbalstītās vērtības: SCRAM-SHA-1, SCRAM-SHA-256 un MONGODB-X509.
Ja šeit, vienuma atslēgā, nosauktā sesijā vai URI nav norādīta vērtība, tiks izmantots uz SCRAM balstīts mehānisms (ja ir norādīts lietotājvārds; pretējā gadījumā autentifikācija netiks izmantota).
Plugins.MongoDB.Default.AuthSource no admin Noklusējuma datubāze autentificēšanai savienojumam ar MongoDB serveri.

Ja tiek izmantots autentifikācijas mehānisms MONGODB-X509, šis parametrs automātiski tiek iestatīts uz $external; tā modificēšana uz jebkuru citu vērtību izraisīs kļūdu palaišanas laikā.
Plugins.MongoDB.Default.ReplicaSet no Noklusējuma replica set nosaukums; tiek izmantots MongoDB replica set mezglu automātiskai noteikšanai.

Ja šis parametrs tiek izmantots kopā ar shēmu mongodb+srv://, tas darbosies tā, it kā būtu norādīti vairāki URL; DNS serverī var būt TXT ieraksts, kas var pārrakstīt šo (vai jebkuru citu) parametru.
Nav pieejams, ja parametrs Plugins.MongoDB.Default.Direct ir iestatīts uz true, aģents neizdosies startēties.
Plugins.MongoDB.Default.ReadPreference no Noklusējuma secība savienojumam ar MongoDB replica set mezgliem vai rezerves mezglu.

Atbalstītās vērtības: PrimaryMode, PrimaryPreferredMode, SecondaryMode, SecondaryPreferredMode un NearestMode.
Nav pieejams, ja parametrs Plugins.MongoDB.Default.Direct ir iestatīts uz true, aģents neizdosies startēties.
Plugins.MongoDB.Default.TLSConnect no Noklusējuma šifrēšanas veids saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.

Atbalstītās vērtības:
required - pieprasa TLS savienojumu;
verify\_ca - pārbauda sertifikātus;
verify\_full - pārbauda sertifikātus un IP adresi.
Ja šeit, vienuma atslēgā, nosauktā sesijā vai URI nav norādīta vērtība, TLS savienojums netiks izveidots.
Plugins.MongoDB.Default.TLSCAFile no Noklusējuma faila ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudža sertifikāta pārbaudei. Izmanto šifrētai saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.
Plugins.MongoDB.Default.TLSCertFile no Noklusējuma faila ceļš uz failu, kurā ir MongoDB klienta sertifikāts vai sertifikātu ķēde. Izmanto šifrētai saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.
Plugins.MongoDB.Default.TLSKeyFile no Noklusējuma faila ceļš uz failu, kurā ir MongoDB klienta privātā atslēga, ko izmanto šifrētai saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.

Skatiet arī: