9 Servizio web Zabbix
Panoramica
Il servizio web di Zabbix è un processo utilizzato per la comunicazione con servizi web esterni.
I parametri supportati dal file di configurazione del servizio web di Zabbix (zabbix_web_service.conf) sono elencati in questa sezione.
I parametri sono elencati senza informazioni aggiuntive. Fare clic sul parametro per visualizzarne tutti i dettagli.
| Parametro | Descrizione |
|---|---|
| AllowedIP | Un elenco di indirizzi IP separati da virgole, facoltativamente in notazione CIDR, oppure nomi DNS di server Zabbix e proxy Zabbix. |
| DebugLevel | Il livello di debug. |
| IgnoreURLCertErrors | Specifica la gestione degli errori di convalida del certificato TLS durante l'accesso all'URL del frontend. |
| Include | È possibile includere singoli file o tutti i file di una directory nel file di configurazione. |
| ListenPort | Il servizio resterà in ascolto su questa porta per le connessioni dal server. |
| LogFile | Il nome del file di log. |
| LogFileSize | La dimensione massima del file di log. |
| LogType | Il tipo di output del log. |
| Timeout | Il tempo massimo (in secondi) impiegato per formattare il report PDF di una dashboard. |
| TLSAccept | Quali connessioni in ingresso accettare. |
| TLSCAFile | Il percorso completo di un file contenente i certificati della CA di livello superiore per la verifica del certificato del peer, utilizzato per le comunicazioni cifrate tra i componenti Zabbix. |
| TLSCertFile | Il percorso completo di un file contenente il certificato del servizio o la catena di certificati, utilizzato per le comunicazioni cifrate tra i componenti Zabbix. |
| TLSKeyFile | Il percorso completo di un file contenente la chiave privata del servizio, utilizzato per le comunicazioni cifrate tra i componenti Zabbix. |
Tutti i parametri sono facoltativi, salvo ove esplicitamente indicato che il parametro è obbligatorio.
Si noti che:
- I valori predefiniti riflettono i valori predefiniti del processo, non i valori presenti nei file di configurazione forniti;
- I valori supportano le variabili d'ambiente;
- Zabbix supporta file di configurazione solo con codifica UTF-8 senza BOM;
- I commenti che iniziano con "#" sono supportati solo all'inizio della riga.
Dettagli del parametro
AllowedIP
Un elenco di indirizzi IP separati da virgole, facoltativamente in notazione CIDR, oppure di nomi DNS di server Zabbix e proxy Zabbix. Le connessioni in ingresso saranno accettate solo dagli host elencati qui.
Se il supporto IPv6 è abilitato, allora 127.0.0.1, ::127.0.0.1, ::ffff:127.0.0.1 sono trattati allo stesso modo e ::/0 consentirà qualsiasi indirizzo IPv4 o IPv6. 0.0.0.0/0 può essere usato per consentire qualsiasi indirizzo IPv4.
Esempio:
127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
Obbligatorio: sì
DebugLevel
Specifica il livello di debug:
0 - informazioni di base sull'avvio e l'arresto dei processi di Zabbix
1 - informazioni critiche;
2 - informazioni sugli errori;
3 - avvisi;
4 - per il debug (produce molte informazioni);
5 - debug esteso (produce ancora più informazioni).
Predefinito: 3
Intervallo: 0-5
IgnoreURLCertErrors
Specifica la gestione degli errori di validazione del certificato TLS durante l'accesso all'URL del frontend:
0 - non ignorare gli errori del certificato;
1 - ignorare gli errori del certificato.
Predefinito: 0
Intervallo: 0-1
Include
È possibile includere singoli file o tutti i file in una directory nel file di configurazione.
Durante l'installazione Zabbix creerà la directory di inclusione in /usr/local/etc, a meno che non venga modificata in fase di compilazione.
Il percorso può essere relativo alla posizione del file zabbix_web_service.conf.
Per includere solo i file pertinenti nella directory specificata, è supportato il carattere jolly asterisco per la corrispondenza dei modelli.
Vedere le note speciali relative alle limitazioni.
Esempio:
Include=/absolute/path/to/config/files/*.conf
ListenPort
Il servizio ascolterà su questa porta le connessioni dal server.
Impostazione predefinita: 10053
Intervallo: 1024-32767
LogFile
Il nome del file di log.
Esempio:
/tmp/zabbix_web_service.log
Obbligatorio: Sì, se LogType è impostato su file; altrimenti no
LogFileSize
La dimensione massima di un file di log in MB.
0 - disabilita la rotazione automatica dei log.
Nota: se viene raggiunto il limite di dimensione del file di log e la rotazione del file non riesce, per qualsiasi motivo, il file di log esistente viene troncato e ricominciato da capo.
Predefinito: 1
Intervallo: 0-1024
LogType
Il tipo di output del log:
file - scrive il log nel file specificato dal parametro LogFile;
system - scrive il log in syslog;
console - scrive il log nell'output standard.
Predefinito: file
Timeout
Il tempo massimo (in secondi) impiegato per formattare il report PDF di una dashboard.
Predefinito: 10
Intervallo: 1-30
TLSAccept
Quali connessioni in ingresso accettare:
unencrypted - accetta connessioni senza crittografia (predefinito)
cert - accetta connessioni con TLS e un certificato
Predefinito: unencrypted
TLSCAFile
Il percorso completo del file contenente i certificati della CA di primo livello per la verifica del certificato del peer, utilizzato per le comunicazioni cifrate tra i componenti di Zabbix.
TLSCertFile
Il percorso completo del file contenente il certificato del servizio o la catena di certificati, utilizzato per le comunicazioni crittografate con i componenti di Zabbix.
TLSKeyFile
Il percorso completo del file contenente la chiave privata del servizio, utilizzata per le comunicazioni crittografate tra i componenti di Zabbix.