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ģents 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ļš ir jānorāda Zabbix aģents 2 konfigurācijas faila parametrā Include.

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

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

Papildus tam 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 lielo sākumburtu
• parametram jābūt rakstītam ar lielo sākumburtu
• speciālās rakstzīmes nav atļautas
• ligzdošanas līmenim nav noteikts maksimālais ierobežojums
• parametru skaits nav ierobežots

Piemēram, lai tikai Uptime spraudnim veiktu aktīvās pārbaudes, kurām uzreiz pēc aģents restartēšanas nav Scheduling atjaunināšanas intervāla, konfigurācijas failā](/manual/concepts/agent2/agent2_params) iestatiet Plugins.Uptime.System.ForceActiveChecksOnStart=1. Līdzīgi, lai CPU spraudnim iestatītu pielāgotu vienlaicīgo pārbaužu limitu, konfigurācijas failā](/manual/concepts/agent2/agent2_params) 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 reprezentē papildu spraudņa parametru līmeni, 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 vienuma atslēgas parametru, nevis norādīt URI, lietotājvārdu un/vai paroli atsevišķi.

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

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

Ir iespējams pārrakstīt sesijas parametrus, norādot jaunās vērtības vienuma atslēgas parametros (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ā.

Parametru prioritāte

Zabbix aģents 2 spraudņi savienojuma parametru vērtības meklē šā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 vākš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 apkopošanu no vairākām instancēm vienlaikus. Var uzraudzīt gan lokālās, gan attālās instances. Tiek atbalstīti TCP un Unix ligzdas savienojumi.

Ieteicams konfigurēt spraudņus tā, lai savienojumi ar instancēm tiktu uzturēti atvērtā stāvoklī. Ieguvumi ir mazāka tīkla pārslodze, latentums, kā arī CPU un atmiņas patēriņš, jo tiek izmantots mazāks savienojumu skaits. Par to rūpējas klienta bibliotēka.