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ēšanu1- kritiska informācija2- informācija par kļūdām3- brīdinājumi4- 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.conffaila atrašanās vietu. - Vienā konfigurācijas failā var norādīt vairākus
Includeparametrus. - Zabbix apstrādā
Includeparametru 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 izveidotsinclude/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 parametruLogFile.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;ZabbixAPIURLjāizmantohttp://.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