8 Plugin MSSQL

Vue d'ensemble

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 le fonctionnement du 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 et 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 présentes dans les fichiers de configuration fournis.
  • Les valeurs prennent en charge les variables d'environnement ;
  • Zabbix prend en charge les fichiers de configuration uniquement en encodage 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

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

*:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL for Windows systems, where * is the drive name from the ProgramFiles environment variable		 Spécifie le chemin d'accès à 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 no false Si cette option est définie, elle active l'exécution de la clé d'élément mssql.custom.query. Si elle est désactivée, aucune requête ne sera chargée depuis le chemin du répertoire des requêtes personnalisées.
Plugins.MSSQL.Default.CACertPath no Chemin d'accès 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 no Nom de la base de données par défaut à laquelle se connecter.
Plugins.MSSQL.Default.Encrypt no Spécifie le type de chiffrement de connexion par défaut. Les valeurs possibles sont :
true - l'envoi des données entre le plugin et le serveur est chiffré;
false - l'envoi des données entre le plugin et le serveur n'est pas chiffré au-delà du paquet de connexion;
strict - l'envoi des données entre le plugin et le serveur est chiffré de bout en bout à l'aide de TDS8;
disable - l'envoi des données entre le plugin et le serveur n'est pas chiffré.
Plugins.MSSQL.Default.HostNameInCertificate no Nom commun (CN) du certificat du serveur MSSQL par défaut.
Plugins.MSSQL.Default.Password no Mot de passe à envoyer par défaut à un serveur MSSQL protégé.
Plugins.MSSQL.Default.TLSMinVersion no Version minimale de TLS à utiliser par défaut. Les valeurs possibles sont : 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate no 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 no sqlserver://localhost:1433 URI par défaut pour la connexion. Le seul schéma pris en charge est sqlserver://. Un schéma peut être omis. Les identifiants intégrés seront ignorés.
Plugins.MSSQL.Default.User no Nom d'utilisateur par défaut à envoyer à un serveur MSSQL protégé.
Plugins.MSSQL.KeepAlive no 60-900 300 Temps d'attente maximal (en secondes) avant la fermeture des connexions de plugin inutilisées.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath no Chemin d'accès au 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 no 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 no Spécifie le type de chiffrement de connexion pour la session nommée. Les valeurs possibles sont :
true - l'envoi des données entre le plugin et le serveur est chiffré;
false - l'envoi des données entre le plugin et le serveur n'est pas chiffré au-delà du paquet de connexion;
strict - l'envoi des données entre le plugin et le serveur est chiffré de bout en bout à l'aide de TDS8;
disable - l'envoi des 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 no 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 no 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 no 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 no 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 no sqlserver://localhost:1433 URI de connexion pour la session nommée. Le seul schéma pris en charge est sqlserver://. Un schéma peut être omis. Les identifiants intégrés seront ignorés.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.Sessions.<SessionName>.User no 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 no Chemin vers l'exécutable du plugin MSSQL.
Paramètre global pour le plugin MSSQL. Appliqué à toutes les connexions.
Exemple d'utilisation : Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout no 1-30 global timeout Durée, en secondes, d'attente d'une réponse d'un serveur lors de la première connexion et des opérations suivantes dans la session.

Voir aussi :