Konfigurācijas parametri: Zabbix bridge adapteris

Pārskats

Konfigurācijas parametri ļauj pielāgot Zabbix bridge adaptera darbību.

Norādiet parametru vērtības konfigurācijas failā (zabbix_bridge_adapter.conf). 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 informāciju par parametru, noklikšķiniet uz tā nosaukuma)
  • Parametru detalizēts apraksts
Parametrs Apraksts
AllowedAPIMethods Norādiet, kuras Zabbix API metodes var izsaukt, izmantojot bridge adapteri.
DataDir Norādiet direktoriju, kurā tiek izveidots un glabāts bridge adaptera stāvokļa fails un šifrēšanas atslēgas.
DebugLevel Iestatiet atkļūdošanas līmeni.
Include Norādiet direktoriju vai atsevišķus failus, kas jāiekļauj konfigurācijas failā.
ListenHealthPort Norādiet portu, kurā klausīties ienākošos HTTP veselības pārbaudes savienojumus.
ListenIP Norādiet IP adresi vai resursdatora nosaukumu, kurā klausīties ienākošos HTTP(S) savienojumus no Zabbix servera.
ListenPort Norādiet portu, kurā klausīties ienākošos HTTP(S) savienojumus no Zabbix servera.
LogFile Norādiet bridge adaptera žurnālfailu.
LogFileSize Iestatiet maksimālo žurnālfaila lielumu (MB).
LogType Norādiet žurnāla izvades tipu.
PidFile Norādiet PID failu.
ServerId Norādiet Zabbix servera unikālo identifikatoru. Obligāts.
TLSConfig.AllowedCN Norādiet ar komatiem atdalītu atļauto klientu Common Name vērtību sarakstu (tikai mTLS).
TLSConfig.CAFile Norādiet pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāts(-i), kas tiek izmantots(-i), lai pārbaudītu klientu sertifikātus mTLS režīmā.
TLSConfig.CertFile Norādiet pilnu ceļu uz failu, kurā ir sertifikāts vai sertifikātu ķēde.
TLSConfig.KeyFile Norādiet pilnu ceļu uz failu, kurā ir privātā atslēga.
TLSConfig.Mode Iestatiet TLS režīmu ienākošajiem savienojumiem portā ListenPort.
ZabbixAPITLSCAFile Norādiet pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāts(-i), ko bridge adapteris izmanto Zabbix API sertifikāta pārbaudei.
ZabbixAPITLSConnect Iestatiet TLS režīmu izejošajiem savienojumiem ar Zabbix API.
ZabbixAPIURL Norādiet Zabbix API galapunkta URL. Obligāts.
ZabbixBridgeURL Norādiet Zabbix Bridge URL Zabbix Bridge konfigurācijas izgūšanai (tā tiek izgūta, kad bridge adapteris tiek palaists).

Ņ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 tikai UTF-8 kodējumā saglabātus konfigurācijas failus bez BOM.
  • Komentāri, kas sākas ar #, tiek atbalstīti tikai rindas sākumā.

Parametru informācija

AllowedAPIMethods

Norādiet, kuras Zabbix API metodes var izsaukt, izmantojot bridge adapter.
Vairākām metodēm atkārtojiet parametru, katrai metodei norādot atsevišķu rindu.

Katra parametra vērtībai ir jābūt vai nu precīzam metodes nosaukumam (piemēram, problem.get), vai aizstājējzīmes paraugam, kas aizstāj tikai visu API nosaukumu (piemēram, *.get) vai visu metodes nosaukumu (piemēram, problem.*).

Jebkura cita vērtība nav derīga un neļauj bridge adapter startēt. Tas attiecas arī uz vienu aizstājējzīmi (*), daļēju aizstājējzīmes paraugu (host* vai host*.*) vai tukšu vērtību (AllowedAPIMethods=).

Piemērs:

AllowedAPIMethods=apiinfo.version
AllowedAPIMethods=problem.*
AllowedAPIMethods=*.get

Minimālais metožu kopums, kas nepieciešams Zabbix mobilajai lietotnei:

AllowedAPIMethods=apiinfo.version
AllowedAPIMethods=device.onboard
AllowedAPIMethods=device.offboard
AllowedAPIMethods=user.get
AllowedAPIMethods=role.get
AllowedAPIMethods=problem.get
AllowedAPIMethods=event.get
AllowedAPIMethods=event.acknowledge
AllowedAPIMethods=trigger.get
AllowedAPIMethods=alert.get
AllowedAPIMethods=host.get
AllowedAPIMethods=hostgroup.get

Noklusējums: nav iestatīts (visas Zabbix API metodes ir liegtas)

DataDir

Norādiet direktoriju, kurā tiek izveidots un glabāts bridge adaptera stāvokļa fails un šifrēšanas atslēgas.
Direktorijai ir jāpastāv, un tai ir jābūt 0700 atļaujām. Visiem tajā glabātajiem failiem ir jābūt 0600 atļaujām.

Noklusējums: /var/lib/zabbix-bridge-adapter

DebugLevel

Iestatiet atkļūdošanas līmeni:

  • 0 - pamatinformācija par Zabbix procesu palaišanu un apturēšanu
  • 1 - kritiska informācija
  • 2 - informācija par kļūdām
  • 3 - brīdinājumi
  • 4 - atkļūdošanai (ģenerē daudz informācijas)
  • 5 - paplašināta atkļūdošana (ģenerē vēl vairāk informācijas)

Noklusējums: 3
Diapazons: 0-5

Iekļaušana

Norādiet direktoriju vai atsevišķus failus, kas jāiekļauj konfigurācijas failā.
Zabbix instalēšanas laikā šis parametrs tiek iestatīts uz /etc/zabbix, ja vien kompilēšanas laikā to nemaināt.

Vispārīgi Include parametra lietošanas noteikumi:

  • Ceļš var būt relatīvs pret zabbix_bridge_adapter.conf faila atrašanās vietu.
  • Vienā konfigurācijas failā var norādīt vairākus Include parametrus.
  • Zabbix apstrādā Include parametru uzreiz pēc tā nolasīšanas, tāpēc apsveriet iespēju to ievietot konfigurācijas faila beigās.

Iekļauto failu noteikumi:

  • Katram failam jābūt nolasāmam.
  • Katram failam jābūt ar pareizu sintaksi. Pretējā gadījumā komponents netiks palaists.

Direktoriju vai failu šablonu iekļaušanas noteikumi:

  • Neuzskatiet, ka iekļaušana notiks noteiktā secībā (piemēram, faili netiek iekļauti alfabētiskā secībā).
  • Nedefinējiet vienu un to pašu parametru vairāk nekā vienā iekļautajā failā (piemēram, lai aizstātu vispārīgu iestatījumu ar konkrētu), jo nav iespējams paredzēt, kura vērtība tiks izmantota.
  • Pievērsiet uzmanību dublējumkopijām, ko daži teksta redaktori izveido automātiski (piemēram, rediģējot include/my_specific.conf, var tikt izveidots include/my_specific.conf.BAK), jo tiks iekļauti abi faili.

Lai no direktorijas iekļautu tikai atbilstošos failus, modeļa atbilstībai izmantojiet aizstājējzīmi (*).

Piemērs:

Include=/absolute/path/to/config/files/*.conf
ListenHealthPort

Norādiet portu, kurā klausīties ienākošos HTTP veselības pārbaudes savienojumus.
Apkalpo /health un /ready galapunktus.
Ja nav norādīts, veselības pārbaudes pakalpojums netiek palaists.

Noklusējums: 8081
Diapazons: 1024-32767

ListenIP

Norādiet IP adresi vai resursdatora nosaukumu, kurā klausīties ienākošos HTTP(S) savienojumus no Zabbix servera.
Ja nav norādīts, tilta adapteris klausās visās vietējās sistēmas pieejamajās IP adresēs.

ListenPort

Norādiet portu, kurā klausīties ienākošos HTTP(S) savienojumus no Zabbix servera.

Noklusējuma vērtība: 10054
Diapazons: 1024-32767

LogFile

Norādiet bridge adaptera žurnālfailu.

Obligāti: Jā, ja LogType ir iestatīts uz file; pretējā gadījumā — nē

Noklusējums: /tmp/zabbix_bridge_adapter.log

LogFileSize

Iestatiet maksimālo žurnālfaila lielumu (MB).
0 - atspējot automātisku žurnālfaila rotāciju.

Noklusējums: 1
Diapazons: 0-1024

LogType

Norādiet žurnāla izvades tipu:

  • file - rakstīt žurnālu failā, kas norādīts ar parametru LogFile.
  • system - rakstīt žurnālu sistēmas žurnālā.
  • console - rakstīt žurnālu standarta izvadē.

Noklusējums: file

PidFile

Norādiet PID failu.

Noklusējums: /tmp/zabbix_bridge_adapter.pid

ServerId

Norādiet Zabbix servera unikālo identifikatoru.
Pieejams Zabbix lietotāja saskarnē sadaļā Pārskati > Sistēmas informācija.

Obligāts: Jā

TLSConfig.AllowedCN

Norādiet ar komatiem atdalītu atļauto klienta Common Name vērtību sarakstu (tikai mTLS).
Ja vērtība nav norādīta, tilta adapteris nepārbauda klienta Common Name.

TLSConfig.CAFile

Norādiet pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāts(-i), kas tiek izmantots(-i) klientu sertifikātu pārbaudei mTLS režīmā.

TLSConfig.CertFile

Norādiet pilnu ceļu uz failu, kurā atrodas sertifikāts vai sertifikātu ķēde.

TLSConfig.KeyFile

Norādiet pilnu ceļu uz failu, kurā atrodas privātā atslēga.

TLSConfig.Mode

Iestatiet TLS režīmu ienākošajiem savienojumiem portā ListenPort:

  • none - pieņemt savienojumus bez šifrēšanas.
  • tls - standarta TLS ar vismaz v1.2 versiju.
  • mtls - paplašina TLS ar savstarpēju autentifikāciju.

Noklusējums: none

Skatiet arī: TLS no Zabbix servera uz Zabbix bridge adapteri

ZabbixAPITLSCAFile

Norādiet pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāts(-i), ko tilta adapteris izmanto Zabbix API sertifikāta pārbaudei.

Obligāts: Jā, ja ZabbixAPITLSConnect ir iestatīts uz verify_ca vai verify_full.

ZabbixAPITLSConnect

Izejošo savienojumu ar Zabbix API TLS režīma iestatīšana:

  • disabled - izmantot vienkāršu HTTP; ZabbixAPIURL jāizmanto http://.
  • required - izmantot HTTPS bez sertifikāta pārbaudes (tikai testēšanai).
  • verify_ca - izmantot HTTPS un pārbaudīt Zabbix API sertifikātu.
  • verify_full - izmantot HTTPS un pārbaudīt Zabbix API sertifikātu un resursdatora nosaukumu.

Tukša vai neiestatīta vērtība tiek uzskatīta par required.

Noklusējums: required

Skatiet arī: TLS no Zabbix bridge adaptera uz Zabbix API

ZabbixAPIURL

Norādiet Zabbix API galapunkta URL.

Obligāts: Jā

Piemērs:

ZabbixAPIURL=https://example.com/zabbix/api_jsonrpc.php
ZabbixBridgeURL

Norādiet Zabbix Bridge URL Zabbix Bridge konfigurācijas izgūšanai (tā tiek izgūta, kad tiek palaists bridge adapteris).

Noklusējums: ZabbixBridgeURL=https://config.mobilebridge.zabbix.com/.well-known/bridge-configuration