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 di utilizzare la direttiva Include per aggiungere questo file alla configurazione di Zabbix agent 2.

Il plugin MSSQL è un plugin caricabile ed è disponibile, oltre a essere descritto in modo completo, nel repository del plugin MSSQL.

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.

Opzioni

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

Parametri

Parametro Obbligatorio Intervallo Predefinito Descrizione
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 d'ambiente ProgramFiles		 Specifica il percorso di 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 delle query personalizzate non verranno applicate finché il plugin non verrà 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, nessuna query verrà caricata dal percorso della directory delle query personalizzate.
Plugins.MSSQL.Default.CACertPath no Il percorso predefinito del file del certificato con 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 predefinito del database a cui connettersi.
Plugins.MSSQL.Default.Encrypt no Specifica il tipo predefinito di crittografia della connessione. 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 login;
strict - l'invio dei dati tra plugin e server è crittografato end-to-end utilizzando TDS8;
disable - l'invio dei dati tra plugin e server non è crittografato.
Plugins.MSSQL.Default.HostNameInCertificate no Il nome comune (CN) predefinito del certificato del server MSSQL.
Plugins.MSSQL.Default.Password no La password da inviare per impostazione predefinita a un server MSSQL protetto.
Plugins.MSSQL.Default.TLSMinVersion no La versione minima di TLS da utilizzare per impostazione predefinita. I valori possibili sono: 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate no Indica se il plugin debba considerare attendibile per impostazione predefinita il certificato del server senza convalidarlo. Valori possibili: true, false.
Plugins.MSSQL.Default.Uri no sqlserver://localhost:1433 L'URI predefinito a cui connettersi. L'unico schema supportato è sqlserver://. Uno 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 del plugin non utilizzate vengano chiuse.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath no Il percorso del file del certificato con chiave pubblica dell'autorità di certificazione (CA) che ha emesso il certificato del server MSSQL per la sessione denominata. Il certificato deve essere in formato PEM.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.Database no Il nome del database a cui connettersi per la sessione denominata.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt no Specifica il tipo di crittografia della connessione per la sessione denominata. 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 login;
strict - l'invio dei dati tra plugin e server è crittografato end-to-end utilizzando TDS8;
disable - l'invio dei dati tra plugin e server non è crittografato.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate no Il nome comune (CN) del certificato del server MSSQL per la sessione denominata.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.Password no La password da inviare a un server MSSQL protetto per la sessione denominata.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion no La versione minima di TLS da utilizzare per la sessione denominata. I valori possibili sono: 1.0, 1.1, 1.2, 1.3.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate no Indica se il plugin debba considerare attendibile il certificato del server senza convalidarlo per la sessione denominata. Valori possibili: true, false.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.Uri no sqlserver://localhost:1433 L'URI a cui connettersi per la sessione denominata. L'unico schema supportato è sqlserver://. Uno schema può essere omesso. Le credenziali incorporate verranno ignorate.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.MSSQL.Sessions.<SessionName>.User no Il nome utente da inviare a un server MSSQL protetto per la sessione denominata.
<SessionName> - definisce il nome di una sessione da utilizzare 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 timeout globale La durata, in secondi, di attesa della risposta di un server durante la connessione iniziale e nelle operazioni successive della sessione.

Vedi anche: