8 Plugin MSSQL

Panoramica

Il file di configurazione di Zabbix agent 2 viene utilizzato per configurare i plugin. Questi parametri di configurazione di Zabbix agent 2 sono supportati per il funzionamento del plugin MSSQL.

Si consiglia di specificarli in un file di configurazione dedicato (ad esempio mssql.conf) e quindi utilizzare la direttiva Include per aggiungere questo file alla configurazione di Zabbix agent 2.

Il plugin MSSQL è un plugin caricabile ed è disponibile e descritto in modo completo nel repository del plugin MSSQL.

Si noti che:

  • I valori predefiniti riflettono i valori di default del processo, non i valori presenti nei file di configurazione distribuiti.
  • I valori supportano le variabili di ambiente;
  • Zabbix supporta i file di configurazione solo in codifica UTF-8 senza BOM.
  • I commenti che iniziano con "#" sono supportati solo all'inizio della riga.

Opzioni

Parameter Description
-V --version Stampa la versione del plugin e le informazioni sulla licenza.
-h --help Stampa le informazioni di aiuto (forma abbreviata).
-t, --test <item key> Avvia il plugin per il test (la configurazione del plugin viene ignorata).

Parametri

Parameter Mandatory Range Default Description
Plugins.MSSQL.CustomQueriesDir no /usr/local/share/zabbix/custom-queries/mssql per sistemi Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL per sistemi Windows, dove * è il nome dell'unità dalla variabile di ambiente ProgramFiles		 Specifica il percorso del file a una directory contenente file .sql definiti dall'utente con query personalizzate che il plugin può eseguire. Il plugin carica tutti i file .sql disponibili nella directory configurata all'avvio. Ciò significa che eventuali modifiche ai file di query personalizzate non verranno applicate finché il plugin non viene riavviato. Il plugin viene avviato e arrestato insieme a Zabbix agent 2.
Plugins.MSSQL.CustomQueriesEnabled no false Se impostato, abilita l'esecuzione della chiave item mssql.custom.query. Se disabilitato, non verrà caricato alcun query dal percorso della directory delle query personalizzate.
Plugins.MSSQL.Default.CACertPath no Il percorso del file predefinito al certificato della chiave pubblica dell'autorità di certificazione (CA) che ha emesso il certificato del server MSSQL. Il certificato deve essere in formato PEM.
Plugins.MSSQL.Default.Database no Il nome del database predefinito a cui connettersi.
Plugins.MSSQL.Default.Encrypt no Specifica il tipo di crittografia della connessione predefinito. I valori possibili sono:
true - l'invio dei dati tra plugin e server è crittografato;
false - l'invio dei dati tra plugin e server non è crittografato oltre il pacchetto di accesso;
strict - l'invio dei dati tra plugin e server è crittografato end-to-end usando TDS8;
disable - l'invio dei dati tra plugin e server non è crittografato.
Plugins.MSSQL.Default.HostNameInCertificate no Il nome comune (CN) del certificato del server MSSQL per impostazione predefinita.
Plugins.MSSQL.Default.Password no La password da inviare a un server MSSQL protetto per impostazione predefinita.
Plugins.MSSQL.Default.TLSMinVersion no La versione minima di TLS da usare per impostazione predefinita. I valori possibili sono: 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate no Indica se il plugin deve considerare attendibile il certificato del server senza convalidarlo per impostazione predefinita. Valori possibili: true, false.
Plugins.MSSQL.Default.Uri no sqlserver://localhost:1433 L'URI predefinito a cui connettersi. L'unico schema supportato è sqlserver://. Lo schema può essere omesso. Le credenziali incorporate verranno ignorate.
Plugins.MSSQL.Default.User no Il nome utente predefinito da inviare a un server MSSQL protetto.
Plugins.MSSQL.KeepAlive no 60-900 300 Il tempo massimo di attesa (in secondi) prima che le connessioni plugin inutilizzate vengano chiuse.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath no Il percorso del file al certificato della chiave pubblica dell'autorità di certificazione (CA) che ha emesso il certificato del server MSSQL per la sessione specificata. Il certificato deve essere in formato PEM.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.Database no Il nome del database a cui connettersi per la sessione specificata.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt no Specifica il tipo di crittografia della connessione per la sessione specificata. I valori possibili sono:
true - l'invio dei dati tra plugin e server è crittografato;
false - l'invio dei dati tra plugin e server non è crittografato oltre il pacchetto di accesso;
strict - l'invio dei dati tra plugin e server è crittografato end-to-end usando TDS8;
disable - l'invio dei dati tra plugin e server non è crittografato.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate no Il nome comune (CN) del certificato del server MSSQL per la sessione specificata.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.Password no La password da inviare a un server MSSQL protetto per la sessione specificata.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion no La versione minima di TLS da usare per la sessione specificata. I valori possibili sono: 1.0, 1.1, 1.2, 1.3.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate no Indica se il plugin deve considerare attendibile il certificato del server senza convalidarlo per la sessione specificata. Valori possibili: true, false.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.Uri no sqlserver://localhost:1433 L'URI a cui connettersi per la sessione specificata. L'unico schema supportato è sqlserver://. Lo schema può essere omesso. Le credenziali incorporate verranno ignorate.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.User no Il nome utente da inviare a un server MSSQL protetto per la sessione specificata.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.MSSQL.System.Path no Percorso dell'eseguibile del plugin MSSQL.
Impostazione globale per il plugin MSSQL. Applicata a tutte le connessioni.
Esempio di utilizzo: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout no 1-30 global timeout La durata, in secondi, da attendere affinché un server risponda durante la connessione iniziale e nelle operazioni successive nella sessione.

Vedi anche: