8 Plugin MSSQL

Descripción general

El archivo de configuración de Zabbix agent 2 se utiliza para configurar plugins. Estos parámetros de configuración de Zabbix agent 2 son compatibles para operar el plugin MSSQL.

Se recomienda especificarlos en su propio archivo de configuración (por ejemplo, mssql.conf) y luego usar la directiva Include para agregar este archivo a la configuración de Zabbix agent 2.

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 predeterminados del proceso, no los valores en los archivos de configuración proporcionados.
  • Los valores admiten variables de entorno;
  • Zabbix solo admite archivos de configuración en codificación UTF-8 sin BOM.
  • Los comentarios que comienzan con "#" solo se admiten al principio de la línea.

Opciones

Parámetro Descripción
-V --version Imprime la versión del plugin y la información de la licencia.
-h --help Imprime la información de ayuda (abreviatura).
-t, --test <item key> Lanza el plugin para pruebas (se ignora la configuración del plugin).

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 inicio. 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 item 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 usar por defecto. Los valores posibles son: 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate no 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 incrustadas 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 de 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> - defina el nombre de una sesión para usar en las claves de item.
Plugins.MSSQL.Sessions.<SessionName>.Database no El nombre de la base de datos a la que conectarse para la sesión nombrada.
<SessionName> - defina el nombre de una sesión para usar en las claves de item.
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> - defina el nombre de una sesión para usar en las claves de item.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate no El nombre común (CN) del certificado del servidor MSSQL para la sesión nombrada.
<SessionName> - defina el nombre de una sesión para usar en las claves de item.
Plugins.MSSQL.Sessions.<SessionName>.Password no La contraseña que se enviará a un servidor MSSQL protegido para la sesión nombrada.
<SessionName> - defina el nombre de una sesión para usar en las claves de item.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion no La versión mínima de TLS a usar para la sesión nombrada. Los valores posibles son: 1.0, 1.1, 1.2, 1.3.
<SessionName> - defina el nombre de una sesión para usar en las claves de item.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate no Si el plugin debe confiar en el certificado del servidor sin validarlo para la sesión nombrada. Valores posibles: true, false.
<SessionName> - defina el nombre de una sesión para usar en las claves de item.
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 incrustadas serán ignoradas.
<SessionName> - defina el nombre de una sesión para usar en las claves de item.
Plugins.MSSQL.Sessions.<SessionName>.User no El nombre de usuario que se enviará a un servidor MSSQL protegido para la sesión nombrada.
<SessionName> - defina el nombre de una sesión para usar en las claves de item.
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 a que un servidor responda al conectarse por primera vez y en las operaciones posteriores en la sesión.

Ver también: