Konfigurācijas parametri: spraudņi

Skatiet Zabbix aģents 2 spraudņu konfigurācijas parametrus:

• Ceph spraudnis
• Docker spraudnis
• Ember+ spraudnis
• Memcached spraudnis
• Modbus spraudnis
• MongoDB spraudnis
• MQTT spraudnis
• MSSQL spraudnis
• MySQL spraudnis
• NVIDIA GPU spraudnis
• Oracle spraudnis
• PostgreSQL spraudnis
• Redis spraudnis
• S.M.A.R.T. spraudnis

Spraudņu konfigurācijas principi

Šajā lapā aprakstīti spraudņu konfigurācijas principi un labākā prakse.

Visi spraudņi tiek konfigurēti, izmantojot parametru Plugins.*, kas var būt daļa no Zabbix aģenta 2 konfigurācijas faila vai spraudņa konfigurācijas faila. Ja spraudnis izmanto atsevišķu konfigurācijas failu, ceļš uz šo failu jānorāda Zabbix aģenta 2 konfigurācijas faila parametram Include.

Tipiskam spraudņa parametram ir šāda struktūra:

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

Turklāt pastāv divas īpašas parametru grupas:

• Plugins.<PluginName>.Default.<Parameter>=<Value> tiek izmantots, lai definētu noklusējuma parametru vērtības.

• Plugins.<PluginName>.<SessionName>.<Parameter>=<Value> tiek izmantots, lai definētu atsevišķas parametru kopas dažādiem uzraudzības mērķiem, izmantojot nosauktas sesijas.

Visiem parametru nosaukumiem jāatbilst šādām prasībām:

• Ieteicams spraudņu nosaukumus rakstīt ar lielo sākumburtu.
• Parametram jāsākas ar lielo burtu.
• Speciālās rakstzīmes nav atļautas.
• Ligzdošanas līmeņu maksimālais skaits nav ierobežots.
• Parametru skaits nav ierobežots.

Piemēram, lai veiktu aktīvās pārbaudes, kurām tūlīt pēc aģenta restartēšanas nav Scheduling atjaunināšanas intervāla, tikai Uptime spraudnim konfigurācijas failā konfigurācijas failā iestatiet Plugins.Uptime.System.ForceActiveChecksOnStart=1.

Līdzīgi, lai CPU spraudnim iestatītu pielāgotu vienlaicīgo pārbaužu ierobežojumu, konfigurācijas failā iestatiet Plugins.CPU.System.Capacity=N.

Noklusējuma vērtības

Savienojuma parametru (URI, lietotājvārda, paroles u. c.) noklusējuma vērtības var iestatīt konfigurācijas failā, izmantojot šādu formātu:

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

Piemēram, Plugins.Mysql.Default.Username=zabbix, Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017 u. c.

Ja šāda parametra vērtība nav norādīta vienuma atslēgā vai nosauktās sesijas parametros, spraudnis izmantos noklusējuma vērtību. Ja arī noklusējuma parametrs nav definēts, tiks izmantotas kodā iekļautās noklusējuma vērtības.

Nosauktās sesijas

Nosauktās sesijas ir papildu spraudņa parametru līmenis, un tās var izmantot, lai norādītu atsevišķus autentifikācijas parametru kopumus katram no uzraudzītajiem instancēm. Katram nosauktās sesijas parametram jābūt šādai struktūrai:

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

Sesijas nosaukumu var izmantot kā connString vienums atslēgas parametru, nevis atsevišķi norādot URI, lietotājvārdu un/vai paroli.

Vienums atslēgās pirmais parametrs var būt vai nu connString, vai URI. Ja pirmais atslēgas parametrs neatbilst nevienam sesijas nosaukumam, tas tiks apstrādāts kā URI. Ņemiet vērā, ka iegultu URI akreditācijas datu nodošana vienums atslēgā netiek atbalstīta; tā vietā izmantojiet nosauktās sesijas parametrus.

Pieejamo nosaukto sesijas parametru saraksts ir atkarīgs no spraudņa.

Sesijas parametrus ir iespējams pārrakstīt, vienums atslēgas parametros norādot jaunas vērtības (skatiet piemēru).

Ja parametrs nav definēts nosauktajai sesijai, Zabbix aģents 2 izmantos vērtību, kas definēta noklusējuma spraudņa parametrā.

Parametra prioritāte

Zabbix aģents 2 spraudņi meklē ar savienojumu saistīto parametru vērtības šādā secībā:

1. Pirmais vienuma atslēgas parametrs tiek salīdzināts ar sesiju nosaukumiem. Ja atbilstība netiek atrasta, tas tiek uzskatīts par faktisku vērtību; šajā gadījumā 3. solis tiks izlaists. Ja atbilstība tiek atrasta, parametra vērtībai (parasti URI) jābūt definētai nosauktajā sesijā.
2. Pārējie parametri tiks ņemti no vienuma atslēgas, ja tie ir definēti.
3. Ja vienuma atslēgas parametrs (piemēram, parole) ir tukšs, spraudnis meklēs atbilstošo nosauktās sesijas parametru.
4. Ja sesijas parametrs arī nav norādīts, tiks izmantota atbilstošajā noklusējuma parametrā definētā vērtība.
5. Ja nekas cits nepalīdz, spraudnis izmantos cieti kodēto noklusējuma vērtību.

Piemērs 1

Divu instanču "MySQL1" un "MySQL2" uzraudzība.

Konfigurācijas parametri:

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.1:3306
Plugins.Mysql.Sessions.MySQL2.User=mysql2_user
Plugins.Mysql.Sessions.MySQL2.Password=different_password

Šīs konfigurācijas rezultātā katru sesijas nosaukumu var izmantot kā connString vienuma atslēgā, piemēram, mysql.ping[MySQL1] vai mysql.ping[MySQL2].

Piemērs 2

Dažu parametru norādīšana vienuma atslēgā.

Konfigurācijas parametri:

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

Vienuma atslēga: pgsql.ping[session1,new_username,,postgres]

Šīs konfigurācijas rezultātā aģents izveidos savienojumu ar PostgreSQL, izmantojot šādus parametrus:

• URI no sesijas parametra: 192.0.2.234:5432
• Lietotājvārds no vienuma atslēgas: new_username
• Parole no sesijas parametra (jo tā vienuma atslēgā ir izlaista): session_password
• Datubāzes nosaukums no vienuma atslēgas: postgres

Piemērs 3

Metrikas apkopošana, izmantojot noklusējuma konfigurācijas parametrus.

Konfigurācijas parametri:

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

Vienuma atslēga: pgsql.ping[,,,postgres]

Šīs konfigurācijas rezultātā aģents izveidos savienojumu ar PostgreSQL, izmantojot šādus parametrus:

• Noklusējuma URI: 192.0.2.234:5432
• Noklusējuma lietotājvārds: zabbix
• Noklusējuma parole: password
• Datubāzes nosaukums no vienuma atslēgas: postgres

Savienojumi

Daži spraudņi atbalsta metrikas vākšanu no vairākiem instancēm vienlaikus. Var uzraudzīt gan lokālās, gan attālās instances. Tiek atbalstīti TCP un Unix-socket savienojumi.

Ieteicams konfigurēt spraudņus tā, lai savienojumi ar instancēm tiktu uzturēti atvērtā stāvoklī. Tas sniedz priekšrocības, samazinot tīkla noslodzi, latentumu, kā arī CPU un atmiņas izmantošanu, jo tiek izmantots mazāks savienojumu skaits. Par to rūpējas klienta bibliotēka.