2 Spraudņi

Pārskats

Spraudņi paplašina Zabbix aģents 2 uzraudzības iespējas. Tie ir rakstīti Go programmēšanas valodā un nodrošina alternatīvu ielādējamiem moduļiem (rakstītiem C valodā) un citām metodēm Zabbix funkcionalitātes paplašināšanai.

Šīs funkcijas ir specifiskas aģents 2 un tā spraudņiem:

• Plānoti un elastīgi intervāli gan pasīvajām, gan aktīvajām pārbaudēm
• Uzdevumu rindas pārvaldība, ņemot vērā grafiku un uzdevumu vienlaicīgumu
• Spraudņa līmeņa taimauti
• Zabbix aģents 2 un tā spraudņu saderības pārbaude startēšanas laikā

Visi Zabbix aģents 2 atbalstītie metriskie dati tiek savākti ar spraudņu palīdzību. Šajā lapā ir aprakstīti spraudņu konfigurācijas principi no lietotāja skatpunkta, kā arī uzskaitīti gan iebūvētie, gan ielādējamie spraudņi, ko nodrošina Zabbix.

Spraudņu konfigurēšana

Šī sadaļa sniedz vispārīgus spraudņu konfigurēšanas principus un labāko praksi.

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ļš 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 dziļumam nav noteikts maksimālais līmenis
• 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/appendix/config/zabbix_agent2) 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/appendix/config/zabbix_agent2) 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 šādam parametram 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ā 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 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.

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

Ja parametrs nosauktajai sesijai nav definēts, 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 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, password) ir tukšs, spraudnis meklēs atbilstošo nosauktās sesijas parametru.
4. Ja arī sesijas parametrs nav norādīts, tiks izmantota atbilstošajā noklusējuma parametru 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 vākš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-soketa 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 ir mazāks savienojumu skaits. Par to rūpējas klienta bibliotēka.

Iebūvētie spraudņi

Zabbix agent 2 iebūvētie spraudņi ir pieejami uzreiz pēc instalēšanas. Noklikšķiniet uz spraudņa nosaukuma, lai pārietu uz spraudņa repozitoriju ar papildu informāciju.

Ielādējamie spraudņi

Zabbix aģents 2 ielādējamie spraudņi nav pieejami uzreiz pēc noklusējuma un tie jāinstalē atsevišķi:

• Linux vidē varat izmantot pakotnes (piem., instalējiet Ember+ Ubuntu ar apt install zabbix-agent2-plugin-ember-plus) vai izveidot spraudņus
• Windows vidē varat instalēt no MSI vai izveidot spraudņus

Noklikšķiniet uz spraudņa nosaukuma, lai pārietu uz spraudņa repozitoriju, kurā ir spraudņa README fails ar papildu informāciju.