[comment]: # attributes: notoc [comment]: # ({c52b2df3-c52b2df3}) # 3 Agente Zabbix (UNIX) [comment]: # ({/c52b2df3-c52b2df3}) [comment]: # ({ff7388b9-2773fc24}) ### Panoramica I parametri supportati dal file di configurazione dell'agent Zabbix (zabbix\_agentd.conf) sono elencati in questa sezione. I parametri sono elencati senza informazioni aggiuntive. Fai clic sul parametro per visualizzare i dettagli completi. |Parameter|Description| |--|--------| |[Alias](#alias)|Imposta un alias per una chiave item.| |[AllowKey](#allowkey)|Consente l'esecuzione di quelle chiavi item che corrispondono a un pattern.| |[AllowRoot](#allowroot)|Consente all'agent di essere eseguito come 'root'.| |[BufferSend](#buffersend)|Non conservare i dati nel buffer per più di N secondi.| |[BufferSize](#buffersize)|Il numero massimo di valori nel buffer di memoria.| |[DebugLevel](#debuglevel)|Il livello di debug.| |[DenyKey](#denykey)|Nega l'esecuzione di quelle chiavi item che corrispondono a un pattern.| |[EnableRemoteCommands](#enableremotecommands)|Indica se i comandi remoti da Zabbix server sono consentiti.| |[HeartbeatFrequency](#heartbeatfrequency)|La frequenza dei messaggi heartbeat in secondi.| |[HostInterface](#hostinterface)|Parametro facoltativo che definisce l'interfaccia dell'host.| |[HostInterfaceItem](#hostinterfaceitem)|Parametro facoltativo che definisce un item usato per ottenere l'interfaccia dell'host.| |[HostMetadata](#hostmetadata)|Parametro facoltativo che definisce i metadati dell'host.| |[HostMetadataItem](#hostmetadataitem)|Parametro facoltativo che definisce un item dell'agent Zabbix usato per ottenere i metadati dell'host.| |[Hostname](#hostname)|Parametro facoltativo che definisce il nome host.| |[HostnameItem](#hostnameitem)|Parametro facoltativo che definisce un item dell'agent Zabbix usato per ottenere il nome host.| |[Include](#include)|È possibile includere singoli file o tutti i file di una directory nel file di configurazione.| |[ListenBacklog](#listenbacklog)|Il numero massimo di connessioni in attesa nella coda TCP.| |[ListenIP](#listenip)|Un elenco di indirizzi IP separati da virgole su cui l'agent deve ascoltare.| |[ListenPort](#listenport)|L'agent ascolterà su questa porta le connessioni dal server.| |[LoadModule](#loadmodule)|Il modulo da caricare all'avvio dell'agent.| |[LoadModulePath](#loadmodulepath)|Il percorso completo della posizione dei moduli dell'agent.| |[LogFile](#logfile)|Il nome del file di log.| |[LogFileSize](#logfilesize)|La dimensione massima del file di log.| |[LogRemoteCommands](#logremotecommands)|Abilita la registrazione come avvisi dei comandi shell eseguiti.| |[LogType](#logtype)|Il tipo di output del log.| |[MaxLinesPerSecond](#maxlinespersecond)|Il numero massimo di nuove righe che l'agent invierà al secondo a Zabbix server o proxy durante l'elaborazione dei controlli attivi 'log' e 'logrt'.| |[PidFile](#pidfile)|Il nome del file PID.| |[RefreshActiveChecks](#refreshactivechecks)|La frequenza con cui viene aggiornato l'elenco dei controlli attivi.| |[Server](#server)|Un elenco di indirizzi IP separati da virgole, facoltativamente in notazione CIDR, oppure nomi DNS di Zabbix server e Zabbix proxy.| |[ServerActive](#serveractive)|L'indirizzo di Zabbix server/proxy o la configurazione del cluster da cui ottenere i controlli attivi.| |[SourceIP](#sourceip)|L'indirizzo IP di origine.| |[StartAgents](#startagents)|Il numero di istanze pre-fork di zabbix\_agentd che elaborano i controlli passivi.| |[Timeout](#timeout)|Specifica per quanto tempo attendere (in secondi) per stabilire la connessione e scambiare dati con Zabbix proxy o server.| |[TLSAccept](#tlsaccept)|Quali connessioni in ingresso accettare.| |[TLSCAFile](#tlscafile)|Il percorso completo di un file contenente i certificati della CA di livello superiore per la verifica del certificato del peer, usato per le comunicazioni crittografate tra i componenti Zabbix.| |[TLSCertFile](#tlscertfile)|Il percorso completo di un file contenente il certificato dell'agent o la catena di certificati, usato per le comunicazioni crittografate tra i componenti Zabbix.| |[TLSCipherAll](#tlscipherall)|La stringa di priorità GnuTLS o la stringa di cifratura OpenSSL (TLS 1.2). Sostituisce i criteri predefiniti di selezione della suite di cifratura per la crittografia basata su certificati e PSK.| |[TLSCipherAll13](#tlscipherall13)|La stringa di cifratura per OpenSSL 1.1.1 o versioni successive in TLS 1.3. Sostituisce i criteri predefiniti di selezione della suite di cifratura per la crittografia basata su certificati e PSK.| |[TLSCipherCert](#tlsciphercert)|La stringa di priorità GnuTLS o la stringa di cifratura OpenSSL (TLS 1.2). Sostituisce i criteri predefiniti di selezione della suite di cifratura per la crittografia basata su certificati.| |[TLSCipherCert13](#tlsciphercert13)|La stringa di cifratura per OpenSSL 1.1.1 o versioni successive in TLS 1.3. Sostituisce i criteri predefiniti di selezione della suite di cifratura per la crittografia basata su certificati.| |[TLSCipherPSK](#tlscipherpsk)|La stringa di priorità GnuTLS o la stringa di cifratura OpenSSL (TLS 1.2). Sostituisce i criteri predefiniti di selezione della suite di cifratura per la crittografia basata su PSK.| |[TLSCipherPSK13](#tlscipherpsk13)|La stringa di cifratura per OpenSSL 1.1.1 o versioni successive in TLS 1.3. Sostituisce i criteri predefiniti di selezione della suite di cifratura per la crittografia basata su PSK.| |[TLSConnect](#tlsconnect)|Come l'agent deve connettersi a Zabbix server o proxy.| |[TLSCRLFile](#tlscrlfile)|Il percorso completo di un file contenente i certificati revocati. Questo parametro viene usato per le comunicazioni crittografate tra i componenti Zabbix.| |[TLSKeyFile](#tlskeyfile)|Il percorso completo di un file contenente la chiave privata dell'agent, usato per le comunicazioni crittografate tra i componenti Zabbix.| |[TLSPSKFile](#tlspskfile)|Il percorso completo di un file contenente la chiave precondivisa dell'agent, usato per le comunicazioni crittografate con Zabbix server.| |[TLSPSKIdentity](#tlspskidentity)|La stringa di identità della chiave precondivisa, usata per le comunicazioni crittografate con Zabbix server.| |[TLSServerCertIssuer](#tlsservercertissuer)|L'emittente del certificato del server (proxy) consentito.| |[TLSServerCertSubject](#tlsservercertsubject)|Il soggetto del certificato del server (proxy) consentito.| |[UnsafeUserParameters](#unsafeuserparameters)|Consente di passare tutti i caratteri negli argomenti dei parametri definiti dall'utente.| |[User](#user)|Riduce i privilegi a un utente specifico ed esistente nel sistema.| |[UserParameter](#userparameter)|Un parametro definito dall'utente da monitorare.| |[UserParameterDir](#userparameterdir)|Il percorso di ricerca predefinito per i comandi UserParameter.| Tutti i parametri non sono obbligatori, salvo quando è esplicitamente indicato che il parametro è obbligatorio. Nota che: - I valori predefiniti riflettono i valori predefiniti del daemon, non quelli presenti nei file di configurazione distribuiti; - Zabbix supporta file di configurazione solo in codifica UTF-8 senza [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - I commenti che iniziano con "\#" sono supportati solo all'inizio della riga. [comment]: # ({/ff7388b9-2773fc24}) [comment]: # ({8085875f-bb271b3c}) ### Dettagli dei parametri [comment]: # ({/8085875f-bb271b3c}) [comment]: # ({f3842378-20d32ed1}) ##### Alias Imposta un alias per una chiave item. Può essere usato per sostituire una chiave item lunga e complessa con una più breve e semplice.
Possono essere presenti più parametri *Alias*. Non sono consentiti più parametri con la stessa chiave *Alias*.
Chiavi *Alias* diverse possono fare riferimento alla stessa chiave item.
Gli alias possono essere usati in *HostMetadataItem* ma non nel parametro *HostnameItem*. Esempio 1: Recupero dell'ID dell'utente 'zabbix'. ```default Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] ``` Ora la chiave abbreviata **zabbix.userid** può essere usata per recuperare i dati. Esempio 2: Ottenere l'utilizzo della CPU con parametri predefiniti e personalizzati. ```default Alias=cpu.util:system.cpu.util Alias=cpu.util[*]:system.cpu.util[*] ``` Questo consente di usare la chiave **cpu.util** per ottenere la percentuale di utilizzo della CPU con parametri predefiniti, oltre a usare **cpu.util[all, idle, avg15]** per ottenere dati specifici sull'utilizzo della CPU. Esempio 3: Esecuzione di più regole di [low-level discovery](/manual/discovery/low_level_discovery) che elaborano gli stessi elementi di discovery. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Ora è possibile configurare diverse regole di discovery usando **vfs.fs.discovery** con parametri diversi per ciascuna regola, ad esempio **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, ecc. [comment]: # ({/f3842378-20d32ed1}) [comment]: # ({3ed0c834-f52682cc}) ##### AllowKey Consente l'esecuzione di quegli item key che corrispondono a un pattern. Il pattern della key è un'espressione wildcard che supporta il carattere "\*" per corrispondere a un numero qualsiasi di caratteri.
È possibile definire più regole di corrispondenza delle key in combinazione con DenyKey. I parametri vengono elaborati uno per uno in base all'ordine in cui compaiono. Vedi anche: [Restricting agent checks](/manual/config/items/restrict_checks). [comment]: # ({/3ed0c834-f52682cc}) [comment]: # ({f4e3ae7a-a02d0dc0}) ##### AllowRoot Consente all'agent di essere eseguito come 'root'. Se disabilitato e l'agent viene avviato da 'root', l'agent tenterà invece di passare all'utente 'zabbix'. Non ha effetto se avviato da un utente normale. Predefinito: `0`
Valori: 0 - non consentire; 1 - consentire [comment]: # ({/f4e3ae7a-a02d0dc0}) [comment]: # ({fce8e2ee-12f60552}) ##### BufferSend Non conservare i dati nel buffer per più di N secondi. Predefinito: `5`
Intervallo: 1-3600 [comment]: # ({/fce8e2ee-12f60552}) [comment]: # ({3033154f-397065ee}) ##### BufferSize Il numero massimo di valori nel buffer di memoria. L'agent invierà tutti i dati raccolti al server Zabbix o al proxy se il buffer è pieno. Predefinito: `100`
Intervallo: 2-65535 [comment]: # ({/3033154f-397065ee}) [comment]: # ({9c071f70-e5288ea7}) ##### DebugLevel Specifica il livello di debug:
*0* - informazioni di base sull'avvio e l'arresto dei processi 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 [comment]: # ({/9c071f70-e5288ea7}) [comment]: # ({26eddabd-ef1d8b77}) ##### DenyKey Nega l'esecuzione di quegli item key che corrispondono a un pattern. Il pattern della chiave è un'espressione wildcard che supporta il carattere "\*" per corrispondere a qualsiasi numero di caratteri.
È possibile definire più regole di corrispondenza delle chiavi in combinazione con AllowKey. I parametri vengono elaborati uno per uno in base all'ordine in cui compaiono. Vedi anche: [Restricting agent checks](/manual/config/items/restrict_checks). [comment]: # ({/26eddabd-ef1d8b77}) [comment]: # ({80a7ec45-50dcbfc8}) ##### EnableRemoteCommands Se i comandi remoti da Zabbix server sono consentiti. Questo parametro è **deprecato**; usare invece AllowKey=system.run\[\*\] o DenyKey=system.run\[\*\].
È un alias interno per i parametri AllowKey/DenyKey a seconda del valore:
0 - DenyKey=system.run\[\*\]
1 - AllowKey=system.run\[\*\] Predefinito: `0`
Valori: 0 - non consentire, 1 - consentire [comment]: # ({/80a7ec45-50dcbfc8}) [comment]: # ({70ff69c8-764c3d3c}) ##### HeartbeatFrequency La frequenza dei messaggi di heartbeat in secondi. Usata per monitorare la disponibilità dei controlli attivi.
0 - messaggi di heartbeat disabilitati. Predefinito: `60`
Intervallo: 0-3600 [comment]: # ({/70ff69c8-764c3d3c}) [comment]: # ({cd35abda-e514f4a5}) ##### HostInterface Un parametro opzionale che definisce l'interfaccia dell'host (indirizzo IP o nome DNS) utilizzata durante il processo di [autoregistrazione](/manual/discovery/auto_registration) dell'host. Questo valore verrà usato per popolare l'interfaccia nel nuovo host creato e consente di configurare esplicitamente un indirizzo IP o DNS. Per ulteriori dettagli, vedere [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). Se non definito, il valore verrà acquisito da HostInterfaceItem. L'agent segnalerà un errore e non si avvierà se il valore supera il limite di 255 caratteri. Intervallo: 0-255 caratteri [comment]: # ({/cd35abda-e514f4a5}) [comment]: # ({dc29c465-4965ac2b}) ##### HostInterfaceItem Un parametro opzionale che definisce un item utilizzato per determinare l'interfaccia dell'host (indirizzo IP o nome DNS) durante il processo di [autoregistrazione](/manual/discovery/auto_registration) dell'host. Questo valore viene utilizzato solo se HostInterface non è definito. Per ulteriori dettagli, vedere [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). Durante una richiesta di autoregistrazione, l'agent registrerà un messaggio di avviso se il valore restituito dall'item specificato supera il limite di 255 caratteri. L'item [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) è supportato indipendentemente dalle impostazioni AllowKey/DenyKey. [comment]: # ({/dc29c465-4965ac2b}) [comment]: # ({ed067cab-42990e42}) ##### HostMetadata Un parametro opzionale che definisce i [metadati](/manual/discovery/auto_registration#using-host-metadata) utilizzati per identificare o distinguere l'host durante il processo di [autoregistrazione](/manual/discovery/auto_registration) dell'host (agent attivo). HostMetadata consente di distinguere gli host oltre il nome host. Se non definito, il valore verrà acquisito da HostMetadataItem. L'agent segnalerà un errore e non si avvierà se il valore specificato supera il limite di 2034 byte o se si tratta di una stringa non UTF-8. Quando un parametro si aspetta un indirizzo IP o un nome DNS, anche i valori validi UTF-8 ma non validi come IP o nomi DNS verranno rifiutati e segnalati come non validi. I metadati su più righe non sono supportati: l'output verrà troncato al primo ritorno a capo. Intervallo: 0-2034 byte [comment]: # ({/ed067cab-42990e42}) [comment]: # ({b83b65c3-953ee255}) ##### HostMetadataItem Un parametro opzionale che definisce un item dell'agent Zabbix usato per ottenere i [metadati dell'host](/manual/discovery/auto_registration#using-host-metadata). Questa opzione viene usata solo quando HostMetadata non è definito. Il valore di HostMetadataItem viene recuperato a ogni tentativo di [autoregistrazione](/manual/discovery/auto_registration) e viene usato solo nel processo di autoregistrazione dell'host (agent attivo). HostMetadataItem consente di distinguere gli host oltre il nome host. Sono supportati i parametri utente e gli alias. L'item [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) è supportato indipendentemente dalle impostazioni AllowKey/DenyKey. Durante una richiesta di autoregistrazione, l'agent registrerà un messaggio di avviso se il valore restituito dall'item specificato supera il limite di 65535 punti di codice UTF-8. Il valore restituito dall'item deve essere una stringa UTF-8, altrimenti verrà ignorato. Quando un parametro si aspetta un indirizzo IP o un nome DNS, anche i valori validi in UTF-8 ma non validi come IP o nomi DNS verranno rifiutati e segnalati come non validi. I metadati su più righe non sono supportati: l'output verrà troncato al primo ritorno a capo. [comment]: # ({/b83b65c3-953ee255}) [comment]: # ({39406dda-79d09548}) ##### Nome host Un elenco di hostname univoci, delimitati da virgole e sensibili alle maiuscole/minuscole. Obbligatorio per i controlli attivi e deve corrispondere agli hostname configurati sul server. Il valore viene acquisito da HostnameItem se non definito.
Caratteri consentiti: alfanumerici, '.', ' ', '\_' e '-'. Lunghezza massima: 128 caratteri per hostname, 2048 caratteri per l'intera riga. Predefinito: impostato da HostnameItem [comment]: # ({/39406dda-79d09548}) [comment]: # ({5dd0215d-14aaef49}) ##### HostnameItem Un parametro opzionale che definisce un item di Zabbix agent usato per ottenere il nome dell'host. Questa opzione viene utilizzata solo quando Hostname non è definito. I parametri utente o gli alias non sono supportati, ma l'item [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) è supportato indipendentemente dai valori di AllowKey/DenyKey. Predefinito: `system.hostname` [comment]: # ({/5dd0215d-14aaef49}) [comment]: # ({3ae9ed9c-1e31f1b3}) ##### Includi Puoi includere singoli file o tutti i file in una directory nel file di configurazione. Per includere solo i file pertinenti nella directory specificata, è supportato il carattere jolly asterisco per la corrispondenza dei pattern.
Vedi [note speciali](special_notes_include) sulle limitazioni. Esempio: ```default Include=/absolute/path/to/config/files/*.conf ``` [comment]: # ({/3ae9ed9c-1e31f1b3}) [comment]: # ({fcd70e26-d49e31a2}) ##### ListenBacklog Il numero massimo di connessioni in attesa nella coda TCP.
Il valore predefinito è una costante codificata, che dipende dal sistema.
Anche il valore massimo supportato dipende dal sistema; valori troppo elevati possono essere troncati silenziosamente al "massimo specificato dall'implementazione". Predefinito: `SOMAXCONN`
Intervallo: 0 - INT\_MAX [comment]: # ({/fcd70e26-d49e31a2}) [comment]: # ({35f278c7-62349c68}) ##### ListenIP Un elenco di indirizzi IP separati da virgole su cui l'agent deve ascoltare. Predefinito: `0.0.0.0` [comment]: # ({/35f278c7-62349c68}) [comment]: # ({5f95bc53-e99b72c0}) ##### ListenPort L'agent ascolterà su questa porta le connessioni dal server. Predefinito: `10050`
Intervallo: 1024-32767 [comment]: # ({/5f95bc53-e99b72c0}) [comment]: # ({f4dfc794-fb75d239}) ##### LoadModule Il modulo da caricare all'avvio dell'agent. I moduli vengono utilizzati per estendere le funzionalità dell'agent. Il modulo deve trovarsi nella directory specificata da LoadModulePath oppure il percorso deve precedere il nome del modulo. Se il percorso precedente è assoluto (inizia con '/') allora LoadModulePath viene ignorato.
Formati:
LoadModule=
LoadModule=
LoadModule=
È consentito includere più parametri LoadModule. [comment]: # ({/f4dfc794-fb75d239}) [comment]: # ({b88f1651-bd604c99}) ##### LoadModulePath Il percorso completo della posizione dei moduli dell'agent. Il valore predefinito dipende dalle opzioni di compilazione. [comment]: # ({/b88f1651-bd604c99}) [comment]: # ({ce9b40ca-bb5252d8}) ##### LogFile Il nome del file di log. Obbligatorio: Sì, se LogType è impostato su *file*; altrimenti no [comment]: # ({/ce9b40ca-bb5252d8}) [comment]: # ({f7604f8f-778f1edc}) ##### 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 ricreato da zero. Predefinito: `1`
Intervallo: 0-1024 [comment]: # ({/f7604f8f-778f1edc}) [comment]: # ({0dac5c2b-3d97cc10}) ##### LogRemoteCommands Abilita la registrazione dei comandi shell eseguiti come avvisi. I comandi verranno registrati solo se eseguiti in remoto. Le voci di log non verranno create se system.run\[\] viene avviato localmente dai parametri HostMetadataItem, HostInterfaceItem o HostnameItem. Predefinito: `0`
Valori: 0 - disabilitato, 1 - abilitato [comment]: # ({/0dac5c2b-3d97cc10}) [comment]: # ({ae46be35-9d26f327}) ##### 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` [comment]: # ({/ae46be35-9d26f327}) [comment]: # ({8e341c19-7d39adb8}) ##### MaxLinesPerSecond Il numero massimo di nuove righe che l'agent invierà al secondo a Zabbix server o proxy durante l'elaborazione dei controlli attivi 'log' e 'logrt'. Il valore fornito verrà sovrascritto dal parametro 'maxlines', se specificato nella chiave dell'item 'log' o 'logrt'.
*Nota*: Zabbix elaborerà 10 volte più nuove righe rispetto a quelle impostate in *MaxLinesPerSecond* per cercare la stringa richiesta negli item di log. Predefinito: `20`
Intervallo: 1-1000 [comment]: # ({/8e341c19-7d39adb8}) [comment]: # ({3d558d6c-8a5c9259}) ##### PidFile Il nome del file PID. Predefinito: `/tmp/zabbix_agentd.pid` [comment]: # ({/3d558d6c-8a5c9259}) [comment]: # ({3d47a4c2-b62afa60}) ##### RefreshActiveChecks Con quale frequenza viene aggiornato l'elenco dei controlli attivi, in secondi. Si noti che, dopo un tentativo fallito di aggiornamento dei controlli attivi, il successivo aggiornamento verrà tentato dopo 60 secondi. Predefinito: `5`
Intervallo: 1-86400 [comment]: # ({/3d47a4c2-b62afa60}) [comment]: # ({b967fca0-46329efe}) ##### Server Un elenco di indirizzi IP separati da virgole, opzionalmente in notazione CIDR, oppure nomi DNS dei server Zabbix e dei 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. Si noti che gli "indirizzi IPv6 compatibili con IPv4" (prefisso 0000::/96) sono supportati ma deprecati da [RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5). Sono consentiti spazi. Esempio: ```default Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com ``` Obbligatorio: sì, se StartAgents non è impostato esplicitamente su 0 [comment]: # ({/b967fca0-46329efe}) [comment]: # ({85302681-d6a09b20}) ##### ServerActive L'indirizzo del server/proxy Zabbix o la configurazione del cluster da cui ottenere i controlli attivi. L'indirizzo del server/proxy è un indirizzo IP o un nome DNS, con una porta opzionale separata da due punti.
La configurazione del cluster è costituita da uno o più indirizzi dei membri del gruppo di server o proxy separati da punto e virgola. È possibile specificare più server/cluster Zabbix e proxy Zabbix, separati da virgola. A meno che non si usino gruppi di proxy, non dovrebbe essere specificato più di un proxy Zabbix per ciascun server/cluster Zabbix. Se è specificato un proxy Zabbix, allora il server/cluster Zabbix per quel proxy non dovrebbe essere specificato.
È possibile fornire più indirizzi separati da virgole per usare in parallelo più server Zabbix indipendenti. Gli spazi sono consentiti.
Se la porta non è specificata, viene usata la porta predefinita.
Gli indirizzi IPv6 devono essere racchiusi tra parentesi quadre se è specificata la porta per quell'host. Se la porta non è specificata, le parentesi quadre per gli indirizzi IPv6 sono facoltative.
Se questo parametro non è specificato, i controlli attivi sono disabilitati. Esempio per proxy Zabbix: ```default ServerActive=127.0.0.1:10051 ``` Esempio per gruppo di proxy Zabbix: ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com Esempio per più server: ```default ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1] ``` Esempio per alta disponibilità: ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3 ``` Esempio per alta disponibilità con due cluster e un server: ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain ``` [comment]: # ({/85302681-d6a09b20}) [comment]: # ({76194937-020cc066}) ##### SourceIP L'indirizzo IP sorgente per: - connessioni in uscita verso Zabbix server o Zabbix proxy; - la creazione di connessioni durante l'esecuzione di alcuni item (web.page.get, net.tcp.port, ecc.). [comment]: # ({/76194937-020cc066}) [comment]: # ({8e63fa32-6e2d3567}) ##### StartAgents Il numero di istanze pre-forked di zabbix\_agentd che elaborano i controlli passivi. Se impostato su 0, i controlli passivi sono disabilitati e l'agent non ascolterà su alcuna porta TCP. Predefinito: `10`
Intervallo: 0-100 [comment]: # ({/8e63fa32-6e2d3567}) [comment]: # ({b0f05ae1-ee64bcdf}) ##### Timeout Specifica per quanto tempo attendere (in secondi) per stabilire la connessione e scambiare dati con il proxy o il server di Zabbix.
Questo parametro definisce la durata di varie operazioni di comunicazione, tra cui: - l'attesa di una risposta dal server Zabbix; - l'invio di richieste al server Zabbix, incluse le richieste di configurazione degli item e i dati degli item nelle [active checks](/manual/appendix/items/activepassive#active-checks); - il recupero dei dati di log tramite logfile; - l'invio di messaggi heartbeat; - la durata massima per i controlli `vfs.*`; - l'utilizzo da parte dei moduli di Zabbix agent; - l'uso come fallback negli scenari in cui un server o un proxy precedente alla versione 7.0 invia controlli senza timeout. Questo timeout **non** verrà utilizzato per quei controlli agent che dispongono di impostazioni di timeout configurabili nel frontend (a livello globale, di proxy o per singolo item). Predefinito: `3`
Intervallo: 1-30 [comment]: # ({/b0f05ae1-ee64bcdf}) [comment]: # ({613f7954-849f8496}) ##### TLSAccept Quali connessioni in ingresso accettare. Usato per i controlli passivi. È possibile specificare più valori, separati da virgola:
*unencrypted* - accetta connessioni senza crittografia (predefinito)
*psk* - accetta connessioni con TLS e una chiave precondivisa (PSK)
*cert* - accetta connessioni con TLS e un certificato Obbligatorio: sì, se sono definiti parametri del certificato TLS o della PSK (anche per una connessione *unencrypted*); altrimenti no [comment]: # ({/613f7954-849f8496}) [comment]: # ({65d07bda-336a620d}) ##### TLSCAFile Il percorso completo del file contenente i certificati della CA di livello superiore per la verifica del certificato del peer, utilizzato per le comunicazioni crittografate tra i componenti di Zabbix. [comment]: # ({/65d07bda-336a620d}) [comment]: # ({005f60f1-185ad3c6}) ##### TLSCertFile Il percorso completo del file contenente il certificato dell'agent o la catena di certificati, utilizzato per le comunicazioni crittografate con i componenti di Zabbix. [comment]: # ({/005f60f1-185ad3c6}) [comment]: # ({84033417-3e9bf2b8}) ##### TLSCipherAll La stringa di priorità GnuTLS o la stringa di cifratura OpenSSL (TLS 1.2). Sostituisce i criteri predefiniti di selezione della suite di cifratura per la crittografia basata su certificati e PSK. Esempio: ```default TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/84033417-3e9bf2b8}) [comment]: # ({a9e7f94f-03e7f520}) ##### TLSCipherAll13 La stringa di cifratura per OpenSSL 1.1.1 o versioni successive in TLS 1.3. Sostituisce i criteri di selezione predefiniti della suite di cifratura per la crittografia basata su certificati e PSK. Esempio per GnuTLS: ```default NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509 ``` Esempio per OpenSSL: ``` EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128 ``` [comment]: # ({/a9e7f94f-03e7f520}) [comment]: # ({00c9e2e3-f7468437}) ##### TLSCipherCert La stringa di priorità GnuTLS o la stringa dei cipher OpenSSL (TLS 1.2). Sostituisce i criteri predefiniti di selezione della suite di cifratura per la crittografia basata su certificati. Esempio per GnuTLS: ```default NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509 ``` Esempio per OpenSSL: ```default EECDH+aRSA+AES128:RSA+aRSA+AES128 ``` [comment]: # ({/00c9e2e3-f7468437}) [comment]: # ({fdf185a8-717d9f51}) ##### TLSCipherCert13 La stringa di cifratura per OpenSSL 1.1.1 o versioni successive in TLS 1.3. Sostituisce i criteri di selezione predefiniti della ciphersuite per la crittografia basata su certificati. [comment]: # ({/fdf185a8-717d9f51}) [comment]: # ({c201c168-3a633a0a}) ##### TLSCipherPSK La stringa di priorità GnuTLS o la stringa dei cipher OpenSSL (TLS 1.2). Sovrascrive i criteri predefiniti di selezione della suite di cifratura per la crittografia basata su PSK. Esempio per GnuTLS: ```default NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL ``` Esempio per OpenSSL: ```default kECDHEPSK+AES128:kPSK+AES128 ``` [comment]: # ({/c201c168-3a633a0a}) [comment]: # ({c74deda4-8208c770}) ##### TLSCipherPSK13 La stringa di cifratura per OpenSSL 1.1.1 o versioni successive in TLS 1.3. Sostituisce i criteri di selezione predefiniti della suite di cifratura per la crittografia basata su PSK. Esempio: ```default TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/c74deda4-8208c770}) [comment]: # ({e2ebc18f-b1151069}) ##### TLSConnect Come l'agent deve connettersi a Zabbix server o proxy. Usato per i controlli attivi. Può essere specificato un solo valore:
*unencrypted* - connessione senza crittografia (predefinito)
*psk* - connessione tramite TLS e una chiave precondivisa (PSK)
*cert* - connessione tramite TLS e un certificato Obbligatorio: sì, se sono definiti parametri del certificato TLS o della PSK (anche per una connessione *unencrypted*); altrimenti no [comment]: # ({/e2ebc18f-b1151069}) [comment]: # ({ad4dc889-28aef301}) ##### TLSCRLFile Il percorso completo del file contenente i certificati revocati. Questo parametro viene utilizzato per le comunicazioni crittografate tra i componenti di Zabbix. [comment]: # ({/ad4dc889-28aef301}) [comment]: # ({c2aa4315-cbcbba0a}) ##### TLSKeyFile Il percorso completo del file contenente la chiave privata dell'agent, utilizzata per le comunicazioni crittografate tra i componenti di Zabbix. [comment]: # ({/c2aa4315-cbcbba0a}) [comment]: # ({11defa44-845f5b70}) ##### TLSPSKFile Il percorso completo del file contenente la chiave pre-condivisa dell'agent, utilizzata per le comunicazioni crittografate con il server Zabbix. [comment]: # ({/11defa44-845f5b70}) [comment]: # ({92d3eff0-b02e4942}) ##### TLSPSKIdentity La stringa di identità della chiave pre-condivisa, utilizzata per le comunicazioni crittografate con il server Zabbix. [comment]: # ({/92d3eff0-b02e4942}) [comment]: # ({ae5c568f-7a78525c}) ##### TLSServerCertIssuer Il issuer del certificato del server consentito (proxy). [comment]: # ({/ae5c568f-7a78525c}) [comment]: # ({fb69617f-c8d1ac8b}) ##### TLSServerCertSubject Il subject del certificato del server (proxy) consentito. [comment]: # ({/fb69617f-c8d1ac8b}) [comment]: # ({8fffe818-676eb24d}) ##### UnsafeUserParameters Consente di passare tutti i caratteri negli argomenti dei parametri definiti dall'utente. I seguenti caratteri non sono consentiti: \\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @
Inoltre, i caratteri di nuova riga non sono consentiti. Predefinito: `0`
Valori: 0 - non consentire, 1 - consentire [comment]: # ({/8fffe818-676eb24d}) [comment]: # ({ee4ad0a4-e9779b31}) ##### Utente Riduce i privilegi a un utente specifico già esistente nel sistema.
Ha effetto solo se eseguito come 'root' e AllowRoot è disabilitato. Predefinito: `zabbix` [comment]: # ({/ee4ad0a4-e9779b31}) [comment]: # ({1a5d86ec-1591e129}) ##### UserParameter Un parametro definito dall'utente da monitorare. Possono esserci diversi parametri definiti dall'utente.
Formato: UserParameter=,
Si noti che il comando shell non deve restituire una stringa vuota o solo EOL. I comandi shell possono avere percorsi relativi, se è specificato il parametro UserParameterDir. Esempio: ```default UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh ``` [comment]: # ({/1a5d86ec-1591e129}) [comment]: # ({0a46abda-493da8fd}) ##### UserParameterDir Il percorso di ricerca predefinito per i comandi UserParameter. Se utilizzato, l'agent cambierà la propria directory di lavoro in quella specificata qui prima di eseguire un comando. In questo modo, i comandi UserParameter possono avere un prefisso relativo `./` invece di un percorso completo.
È consentita una sola voce. Esempio: ```default UserParameterDir=/opt/myscripts ``` [comment]: # ({/0a46abda-493da8fd}) [comment]: # ({94f69fcc-9170c364}) #### Vedi anche 1. [Differenze nella configurazione di Zabbix agent per controlli attivi e passivi a partire dalla versione 2.0.0](http://blog.zabbix.com/multiple-servers-for-active-agent-sure/858) [comment]: # ({/94f69fcc-9170c364})