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ņa konfigurācijas principi

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

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

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

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

Papildus ir divas specifiskas parametru grupas:

• Plugins.<PluginName>.Default.<Parameter>=<Value> tiek izmantots noklusējuma parametru vērtību definēšanai.

• Plugins.<PluginName>.<SessionName>.<Parameter>=<Value> tiek izmantots atsevišķu parametru kopu definēšanai dažādiem uzraudzības mērķiem, izmantojot nosauktās sesijas.

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

• Ieteicams spraudņu nosaukumus rakstīt ar lielajiem burtiem.
• Parametram jābūt rakstītam ar lielo burtu.
• Speciālās rakstzīmes nav atļautas.
• Iekļaušanas dziļumam nav noteikts maksimālais līmenis.
• Parametru skaits nav ierobežots.

Piemēram, lai veiktu aktīvās pārbaudes, kurām nav Scheduling atjaunināšanas intervāla uzreiz pēc aģenta restartēšanas tikai Uptime spraudnim, iestatiet Plugins.Uptime.System.ForceActiveChecksOnStart=1 konfigurācijas failā. Līdzīgi, lai CPU spraudnim iestatītu pielāgotu vienlaicīgo pārbaužu limitu, konfigurācijas failā iestatiet Plugins.CPU.System.Capacity=N.

Noklusējuma vērtības

Savienojuma parametriem (URI, lietotājvārds, parole utt.) varat iestatīt noklusējuma vērtības konfigurācijas failā šādā formātā:

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

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

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 iebūvētā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.