MongoDB spraudnis

Pārskats

Konfigurācijas parametri ļauj pielāgot MongoDB spraudņa darbību.

Ieteicams tos norādīt atsevišķā konfigurācijas failā (piem., mongodb.conf), nevis aģenta 2 konfigurācijas failā. Pēc tam izmantojiet direktīvu Include, lai iekļautu šo failu Zabbix aģenta 2 konfigurācijā.

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

Visi parametri ir neobligāti, ja vien nav skaidri norādīts, ka parametrs ir obligāts.

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 ? 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 datubāzi savienojumam ar MongoDB serveris 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.

Šī lapa ir strukturēta šādi:

• Parametru pārskats (lai skatītu pilnu parametra informāciju, noklikšķiniet uz tā nosaukuma)
• Parametru detaļas

Ņemiet vērā:

• Noklusējuma vērtības atspoguļo procesa noklusē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ā.

Parametra informācija

Plugins.MongoDB.Default.AuthMechanism

Norādiet noklusējuma autentifikācijas mehānismu savienojumam ar MongoDB serveri.
<SessionName> - definē sesijas nosaukumu izmantošanai vienumu atslēgās.

Diapazons: SCRAM-SHA-1, SCRAM-SHA-256 vai MONGODB-X509

Plugins.MongoDB.Default.AuthSource

Norādiet noklusējuma datubāzi autentifikācijai, veidojot savienojumu ar MongoDB serveri.
<SessionName> - definē sesijas nosaukumu izmantošanai vienumu atslēgās.

Noklusējums: admin

Ja tiek izmantots MONGODB-X509 autentifikācijas mehānisms, š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.Direct

Atspējot MongoDB replica set mezglu automātisko noteikšanu.
<SessionName> - definē sesijas nosaukumu izmantošanai vienumu atslēgās.

Noklusējums: false
Diapazons: true - izveidot savienojumu tikai ar norādīto serveri, ignorējot citus replica set dalībniekus, false - automātiski noteikt visus replica set mezglus.

Ja tiek izmantota tcp:// (novecojusi) shēma, parametrs pēc noklusējuma tiek iestatīts uz true.

Plugins.MongoDB.Default.Password

Norādiet noklusējuma paroli.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.

Plugins.MongoDB.Default.ReplicaSet

Norādiet noklusējuma replica set nosaukumu, ko izmanto MongoDB replica set mezglu automātiskai atklāšanai.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.
Ja šis parametrs tiek izmantots kopā ar mongodb+srv:// shēmu, tas darbosies tā, it kā būtu norādīti vairāki URL; DNS serverim var būt TXT ieraksts, kas var pārrakstīt šo (vai jebkuru citu) parametru.
Nav pieejams, ja ir iestatīts parametrs Plugins.MongoDB.Sessions.<SessionName>.Direct uz true; aģents neizdosies startēties.

Plugins.MongoDB.Default.ReadPreference

Norādiet noklusējuma secību savienojuma izveidei ar MongoDB replica set mezgliem vai rezerves variantu.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.
Nav pieejams, ja parametrs Plugins.MongoDB.Sessions.<SessionName>.Direct ir iestatīts uz true; aģents neizdosies startēties.

Diapazons: PrimaryMode, PrimaryPreferredMode, SecondaryMode, SecondaryPreferredMode vai NearestMode

Plugins.MongoDB.Default.TLSConnect

Norādiet šifrēšanas līmeni, kas nepieciešams saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm.
<SessionName> - definē sesijas nosaukumu, ko izmantot vienumu atslēgās.
Atbalstīts kopš spraudņa versijas 1.2.1.

Diapazons: required - pieprasīt TLS savienojumu, verify_ca - pārbaudīt sertifikātus, verify_full - pārbaudīt sertifikātus un IP adresi

Plugins.MongoDB.Default.TLSCAFile

Norādiet pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudža sertifikāta verifikācijai, ko izmanto šifrētai saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm.
<SessionName> - definē sesijas nosaukumu izmantošanai vienumu atslēgās.

Obligāti: yes, ja Plugins.MongoDB.Sessions.<SessionName>.TLSConnect ir iestatīts uz verify_ca vai verify_full

Plugins.MongoDB.Default.TLSCertFile

Norādiet pilnu ceļu uz failu, kurā atrodas aģenta sertifikāts vai sertifikātu ķēde, kas tiek izmantota šifrētai saziņai starp Zabbix agent 2 un uzraudzītajām datubāzēm.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.

Obligāti: yes, ja ir norādīts Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile

Plugins.MongoDB.Default.TLSKeyFile

Norādiet pilnu ceļu uz failu, kurā atrodas datubāzes privātā atslēga, kas tiek izmantota šifrētai saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.

Obligāti: yes, ja ir norādīts Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile

Plugins.MongoDB.Default.Uri

Norādiet noklusējuma URI.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.
Tam 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: ``

Noklusējums: tcp://127.0.0.1:27017

Piemēri:

mongodb://127.0.0.1:27017
mongodb+srv://example.com
localhost

Plugins.MongoDB.Default.User

Norādiet noklusējuma lietotājvārdu.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.

Plugins.MongoDB.KeepAlive

Iestatiet maksimālo gaidīšanas laiku (sekundēs) pirms neizmantotie spraudņa savienojumi tiek slēgti.

Noklusējums: 300
Diapazons: 60-900

Plugins.MongoDB.Sessions.<SessionName>.AuthMechanism

Norādiet nosauktās sesijas autentifikācijas mehānismu savienojumam ar MongoDB serveri.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.

Diapazons: SCRAM-SHA-1, SCRAM-SHA-256 vai MONGODB-X509

Plugins.MongoDB.Sessions.<SessionName>.AuthSource

Norādiet nosauktās sesijas datubāzi, kas tiks izmantota autentifikācijai, veidojot savienojumu ar MongoDB serveri.
<SessionName> - norādiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Noklusējums: admin

Ja tiek izmantots MONGODB-X509 autentifikācijas mehānisms, š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>.Direct

Atspējot MongoDB replica set mezglu automātisko noteikšanu nosauktajai sesijai.
<SessionName> - definē sesijas nosaukumu izmantošanai vienumu atslēgās.

Noklusējums: false
Diapazons: true - izveidot savienojumu tikai ar norādīto serveri, ignorējot citus replica set dalībniekus, false - automātiski noteikt visus replica set mezglus.

Ja tiek izmantota tcp:// (novecojusi) shēma, parametrs pēc noklusējuma tiek iestatīts uz true.

Plugins.MongoDB.Sessions.<SessionName>.Password

Norādiet nosauktās sesijas paroli.
<SessionName> - norādiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Plugins.MongoDB.Sessions.<SessionName>.ReplicaSet

Norādiet nosauktās sesijas replica set nosaukumu, ko izmanto MongoDB replica set mezglu automātiskai atklāšanai.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.
Ja šis parametrs tiek izmantots kopā ar mongodb+srv:// shēmu, tas darbosies tā, it kā būtu norādīti vairāki URL; DNS serverim 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ēt.

Plugins.MongoDB.Sessions.<SessionName>.ReadPreference

Norādiet nosauktās sesijas secību, lai izveidotu savienojumu ar MongoDB replica set mezgliem vai izmantotu rezerves variantu.
<SessionName> - definē sesijas nosaukumu izmantošanai vienumu atslēgās.
Nav pieejams, ja ir iestatīts parametrs Plugins.MongoDB.Sessions.<SessionName>.Direct uz true; aģents neizdosies startēties.

Diapazons: PrimaryMode, PrimaryPreferredMode, SecondaryMode, SecondaryPreferredMode vai NearestMode

Plugins.MongoDB.Sessions.<SessionName>.TLSConnect

Norādiet šifrēšanas līmeni, kas nepieciešams saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm norādītajai sesijai.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.
Atbalstīts kopš spraudņa versijas 1.2.1.

Diapazons: required - pieprasīt TLS savienojumu, verify_ca - pārbaudīt sertifikātus, verify_full - pārbaudīt sertifikātus un IP adresi

Plugins.MongoDB.Sessions.<SessionName>.TLSCAFile

Norādiet pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudža sertifikāta verifikācijai, kas tiek izmantota šifrētai saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm norādītajai sesijai.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.

Obligāti: yes, ja Plugins.MongoDB.Sessions.<SessionName>.TLSConnect ir iestatīts uz verify_ca vai verify_full

Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile

Norādiet pilnu faila ceļu uz failu, kas satur aģenta sertifikātu vai sertifikātu ķēdi, ko izmanto šifrētai saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm norādītajai sesijai.
<SessionName> - definē sesijas nosaukumu, ko izmantot vienumu atslēgās.

Obligāti: yes, ja ir norādīts Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile

Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile

Norādiet pilnu ceļu uz failu, kurā atrodas datubāzes privātā atslēga, kas tiek izmantota šifrētai saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm norādītajai sesijai.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Obligāti: yes, ja ir norādīts Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile

Plugins.MongoDB.Sessions.<SessionName>.Uri

Norādiet nosauktās sesijas URI.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.
Tam jāatbilst URI formātam.
Atbalstītās shēmas: mongodb:// un mongodb+srv://; tcp:// shēma 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: ``

Noklusējums: tcp://127.0.0.1:27017

Piemēri:

mongodb://127.0.0.1:27017
mongodb+srv://example.com
localhost

Plugins.MongoDB.Sessions.<SessionName>.User

Norādiet nosauktās sesijas lietotājvārdu.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.

Plugins.MongoDB.System.Path

Norādiet MongoDB spraudņa izpildāmā faila ceļu.

Lietošanas piemērs: Plugins.MongoDB.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mongodb

Plugins.MongoDB.Timeout

Iestatiet pieprasījuma izpildes noildzi (ilgumu sekundēs, cik ilgi gaidīt, līdz pieprasījums tiks pabeigts, pirms to pārtrauc).

Noklusējums: global timeout
Diapazons: 1-30

Opcijas

Skatiet arī

• Vispārīgo Zabbix aģenta 2 konfigurācijas parametru apraksts: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
• Norādījumi spraudņu konfigurēšanai