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.