[comment]: # attributes: notoc [comment]: # ({a36cb226-a36cb226}) #5 Agente Zabbix (Windows) [comment]: # ({/a36cb226-a36cb226}) [comment]: # ({9dc41c64-c0c75d19}) ### Panoramica I parametri supportati dal file di configurazione dell'agent Zabbix per Windows (zabbix\_agentd.conf) sono elencati in questa sezione. I parametri sono elencati senza informazioni aggiuntive. Fare clic sul parametro per visualizzare tutti i dettagli. |Parameter|Description| |--|--------| |[Alias](#alias)|Imposta un alias per una chiave item.| |[AllowKey](#allowkey)|Consente l'esecuzione delle chiavi item che corrispondono a un modello.| |[BufferSend](#buffersend)|Non mantenere 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 delle chiavi item che corrispondono a un modello.| |[EnableRemoteCommands](#enableremotecommands)|Indica se i comandi remoti dal server Zabbix sono consentiti.| |[HeartbeatFrequency](#heartbeatfrequency)|La frequenza dei messaggi heartbeat in secondi.| |[HostInterface](#hostinterface)|Un parametro facoltativo che definisce l'interfaccia host.| |[HostInterfaceItem](#hostinterfaceitem)|Un parametro facoltativo che definisce un item utilizzato per ottenere l'interfaccia host.| |[HostMetadata](#hostmetadata)|Un parametro facoltativo che definisce i metadati dell'host.| |[HostMetadataItem](#hostmetadataitem)|Un parametro facoltativo che definisce un item dell'agent Zabbix utilizzato per ottenere i metadati dell'host.| |[Hostname](#hostname)|Un parametro facoltativo che definisce il nome host.| |[HostnameItem](#hostnameitem)|Un parametro facoltativo che definisce un item dell'agent Zabbix utilizzato 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 sui quali l'agent deve restare in ascolto.| |[ListenPort](#listenport)|L'agent resterà in ascolto su questa porta per le connessioni dal server.| |[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 server o proxy Zabbix al secondo durante l'elaborazione dei controlli attivi 'log' e 'logrt'.| |[PerfCounter](#perfcounter)|Definisce un nuovo parametro che rappresenta il valore medio del contatore delle prestazioni di sistema per il periodo di tempo specificato (in secondi).| |[PerfCounterEn](#perfcounteren)|Definisce un nuovo parametro che rappresenta il valore medio del contatore delle prestazioni di sistema per il periodo di tempo specificato (in secondi). Rispetto a PerfCounter, i percorsi perfcounter devono essere in inglese.| |[RefreshActiveChecks](#refreshactivechecks)|Con quale frequenza 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 server Zabbix e proxy Zabbix.| |[ServerActive](#serveractive)|L'indirizzo del server/proxy Zabbix o la configurazione del cluster da cui ottenere i controlli attivi.| |[SourceIP](#sourceip)|L'indirizzo IP sorgente.| |[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 proxy o server Zabbix.| |[TLSAccept](#tlsaccept)|Quali connessioni in ingresso accettare.| |[TLSCAFile](#tlscafile)|Il percorso completo di un file contenente i certificati della/e CA di livello superiore per la verifica del certificato del peer, utilizzato per le comunicazioni cifrate tra componenti Zabbix.| |[TLSCertFile](#tlscertfile)|Il percorso completo di un file contenente il certificato dell'agent o la catena di certificati, utilizzato per le comunicazioni cifrate tra componenti Zabbix.| |[TLSConnect](#tlsconnect)|Come l'agent deve connettersi al server o proxy Zabbix.| |[TLSCRLFile](#tlscrlfile)|Il percorso completo di un file contenente i certificati revocati. Questo parametro è utilizzato per le comunicazioni cifrate tra componenti Zabbix.| |[TLSKeyFile](#tlskeyfile)|Il percorso completo di un file contenente la chiave privata dell'agent, utilizzato per le comunicazioni cifrate tra componenti Zabbix.| |[TLSPSKFile](#tlspskfile)|Il percorso completo di un file contenente la chiave precondivisa dell'agent, utilizzato per le comunicazioni cifrate con il server Zabbix.| |[TLSPSKIdentity](#tlspskidentity)|La stringa identificativa della chiave precondivisa, utilizzata per le comunicazioni cifrate con il server Zabbix.| |[TLSServerCertIssuer](#tlsservercertissuer)|L'emittente consentito del certificato del server (proxy).| |[TLSServerCertSubject](#tlsservercertsubject)|Il soggetto consentito del certificato del server (proxy).| |[UnsafeUserParameters](#unsafeuserparameters)|Consente il passaggio di tutti i caratteri negli argomenti ai parametri definiti dall'utente.| |[UserParameter](#userparameter)|Un parametro definito dall'utente da monitorare.| |[UserParameterDir](#userparameterdir)|Il percorso di ricerca predefinito per i comandi UserParameter.| Tutti i parametri sono facoltativi, salvo nei casi in cui sia esplicitamente indicato che il parametro è obbligatorio. Si noti che: - I valori predefiniti riflettono i valori predefiniti del demone, non i valori presenti nei file di configurazione distribuiti. - I valori supportano le [variabili d'ambiente](/manual/appendix/config/environment_variables). - Zabbix supporta file di configurazione solo con 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]: # ({/9dc41c64-c0c75d19}) [comment]: # ({8085875f-d041e5fe}) ### Dettagli del parametro [comment]: # ({/8085875f-d041e5fe}) [comment]: # ({ace84303-dbac533e}) ##### Alias Imposta un alias per una chiave item. Può essere utilizzato per sostituire una chiave item lunga e complessa con una più corta 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 utilizzati in *HostMetadataItem* ma non nel parametro *HostnameItem* o *PerfCounter*. Esempio 1: recupero dell'utilizzo del file di paging in percentuale dal server. ```default Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage] ``` Ora la chiave abbreviata **pg_usage** può essere utilizzata per recuperare i dati. Esempio 2: ottenimento del carico della CPU con parametri predefiniti e personalizzati. ```default Alias=cpu.load:system.cpu.load Alias=cpu.load[*]:system.cpu.load[*] ``` Ciò consente di utilizzare la chiave **cpu.load** per ottenere il carico della CPU con i parametri predefiniti, nonché di usare **cpu.load[percpu,avg15]** per ottenere dati specifici sul carico della CPU. Esempio 3: esecuzione di più regole di [low-level discovery](/manual/discovery/low_level_discovery) che elaborano gli stessi item di discovery. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Ora è possibile configurare diverse regole di discovery utilizzando **vfs.fs.discovery** con parametri diversi per ciascuna regola, ad esempio **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, ecc. [comment]: # ({/ace84303-dbac533e}) [comment]: # ({3ed0c834-049a5192}) ##### AllowKey Consente l'esecuzione di quelle chiavi di item che corrispondono a un modello. Il modello della chiave è un'espressione con caratteri jolly che supporta il carattere "\*" per corrispondere a un numero qualsiasi di caratteri qualsiasi.
È possibile definire più regole di corrispondenza delle chiavi in combinazione con DenyKey. I parametri vengono elaborati uno per uno in base al loro ordine di apparizione. Vedi anche: [Limitazione dei controlli dell'agent](/manual/config/items/restrict_checks). [comment]: # ({/3ed0c834-049a5192}) [comment]: # ({fce8e2ee-9341dc8c}) ##### BufferSend Non conservare i dati nel buffer per più di N secondi. Predefinito: `5`
Intervallo: 1-3600 [comment]: # ({/fce8e2ee-9341dc8c}) [comment]: # ({3033154f-11405d19}) ##### BufferSize Il numero massimo di valori nel buffer di memoria. L'agent invierà tutti i dati raccolti al server o al proxy Zabbix se il buffer è pieno. Predefinito: `100`
Intervallo: 2-65535 [comment]: # ({/3033154f-11405d19}) [comment]: # ({9c071f70-b292af40}) ##### 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 [comment]: # ({/9c071f70-b292af40}) [comment]: # ({26eddabd-9a278481}) ##### DenyKey Nega l'esecuzione di quelle chiavi item che corrispondono a un pattern. Il pattern della chiave è un'espressione con caratteri jolly che supporta il carattere "\*" per corrispondere a un numero qualsiasi di caratteri qualsiasi.
È 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: [Limitazione dei controlli agent](/manual/config/items/restrict_checks). [comment]: # ({/26eddabd-9a278481}) [comment]: # ({80a7ec45-acca1798}) ##### EnableRemoteCommands Se i comandi remoti da Zabbix server sono consentiti. Questo parametro è **deprecato**; utilizzare 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-acca1798}) [comment]: # ({70ff69c8-672f4f6e}) ##### HeartbeatFrequency La frequenza dei messaggi heartbeat in secondi. Utilizzata per monitorare la disponibilità dei controlli attivi.
0 - messaggi heartbeat disabilitati. Predefinito: `60`
Intervallo: 0-3600 [comment]: # ({/70ff69c8-672f4f6e}) [comment]: # ({cd35abda-99752970}) ##### HostInterface Un parametro facoltativo che definisce l'interfaccia del host (indirizzo IP o nome DNS) utilizzata durante il processo di [autoregistration](/manual/discovery/auto_registration) del host. Questo valore verrà usato per popolare l'interfaccia nel host appena creato e consente di configurare esplicitamente un indirizzo IP o DNS. Per maggiori 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-99752970}) [comment]: # ({dc29c465-8ac8b769}) ##### HostInterfaceItem Un parametro facoltativo che definisce un item utilizzato per determinare l'interfaccia del host (indirizzo IP o nome DNS) durante il processo di [autoregistration](/manual/discovery/auto_registration) del host. Questo valore viene utilizzato solo se HostInterface non è definito. Per maggiori dettagli, vedere [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). Durante una richiesta di autoregistration, 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 di AllowKey/DenyKey. [comment]: # ({/dc29c465-8ac8b769}) [comment]: # ({ed067cab-098e9a8d}) ##### 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 [autoregistration](/manual/discovery/auto_registration) dell'host (agent attivo). HostMetadata consente di distinguere tra host oltre il nome host. Se non definito, il valore verrà acquisito da HostMetadataItem. L'agent genererà un errore e non si avvierà se il valore specificato supera il limite di 2034 byte o è una stringa non UTF-8. Quando un parametro prevede un indirizzo IP o un nome DNS, anche i valori che sono UTF-8 validi ma non sono indirizzi IP o nomi DNS validi verranno rifiutati e segnalati come non validi. I metadati su più righe non sono supportati: l'output verrà troncato alla prima interruzione di riga. Intervallo: 0-2034 byte [comment]: # ({/ed067cab-098e9a8d}) [comment]: # ({63cf5c75-9a501923}) ##### HostMetadataItem Un parametro facoltativo che definisce un item dell'agent Zabbix utilizzato per ottenere i [metadati del host](/manual/discovery/auto_registration#using-host-metadata). Questa opzione viene utilizzata solo quando HostMetadata non è definito. Il valore di HostMetadataItem viene recuperato a ogni tentativo di [autoregistrazione](/manual/discovery/auto_registration) e viene utilizzato solo nel processo di autoregistrazione del host (agent attivo). HostMetadataItem consente di distinguere tra host oltre il nome host. Sono supportati i parametri utente, i contatori delle prestazioni e gli alias. L'item [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) è supportato indipendentemente dalle impostazioni di 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 prevede un indirizzo IP o un nome DNS, i valori che sono UTF-8 validi ma non sono indirizzi IP o nomi DNS validi verranno anch'essi rifiutati e segnalati come non validi. I metadati su più righe non sono supportati: l'output verrà troncato alla prima interruzione di riga. [comment]: # ({/63cf5c75-9a501923}) [comment]: # ({39406dda-7ba40433}) ##### Hostname Un elenco di nomi host univoci, con distinzione tra maiuscole e minuscole, separati da virgole. Obbligatorio per i controlli attivi e deve corrispondere ai nomi host come configurati sul server. Il valore viene acquisito da HostnameItem se non definito.
Caratteri consentiti: alfanumerici, '.', ' ', '\_' e '-'. Lunghezza massima: 128 caratteri per nome host, 2048 caratteri per l'intera riga. Predefinito: impostato da HostnameItem [comment]: # ({/39406dda-7ba40433}) [comment]: # ({735aa26a-3d732bce}) ##### HostnameItem Un parametro opzionale che definisce un item di Zabbix agent utilizzato per ottenere il nome del host. Questa opzione viene utilizzata solo quando Hostname non è definito. I parametri utente, i contatori delle prestazioni 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.
Vedi anche una [descrizione più dettagliata](/manual/appendix/install/windows_agent#configuration). Predefinito: `system.hostname` [comment]: # ({/735aa26a-3d732bce}) [comment]: # ({04fac2f0-4f66fa26}) ##### Include È possibile includere singoli file o tutti i file in una directory nel file di configurazione (situato in `C:\Program Files\Zabbix Agent` per impostazione predefinita se Zabbix agent è installato utilizzando i pacchetti di installazione Windows MSI; situato nella cartella specificata durante l'installazione se Zabbix agent è installato come archivio zip). Tutti i file inclusi devono avere una sintassi corretta, altrimenti agent non si avvierà.
Per includere solo i file pertinenti nella directory specificata, è supportato il carattere jolly asterisco per la corrispondenza dei modelli.
Vedere le [note speciali](special_notes_include) sulle limitazioni. Esempio: ```default Include=C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.conf ``` [comment]: # ({/04fac2f0-4f66fa26}) [comment]: # ({fcd70e26-f18a2cd5}) ##### 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-f18a2cd5}) [comment]: # ({35f278c7-fa6fe20d}) ##### ListenIP Un elenco di indirizzi IP delimitati da virgole sui quali l'agent deve restare in ascolto. Predefinito: `0.0.0.0` [comment]: # ({/35f278c7-fa6fe20d}) [comment]: # ({5f95bc53-04498be8}) ##### ListenPort L'agent rimarrà in ascolto su questa porta per le connessioni dal server. Predefinito: `10050`
Intervallo: 1024-32767 [comment]: # ({/5f95bc53-04498be8}) [comment]: # ({a938b7df-7775e414}) ##### LogFile Il nome del file di log dell'agent. Predefinito: `c:\zabbix_agentd.log`
Obbligatorio: Sì, se LogType è impostato su *file*; altrimenti no [comment]: # ({/a938b7df-7775e414}) [comment]: # ({f7604f8f-9135a275}) ##### 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 [comment]: # ({/f7604f8f-9135a275}) [comment]: # ({35bbd94b-c654859c}) ##### LogRemoteCommands Abilita la registrazione come avvisi dei comandi shell eseguiti. I comandi verranno registrati solo se eseguiti da 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]: # ({/35bbd94b-c654859c}) [comment]: # ({2b4ff06b-ed73f4f7}) ##### LogType Il tipo di output del log:
*file* - scrive il log nel file specificato dal parametro LogFile;
*system* - scrive il log nel registro eventi di Windows;
*console* - scrive il log nell'output standard. Predefinito: `file` [comment]: # ({/2b4ff06b-ed73f4f7}) [comment]: # ({da4c41cb-6eaa719f}) ##### MaxLinesPerSecond Il numero massimo di nuove righe che l'agent invierà al server o al proxy Zabbix al secondo durante l'elaborazione dei controlli attivi 'log', 'logrt' ed 'eventlog'. Il valore fornito verrà sovrascritto dal parametro 'maxlines', specificato nella chiave item 'log', 'logrt' o 'eventlog'.
*Nota*: Zabbix elaborerà un numero di nuove righe 10 volte superiore a quello impostato in *MaxLinesPerSecond* per cercare la stringa richiesta negli item di log. Predefinito: `20`
Intervallo: 1-1000 [comment]: # ({/da4c41cb-6eaa719f}) [comment]: # ({444f6259-fb950f2f}) ##### PerfCounter Definisce un nuovo parametro che è il valore medio del contatore delle prestazioni di sistema per il periodo di tempo specificato (in secondi).
Sintassi: ,"", Ad esempio, se si desidera ricevere il numero medio di interrupt del processore al secondo per l’ultimo minuto, è possibile definire un nuovo parametro "interrupts" come segue:
```default PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60 ``` Si notino le virgolette doppie attorno al percorso del contatore delle prestazioni. Il nome del parametro (interrupts) deve essere utilizzato come chiave dell'item durante la creazione di un item. I campioni per il calcolo del valore medio verranno acquisiti ogni secondo.
È possibile eseguire "typeperf -qx" per ottenere l’elenco di tutti i contatori delle prestazioni disponibili in Windows. [comment]: # ({/444f6259-fb950f2f}) [comment]: # ({c2cc7bf4-0f61ea9b}) ##### PerfCounterEn Definisce un nuovo parametro che rappresenta il valore medio del contatore delle prestazioni di sistema per il periodo di tempo specificato (in secondi). Rispetto a PerfCounter, i percorsi dei contatori delle prestazioni devono essere in inglese. Supportato solo su **Windows Server 2008/Vista** e versioni successive.
Sintassi: ,"", Ad esempio, se si desidera ricevere il numero medio di interrupt del processore al secondo per l'ultimo minuto, è possibile definire un nuovo parametro "interrupts" come segue:
```default PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60 ``` Si notino le virgolette doppie attorno al percorso del contatore delle prestazioni. Il nome del parametro (interrupts) deve essere utilizzato come chiave dell'item durante la creazione di un item. I campioni per il calcolo del valore medio verranno acquisiti ogni secondo.
È possibile trovare l'elenco delle stringhe in inglese visualizzando la seguente chiave di registro: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`. [comment]: # ({/c2cc7bf4-0f61ea9b}) [comment]: # ({3d47a4c2-eba563a4}) ##### RefreshActiveChecks Con quale frequenza viene aggiornato l'elenco dei controlli attivi, in secondi. Si noti che, dopo un tentativo non riuscito di aggiornare i controlli attivi, il successivo tentativo di aggiornamento verrà effettuato dopo 60 secondi. Predefinito: `5`
Intervallo: 1-86400 [comment]: # ({/3d47a4c2-eba563a4}) [comment]: # ({30da197e-f2ed869a}) ##### Server Un elenco di indirizzi IP separati da virgole, facoltativamente in notazione CIDR, oppure di nomi DNS di server Zabbix o 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). Gli spazi sono consentiti. Esempio: ```default Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com ``` Obbligatorio: sì, se StartAgents non è esplicitamente impostato su 0 [comment]: # ({/30da197e-f2ed869a}) [comment]: # ({a5a48bee-35ed1929}) ##### 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 e una porta opzionale separata da due punti.
La configurazione del cluster è costituita da uno o più indirizzi dei membri del gruppo 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 utilizzino gruppi di proxy, non dovrebbe essere specificato più di un proxy Zabbix per ciascun server/cluster Zabbix. Se viene specificato un proxy Zabbix, allora non deve essere specificato il server/cluster Zabbix per quel proxy.
È possibile fornire più indirizzi separati da virgola per utilizzare in parallelo diversi server Zabbix indipendenti. Gli spazi sono consentiti.
Se la porta non è specificata, viene utilizzata la porta predefinita.
Gli indirizzi IPv6 devono essere racchiusi tra parentesi quadre se per quel host è specificata una porta. 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 ``` Intervallo: (\*) [comment]: # ({/a5a48bee-35ed1929}) [comment]: # ({76194937-10fc73c6}) ##### SourceIP L'indirizzo IP sorgente per: - le connessioni in uscita verso Zabbix server o Zabbix proxy; - l'esecuzione di connessioni durante l'esecuzione di alcuni item (web.page.get, net.tcp.port, ecc.). [comment]: # ({/76194937-10fc73c6}) [comment]: # ({908d1c66-d8dd10c4}) ##### StartAgents Il numero di istanze pre-fork di zabbix\_agentd che elaborano i controlli passivi. Se impostato a 0, i controlli passivi vengono disabilitati e l'agent non resterà in ascolto su alcuna porta TCP. Predefinito: `10`
Intervallo: 0-100 (\*) [comment]: # ({/908d1c66-d8dd10c4}) [comment]: # ({03e7119f-895d5e50}) ##### Timeout Specifica per quanto tempo attendere (in secondi) per stabilire la connessione e scambiare dati con Zabbix proxy o server.
Questo parametro definisce la durata di varie operazioni di comunicazione, tra cui: - attesa di una risposta dal server Zabbix; - invio di richieste al server Zabbix, incluse le richieste di configurazione degli item e i dati degli item nei [controlli attivi](/manual/appendix/items/activepassive#active-checks); - recupero dei dati di log tramite il monitoraggio di logfile o del registro eventi di Windows; - invio di messaggi heartbeat; - durata massima per i controlli `vfs.*`; - utilizzato dai moduli di Zabbix agent; - usato come fallback negli scenari in cui un server o proxy precedente alla versione 7.0 invia controlli senza timeout. Questo timeout **non** verrà utilizzato per quei controlli agent che hanno impostazioni di timeout configurabili nel frontend (a livello globale, di proxy o per-item). Predefinito: `3`
Intervallo: 1-30 [comment]: # ({/03e7119f-895d5e50}) [comment]: # ({2200adc7-fb75760f}) ##### TLSAccept Le connessioni in ingresso da accettare. Utilizzato 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 i parametri del certificato TLS o PSK (anche per la connessione *unencrypted*); altrimenti no [comment]: # ({/2200adc7-fb75760f}) [comment]: # ({65d07bda-8301867c}) ##### TLSCAFile Il percorso completo del file contenente i certificati della CA o delle CA di primo livello per la verifica del certificato del peer, utilizzato per le comunicazioni crittografate tra i componenti di Zabbix. [comment]: # ({/65d07bda-8301867c}) [comment]: # ({005f60f1-8da364a3}) ##### 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-8da364a3}) [comment]: # ({e2ebc18f-3f5548eb}) ##### TLSConnect Come l'agent deve connettersi al server o al proxy Zabbix. Utilizzato 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 i parametri del certificato TLS o della PSK (anche per la connessione *unencrypted*); altrimenti no [comment]: # ({/e2ebc18f-3f5548eb}) [comment]: # ({ad4dc889-95b41620}) ##### TLSCRLFile Il percorso completo del file contenente i certificati revocati. Questo parametro viene utilizzato per le comunicazioni cifrate tra i componenti di Zabbix. [comment]: # ({/ad4dc889-95b41620}) [comment]: # ({c2aa4315-89503f46}) ##### TLSKeyFile Il percorso completo del file contenente la chiave privata dell'agent, utilizzata per le comunicazioni crittografate tra i componenti di Zabbix. [comment]: # ({/c2aa4315-89503f46}) [comment]: # ({11defa44-2936868d}) ##### TLSPSKFile Il percorso completo del file contenente la chiave precondivisa dell'agent, utilizzata per le comunicazioni cifrate con Zabbix server. [comment]: # ({/11defa44-2936868d}) [comment]: # ({92d3eff0-262fa198}) ##### TLSPSKIdentity La stringa di identità della chiave precondivisa, utilizzata per le comunicazioni cifrate con Zabbix server. [comment]: # ({/92d3eff0-262fa198}) [comment]: # ({ae5c568f-9eef27fc}) ##### TLSServerCertIssuer L'autorità emittente del certificato del server (proxy) consentita. [comment]: # ({/ae5c568f-9eef27fc}) [comment]: # ({fb69617f-abaebd84}) ##### TLSServerCertSubject Il subject del certificato del server (proxy) consentito. [comment]: # ({/fb69617f-abaebd84}) [comment]: # ({8fffe818-a721fb91}) ##### 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-a721fb91}) [comment]: # ({e817d9a2-8f64ff97}) ##### 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,dir /b | find /c /v "" UserParameter=check_cpu,.\custom\_script.bat ``` [comment]: # ({/e817d9a2-8f64ff97}) [comment]: # ({275c0fce-9e2d0466}) ##### 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=C:\opt\myscripts ``` [comment]: # ({/275c0fce-9e2d0466}) [comment]: # ({6792d81f-7142df61}) ::: noteclassic (\*) Il numero di server attivi elencati in ServerActive più il numero di istanze pre-fork per i controlli passivi specificato in StartAgents deve essere inferiore a 64. ::: [comment]: # ({/6792d81f-7142df61})