Table of Contents
8 Plugin MSSQL
Descripción general
Esta sección enumera los parámetros admitidos en el archivo de configuración del plugin MSSQL Zabbix agent 2 (mssql.conf).
El plugin MSSQL es un plugin cargable y está disponible y completamente descrito en el repositorio del plugin MSSQL.
Tenga en cuenta que:
- Los valores predeterminados reflejan los valores por defecto del proceso, no los valores en los archivos de configuración distribuidos;
- Los valores admiten variables de entorno;
- Zabbix admite archivos de configuración solo en codificación UTF-8 sin BOM;
- Los comentarios que comienzan con "#" solo se admiten al principio de la línea.
Parámetros
| Parámetro | Obligatorio | Rango | Por defecto | Descripción |
|---|---|---|---|---|
| Plugins.MSSQL.CustomQueriesDir | no | /usr/local/share/zabbix/custom-queries/mssql para sistemas Unix*:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL para sistemas Windows, donde * es el nombre de la unidad de la variable de entorno ProgramFiles |
Especifica la ruta de archivo a un directorio que contiene archivos .sql definidos por el usuario con consultas personalizadas que el plugin puede ejecutar. El plugin carga todos los archivos .sql disponibles en el directorio configurado al iniciar. Esto significa que cualquier cambio en los archivos de consulta personalizada no se reflejará hasta que se reinicie el plugin. El plugin se inicia y detiene junto con Zabbix agent 2. | |
| Plugins.MSSQL.CustomQueriesEnabled | no | false | Si se establece, habilita la ejecución de la clave de métrica mssql.custom.query. Si está deshabilitado, no se cargarán consultas desde la ruta del directorio de consultas personalizadas. |
|
| Plugins.MSSQL.Default.CACertPath | no | La ruta de archivo por defecto al certificado de clave pública de la autoridad certificadora (CA) que emitió el certificado del servidor MSSQL. El certificado debe estar en formato PEM. | ||
| Plugins.MSSQL.Default.Database | no | El nombre de la base de datos por defecto a la que conectarse. | ||
| Plugins.MSSQL.Default.Encrypt | no | Especifica el tipo de cifrado de conexión por defecto. Los valores posibles son: true - el envío de datos entre el plugin y el servidor está cifrado; false - el envío de datos entre el plugin y el servidor no está cifrado más allá del paquete de inicio de sesión; strict - el envío de datos entre el plugin y el servidor está cifrado E2E usando TDS8; disable - el envío de datos entre el plugin y el servidor no está cifrado. |
||
| Plugins.MSSQL.Default.HostNameInCertificate | no | El nombre común (CN) del certificado del servidor MSSQL por defecto. | ||
| Plugins.MSSQL.Default.Password | no | La contraseña que se enviará a un servidor MSSQL protegido por defecto. | ||
| Plugins.MSSQL.Default.TLSMinVersion | no | La versión mínima de TLS a utilizar por defecto. Los valores posibles son: 1.0, 1.1, 1.2, 1.3. |
||
| Plugins.MSSQL.Default.TrustServerCertificate | no | Indica si el plugin debe confiar en el certificado del servidor sin validarlo por defecto. Valores posibles: true, false. |
||
| Plugins.MSSQL.Default.Uri | no | sqlserver://localhost:1433 | La URI por defecto a la que conectarse. El único esquema soportado es sqlserver://. Se puede omitir el esquema. Las credenciales embebidas serán ignoradas. |
|
| Plugins.MSSQL.Default.User | no | El nombre de usuario por defecto que se enviará a un servidor MSSQL protegido. | ||
| Plugins.MSSQL.KeepAlive | no | 60-900 | 300 | El tiempo máximo de espera (en segundos) antes de que se cierren las conexiones del plugin no utilizadas. |
| Plugins.MSSQL.Sessions.<SessionName>.CACertPath | no | La ruta de archivo al certificado de clave pública de la autoridad certificadora (CA) que emitió el certificado del servidor MSSQL para la sesión nombrada. El certificado debe estar en formato PEM. <SessionName> - define el nombre de una sesión para usar en claves de métricas. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Database | no | El nombre de la base de datos a la que conectarse para la sesión nombrada. <SessionName> - define el nombre de una sesión para usar en claves de métricas. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Encrypt | no | Especifica el tipo de cifrado de conexión para la sesión nombrada. Los valores posibles son: true - el envío de datos entre el plugin y el servidor está cifrado; false - el envío de datos entre el plugin y el servidor no está cifrado más allá del paquete de inicio de sesión; strict - el envío de datos entre el plugin y el servidor está cifrado E2E usando TDS8; disable - el envío de datos entre el plugin y el servidor no está cifrado. <SessionName> - define el nombre de una sesión para usar en claves de métricas. |
||
| Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate | no | El nombre común (CN) del certificado del servidor MSSQL para la sesión nombrada. <SessionName> - define el nombre de una sesión para usar en claves de métricas. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Password | no | La contraseña que se enviará a un servidor MSSQL protegido para la sesión nombrada. <SessionName> - define el nombre de una sesión para usar en claves de métricas. |
||
| Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion | no | La versión mínima de TLS a utilizar para la sesión nombrada. Los valores posibles son: 1.0, 1.1, 1.2, 1.3.<SessionName> - define el nombre de una sesión para usar en claves de métricas. |
||
| Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate | no | Indica si el plugin debe confiar en el certificado del servidor sin validarlo para la sesión nombrada. Valores posibles: true, false.<SessionName> - define el nombre de una sesión para usar en claves de métricas. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Uri | no | sqlserver://localhost:1433 | La URI a la que conectarse, para la sesión nombrada. El único esquema soportado es sqlserver://. Se puede omitir el esquema. Las credenciales embebidas serán ignoradas.<SessionName> - define el nombre de una sesión para usar en claves de métricas. |
|
| Plugins.MSSQL.Sessions.<SessionName>.User | no | El nombre de usuario que se enviará a un servidor MSSQL protegido para la sesión nombrada. <SessionName> - define el nombre de una sesión para usar en claves de métricas. |
||
| Plugins.MSSQL.System.Path | no | Ruta al ejecutable del plugin MSSQL. Configuración global para el plugin MSSQL. Se aplica a todas las conexiones. Ejemplo de uso: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql |
||
| Plugins.MSSQL.Timeout | no | 1-30 | timeout global | La duración, en segundos, para esperar la respuesta de un servidor al conectarse por primera vez y en operaciones posteriores en la sesión. |
Ver también:
- Descripción de los parámetros generales de configuración de Zabbix agent 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- Instrucciones para configurar plugins