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 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, 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 en charge uniquement 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

Parameter 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 provenant de la variable d'environnement ProgramFiles		 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 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 Chemin d'accès par défaut au 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 Nom de la base de données par défaut à laquelle se connecter.
Plugins.MSSQL.Default.Encrypt non Spécifie le type de chiffrement de connexion par défaut. Les valeurs possibles sont :
true - les données envoyées entre le plugin et le serveur sont chiffrées ;
false - les données envoyées entre le plugin et le serveur ne sont pas chiffrées au-delà du paquet de connexion ;
strict - les données envoyées entre le plugin et le serveur sont chiffrées de bout en bout à l'aide de TDS8 ;
disable - les données envoyées entre le plugin et le serveur ne sont pas chiffrées.
Plugins.MSSQL.Default.HostNameInCertificate non Nom commun (CN) par défaut du certificat du serveur MSSQL.
Plugins.MSSQL.Default.Password non Mot de passe à envoyer par défaut à un serveur MSSQL protégé.
Plugins.MSSQL.Default.TLSMinVersion non 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 par défaut au certificat du serveur sans le valider. Valeurs possibles : true, false.
Plugins.MSSQL.Default.Uri non sqlserver://localhost:1433 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 Nom d'utilisateur par défaut à envoyer à un serveur MSSQL protégé.
Plugins.MSSQL.KeepAlive non 60-900 300 Temps d'attente maximal (en secondes) avant la fermeture des connexions de plugin inutilisées.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath non 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 non 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 - les données envoyées entre le plugin et le serveur sont chiffrées ;
false - les données envoyées entre le plugin et le serveur ne sont pas chiffrées au-delà du paquet de connexion ;
strict - les données envoyées entre le plugin et le serveur sont chiffrées de bout en bout à l'aide de TDS8 ;
disable - les données envoyées entre le plugin et le serveur ne sont pas chiffrées.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate non 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 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 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 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 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 du 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'expiration global Durée, en secondes, pendant laquelle attendre qu'un serveur réponde lors de la connexion initiale et des opérations suivantes dans la session.

Voir aussi :