MSSQL spraudnis

Pārskats

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

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

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

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

Šī lapa ir strukturēta šādi:

  • Parametru pārskats (lai skatītu pilnu parametra informāciju, noklikšķiniet uz tā nosaukuma)
  • Parametru detaļas
Parameter Description
Plugins.MSSQL.CustomQueriesDir Norādiet ceļu uz direktoriju, kurā atrodas lietotāja definētie .sql faili ar pielāgotajiem vaicājumiem, kurus spraudnis var izpildīt.
Plugins.MSSQL.CustomQueriesEnabled Iespējot mssql.custom.query vienums atslēgas izpildi.
Plugins.MSSQL.Default.CACertPath Norādiet noklusējuma faila ceļu uz sertifikātu iestādes (CA) publiskās atslēgas sertifikātu, kas izdevusi MSSQL serveris sertifikātu.
Plugins.MSSQL.Default.Database Norādiet noklusējuma datubāzes nosaukumu.
Plugins.MSSQL.Default.Encrypt Norādiet noklusējuma šifrēšanas līmeni.
Plugins.MSSQL.Default.HostNameInCertificate Norādiet MSSQL serveris sertifikāta vispārīgo nosaukumu (CN) pēc noklusējuma.
Plugins.MSSQL.Default.Password Norādiet noklusējuma paroli.
Plugins.MSSQL.Default.TLSMinVersion Norādiet noklusējuma minimālo TLS versiju.
Plugins.MSSQL.Default.TrustServerCertificate Pēc noklusējuma uzticēties serveris sertifikātam, to nepārbaudot.
Plugins.MSSQL.Default.Uri Norādiet noklusējuma URI.
Plugins.MSSQL.Default.User Norādiet noklusējuma lietotājvārdu.
Plugins.MSSQL.KeepAlive Norādiet maksimālo gaidīšanas laiku (sekundēs) pirms neizmantoto spraudņa savienojumu aizvēršanas.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath Norādiet nosauktās sesijas faila ceļu uz sertifikātu iestādes (CA) publiskās atslēgas sertifikātu, kas izdevusi MSSQL serveris sertifikātu.
Plugins.MSSQL.Sessions.<SessionName>.Database Norādiet nosauktās sesijas datubāzes nosaukumu.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt Norādiet nosauktās sesijas šifrēšanas līmeni.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate Norādiet MSSQL serveris sertifikāta vispārīgo nosaukumu (CN) nosauktajai sesijai.
Plugins.MSSQL.Sessions.<SessionName>.Password Norādiet nosauktās sesijas paroli.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion Norādiet nosauktās sesijas minimālo TLS versiju.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate Uzticēties nosauktās sesijas serveris sertifikātam, to nepārbaudot.
Plugins.MSSQL.Sessions.<SessionName>.Uri Norādiet nosauktās sesijas URI.
Plugins.MSSQL.Sessions.<SessionName>.User Norādiet nosauktās sesijas lietotājvārdu.
Plugins.MSSQL.System.Path Norādiet ceļu uz MSSQL spraudņa izpildfailu.
Plugins.MSSQL.Timeout Iestatiet ilgumu sekundēs, cik ilgi gaidīt serveris atbildi, veidojot pirmo savienojumu un veicot turpmākās darbības sesijā.

Ņemiet vērā:

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

Norādiet ceļu uz direktoriju, kurā atrodas lietotāja definētie .sql faili ar pielāgotajiem vaicājumiem, ko spraudnis var izpildīt.
Spraudnis startēšanas laikā ielādē visus pieejamos .sql failus konfigurētajā direktorijā. Tas nozīmē, ka jebkuras izmaiņas pielāgoto vaicājumu failos netiks atspoguļotas, līdz spraudnis tiks restartēts. Spraudnis tiek palaists un apturēts kopā ar Zabbix aģents 2.

Noklusējums:
/usr/local/share/zabbix/custom-queries/mssql - Unix sistēmām,
*:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL - Windows sistēmām (kur * ir diska nosaukums no ProgramFiles vides mainīgā)

Plugins.MSSQL.CustomQueriesEnabled

Iespējot mssql.custom.query vienuma atslēgas izpildi.
Ja ir atspējots, vaicājumi netiks ielādēti no pielāgoto vaicājumu direktorijas ceļa.

Noklusējums: false
Diapazons: true/false

Plugins.MSSQL.Default.CACertPath

Norādiet noklusējuma faila ceļu uz sertifikātu iestādes (CA) publiskās atslēgas sertifikātu, kas izsniedza MSSQL servera sertifikātu.
Sertifikātam jābūt PEM formātā.

Plugins.MSSQL.Default.Database

Norādiet noklusējuma datubāzes nosaukumu.

Plugins.MSSQL.Default.Encrypt

Norādiet noklusējuma šifrēšanas līmeni.

Diapazons:
true - datu sūtīšana starp spraudni un serveri ir šifrēta;
false - datu sūtīšana starp spraudni un serveri nav šifrēta, izņemot pieteikšanās pakotni;
strict - datu sūtīšana starp spraudni un serveri ir šifrēta no gala līdz galam, izmantojot TDS8;
disable - datu sūtīšana starp spraudni un serveri nav šifrēta.

Plugins.MSSQL.Default.HostNameInCertificate

Pēc noklusējuma norādiet MSSQL servera sertifikāta vispārīgo nosaukumu (CN).

Plugins.MSSQL.Default.Password

Norādiet aizsargāta MSSQL servera noklusējuma paroli.

Plugins.MSSQL.Default.TLSMinVersion

Pēc noklusējuma norādiet minimālo TLS versiju.

Diapazons: 1.0, 1.1, 1.2, 1.3

Plugins.MSSQL.Default.TrustServerCertificate

Pēc noklusējuma uzticēties servera sertifikātam, to nevalidējot.

Diapazons: true, false

Plugins.MSSQL.Default.Uri

Norādiet noklusējuma URI savienojumam ar MSSQL serveri.
Iegultie akreditācijas dati tiks ignorēti.
Vienīgā atbalstītā shēma ir sqlserver://.
Shēmu var arī nenorādīt.

Noklusējums: sqlserver://localhost:1433

Plugins.MSSQL.Default.User

Norādiet noklusējuma lietotājvārdu aizsargātam MSSQL serverim.

Plugins.MSSQL.KeepAlive

Norādiet maksimālo gaidīšanas laiku (sekundēs) pirms neizmantotie spraudņa savienojumi tiek aizvērti.

Noklusējums: 300
Diapazons: 60-900

Plugins.MSSQL.Sessions.<SessionName>.CACertPath

Norādiet nosauktās sesijas faila ceļu uz sertifikāta iestādes (CA) publiskās atslēgas sertifikātu, kas izsniedza MSSQL servera sertifikātu.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.
Sertifikātam jābūt PEM formātā.

Plugins.MSSQL.Sessions.<SessionName>.Database

Norādiet nosauktās sesijas datubāzes nosaukumu.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Plugins.MSSQL.Sessions.<SessionName>.Encrypt

Norādiet nosauktās sesijas šifrēšanas līmeni.
<SessionName> - definē sesijas nosaukumu izmantošanai vienumu atslēgās.

Diapazons:
true - datu sūtīšana starp spraudni un serveri ir šifrēta;
false - datu sūtīšana starp spraudni un serveri nav šifrēta tālāk par pieteikšanās pakotni;
strict - datu sūtīšana starp spraudni un serveri ir šifrēta E2E, izmantojot TDS8;
disable - datu sūtīšana starp spraudni un serveri nav šifrēta.

Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate

Norādiet MSSQL servera sertifikāta kopējo nosaukumu (CN) nosauktajai sesijai.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Plugins.MSSQL.Sessions.<SessionName>.Password

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

Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion

Norādiet nosauktās sesijas minimālo TLS versiju.
<SessionName> - definē sesijas nosaukumu, ko izmantot vienumu atslēgās.

Diapazons: 1.0, 1.1, 1.2, 1.3

Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate

Uzticēties norādītās sesijas servera sertifikātam, to nevalidējot.
<SessionName> - norādiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Diapazons: true, false

Plugins.MSSQL.Sessions.<SessionName>.Uri

Norādiet nosauktās sesijas URI savienojumam ar MSSQL serveri.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.
Iegultie akreditācijas dati tiks ignorēti.
Vienīgā atbalstītā shēma ir sqlserver://.
Shēmu var nenorādīt.

Noklusējums: sqlserver://localhost:1433

Plugins.MSSQL.Sessions.<SessionName>.User

Norādiet nosauktās sesijas lietotājvārdu aizsargātam MSSQL serverim.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Plugins.MSSQL.System.Path

Norādiet MSSQL spraudņa izpildāmā faila ceļu.
Globāls MSSQL spraudņa iestatījums. Tiek piemērots visiem savienojumiem.

Piemērs: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql

Plugins.MSSQL.Timeout

Iestatiet ilgumu sekundēs, cik ilgi gaidīt, līdz serveris atbild, veidojot sākotnējo savienojumu un veicot turpmākās darbības sesijā.

Noklusējums: global timeout
Diapazons: 1-30

Opcijas

Parameter Description
-V --version Izdrukā spraudņa versiju un licences informāciju.
-h --help Izdrukā palīdzības informāciju (saīsināti).
-t, --test <item key> Palaiž spraudni testēšanai (spraudņa konfigurācija tiek ignorēta).

Skatiet arī