8 Plugin MSSQL

Aperçu

Le fichier de configuration de Zabbix agent 2 est utilisé pour configurer les plugins. Ces paramètres de configuration de Zabbix agent 2 sont pris en charge pour faire fonctionner le plugin MSSQL.

Il est recommandé de les spécifier dans leur propre fichier de configuration (par exemple, mssql.conf), puis d'utiliser la directive Include pour ajouter ce fichier à la configuration de Zabbix agent 2.

Le plugin MSSQL est un plugin chargeable ; il est disponible et entièrement décrit dans le dépôt du plugin MSSQL.

Notez que :

  • Les valeurs par défaut reflètent les valeurs par défaut du processus, et non les valeurs des fichiers de configuration fournis.
  • Les valeurs prennent en charge les variables d'environnement ;
  • Zabbix prend uniquement en charge les fichiers de configuration encodés en UTF-8 sans BOM.
  • Les commentaires commençant par "#" ne sont pris en charge qu'au début de la ligne.

Options

Paramètre Description
-V --version Affiche la version du plugin et les informations de licence.
-h --help Affiche les informations d'aide (forme abrégée).
-t, --test <item key> Lance le plugin pour les tests (configuration du plugin ignorée).

Paramètres

Paramètre Obligatoire Plage Par défaut Description
Plugins.MSSQL.CustomQueriesDir non /usr/local/share/zabbix/custom-queries/mssql pour les systèmes Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL pour les systèmes Windows, où * est le nom du lecteur issu de la variable d'environnement ProgramFiles		 Spécifie le chemin vers un répertoire contenant des fichiers .sql définis par l'utilisateur avec des requêtes personnalisées que le plugin peut exécuter. Le plugin charge tous les fichiers .sql disponibles dans le répertoire configuré au démarrage. Cela signifie que toute modification des fichiers de requêtes personnalisées ne sera pas prise en compte tant que le plugin n'aura pas été redémarré. Le plugin est démarré et arrêté avec Zabbix agent 2.
Plugins.MSSQL.CustomQueriesEnabled non false Si défini, active l'exécution de la clé d'élément mssql.custom.query. Si désactivé, aucune requête ne sera chargée depuis le chemin du répertoire des requêtes personnalisées.
Plugins.MSSQL.Default.CACertPath non Le chemin par défaut vers le certificat de clé publique de l'autorité de certification (CA) qui a émis le certificat du serveur MSSQL. Le certificat doit être au format PEM.
Plugins.MSSQL.Default.Database non Le nom de base de données par défaut auquel se connecter.
Plugins.MSSQL.Default.Encrypt non Spécifie le type de chiffrement de connexion par défaut. Les valeurs possibles sont :
true - l'envoi de données entre le plugin et le serveur est chiffré ;
false - l'envoi de données entre le plugin et le serveur n'est pas chiffré au-delà du paquet de connexion ;
strict - l'envoi de données entre le plugin et le serveur est chiffré de bout en bout à l'aide de TDS8 ;
disable - l'envoi de données entre le plugin et le serveur n'est pas chiffré.
Plugins.MSSQL.Default.HostNameInCertificate non Le nom commun (CN) du certificat du serveur MSSQL par défaut.
Plugins.MSSQL.Default.Password non Le mot de passe à envoyer par défaut à un serveur MSSQL protégé.
Plugins.MSSQL.Default.TLSMinVersion non La version minimale de TLS à utiliser par défaut. Les valeurs possibles sont : 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate non Indique si le plugin doit faire confiance au certificat du serveur sans le valider par défaut. Valeurs possibles : true, false.
Plugins.MSSQL.Default.Uri non sqlserver://localhost:1433 L'URI de connexion par défaut. Le seul schéma pris en charge est sqlserver://. Un schéma peut être omis. Les informations d'identification intégrées seront ignorées.
Plugins.MSSQL.Default.User non Le nom d'utilisateur par défaut à envoyer à un serveur MSSQL protégé.
Plugins.MSSQL.KeepAlive non 60-900 300 Le temps d'attente maximal (en secondes) avant la fermeture des connexions de plugin inutilisées.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath non Le chemin vers le certificat de clé publique de l'autorité de certification (CA) qui a émis le certificat du serveur MSSQL pour la session nommée. Le certificat doit être au format PEM.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.Sessions.<SessionName>.Database non Le nom de la base de données à laquelle se connecter pour la session nommée.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt non Spécifie le type de chiffrement de connexion pour la session nommée. Les valeurs possibles sont :
true - l'envoi de données entre le plugin et le serveur est chiffré ;
false - l'envoi de données entre le plugin et le serveur n'est pas chiffré au-delà du paquet de connexion ;
strict - l'envoi de données entre le plugin et le serveur est chiffré de bout en bout à l'aide de TDS8 ;
disable - l'envoi de données entre le plugin et le serveur n'est pas chiffré.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate non Le nom commun (CN) du certificat du serveur MSSQL pour la session nommée.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.Sessions.<SessionName>.Password non Le mot de passe à envoyer à un serveur MSSQL protégé pour la session nommée.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion non La version minimale de TLS à utiliser pour la session nommée. Les valeurs possibles sont : 1.0, 1.1, 1.2, 1.3.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate non Indique si le plugin doit faire confiance au certificat du serveur sans le valider pour la session nommée. Valeurs possibles : true, false.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.Sessions.<SessionName>.Uri non sqlserver://localhost:1433 L'URI de connexion pour la session nommée. Le seul schéma pris en charge est sqlserver://. Un schéma peut être omis. Les informations d'identification intégrées seront ignorées.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.Sessions.<SessionName>.User non Le nom d'utilisateur à envoyer à un serveur MSSQL protégé pour la session nommée.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.System.Path non Chemin vers l'exécutable du plugin MSSQL.
Paramètre global pour le plugin MSSQL. S'applique à toutes les connexions.
Exemple d'utilisation : Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout non 1-30 délai d'attente global Durée, en secondes, pendant laquelle attendre qu'un serveur réponde lors de la connexion initiale et lors des opérations suivantes dans la session.

Voir aussi :