Complemento MSSQL

Descripción general

Los parámetros de configuración permiten personalizar el comportamiento del plugin MSSQL.

Se recomienda especificarlos en su propio archivo de configuración (por ejemplo, mssql.conf), en lugar de hacerlo en el archivo de configuración de agent 2. Luego, use la directiva Include para incluir este archivo en 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.

Todos los parámetros son opcionales, salvo que se indique explícitamente que el parámetro es obligatorio.

Esta página está estructurada de la siguiente manera:

  • Resumen de parámetros (para ver los detalles completos de un parámetro, haga clic en su nombre)
  • Detalles de parámetros
Parameter Description
Plugins.MSSQL.CustomQueriesDir Especifique la ruta al directorio que contiene archivos .sql definidos por el usuario con consultas personalizadas que el plugin puede ejecutar.
Plugins.MSSQL.CustomQueriesEnabled Habilite la ejecución de la clave de item mssql.custom.query.
Plugins.MSSQL.Default.CACertPath Especifique la ruta de archivo predeterminada al certificado de clave pública de la autoridad de certificación (CA) que emitió el certificado del server MSSQL.
Plugins.MSSQL.Default.Database Especifique el nombre de base de datos predeterminado.
Plugins.MSSQL.Default.Encrypt Especifique el nivel de cifrado predeterminado.
Plugins.MSSQL.Default.HostNameInCertificate Especifique de forma predeterminada el nombre común (CN) del certificado del server MSSQL.
Plugins.MSSQL.Default.Password Especifique la contraseña predeterminada.
Plugins.MSSQL.Default.TLSMinVersion Especifique de forma predeterminada la versión mínima de TLS.
Plugins.MSSQL.Default.TrustServerCertificate Confíe en el certificado del server sin validarlo de forma predeterminada.
Plugins.MSSQL.Default.Uri Especifique el URI predeterminado.
Plugins.MSSQL.Default.User Especifique el nombre de usuario predeterminado.
Plugins.MSSQL.KeepAlive Especifique el tiempo máximo de espera (en segundos) antes de cerrar las conexiones del plugin no utilizadas.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath Especifique la ruta de archivo de la sesión con nombre al certificado de clave pública de la autoridad de certificación (CA) que emitió el certificado del server MSSQL.
Plugins.MSSQL.Sessions.<SessionName>.Database Especifique el nombre de base de datos de la sesión con nombre.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt Especifique el nivel de cifrado de la sesión con nombre.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate Especifique el nombre común (CN) del certificado del server MSSQL para la sesión con nombre.
Plugins.MSSQL.Sessions.<SessionName>.Password Especifique la contraseña de la sesión con nombre.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion Especifique la versión mínima de TLS de la sesión con nombre.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate Confíe en el certificado del server de la sesión con nombre sin validarlo.
Plugins.MSSQL.Sessions.<SessionName>.Uri Especifique el URI de la sesión con nombre.
Plugins.MSSQL.Sessions.<SessionName>.User Especifique el nombre de usuario de la sesión con nombre.
Plugins.MSSQL.System.Path Especifique la ruta al ejecutable del plugin MSSQL.
Plugins.MSSQL.Timeout Establezca la duración, en segundos, de la espera para que un server responda al conectarse por primera vez y en las operaciones posteriores de la sesión.

Tenga en cuenta que:

  • Los valores predeterminados reflejan los valores predeterminados del proceso, no los valores de los archivos de configuración suministrados.
  • 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.

Detalles del parámetro

Plugins.MSSQL.CustomQueriesDir

Especifique la ruta al 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 iniciarse. Esto significa que cualquier cambio en los archivos de consultas personalizadas no se reflejará hasta que se reinicie el plugin. El plugin se inicia y se detiene junto con Zabbix agent 2.

Valores predeterminados:
/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)

Plugins.MSSQL.CustomQueriesEnabled

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.

Predeterminado: false
Rango: true/false

Plugins.MSSQL.Default.CACertPath

Especifique la ruta de archivo predeterminada al certificado de clave pública de la autoridad de certificación (CA) que emitió el certificado del server MSSQL.
El certificado debe estar en formato PEM.

Plugins.MSSQL.Default.Database

Especifique el nombre de la base de datos predeterminada.

Plugins.MSSQL.Default.Encrypt

Especifique el nivel de cifrado predeterminado.

Rango:
true - el envío de datos entre el plugin y el server está cifrado;
false - el envío de datos entre el plugin y el server no está cifrado más allá del paquete de inicio de sesión;
strict - el envío de datos entre el plugin y el server está cifrado de extremo a extremo usando TDS8;
disable - el envío de datos entre el plugin y el server no está cifrado.

Plugins.MSSQL.Default.HostNameInCertificate

Especifique de forma predeterminada el nombre común (CN) del certificado del server MSSQL.

Plugins.MSSQL.Default.Password

Especifique la contraseña predeterminada para un server MSSQL protegido.

Plugins.MSSQL.Default.TLSMinVersion

Especifica la versión mínima de TLS de forma predeterminada.

Rango: 1.0, 1.1, 1.2, 1.3

Plugins.MSSQL.Default.TrustServerCertificate

Confía en el certificado del server sin validarlo de forma predeterminada.

Rango: true, false

Plugins.MSSQL.Default.Uri

Especifique el URI predeterminado para conectarse al server MSSQL.
Las credenciales incrustadas se ignorarán.
El único esquema compatible es sqlserver://.
El esquema puede omitirse.

Predeterminado: sqlserver://localhost:1433

Plugins.MSSQL.Default.User

Especifique el nombre de usuario predeterminado para un servidor MSSQL protegido.

Plugins.MSSQL.KeepAlive

Especifica el tiempo máximo de espera (en segundos) antes de que se cierren las conexiones del plugin no utilizadas.

Predeterminado: 300
Rango: 60-900

Plugins.MSSQL.Sessions.<SessionName>.CACertPath

Especifique la ruta del archivo de sesión con nombre al certificado de clave pública de la autoridad de certificación (CA) que emitió el certificado del server MSSQL.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.
El certificado debe estar en formato PEM.

Plugins.MSSQL.Sessions.<SessionName>.Database

Especifica el nombre de la base de datos de la sesión con nombre.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

Plugins.MSSQL.Sessions.<SessionName>.Encrypt

Especifica el nivel de cifrado de la sesión con nombre.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

Rango:
true - los datos enviados entre el plugin y el server están cifrados;
false - los datos enviados entre el plugin y el server no están cifrados más allá del paquete de inicio de sesión;
strict - los datos enviados entre el plugin y el server están cifrados de extremo a extremo usando TDS8;
disable - los datos enviados entre el plugin y el server no están cifrados.

Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate

Especifique el nombre común (CN) del certificado del server MSSQL para la sesión con nombre.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Plugins.MSSQL.Sessions.<SessionName>.Password

Especifique la contraseña de la sesión con nombre para un servidor MSSQL protegido.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion

Especifica la versión mínima de TLS de la sesión con nombre.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

Rango: 1.0, 1.1, 1.2, 1.3

Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate

Confía en el certificado del servidor de la sesión especificada sin validarlo.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

Rango: true, false

Plugins.MSSQL.Sessions.<SessionName>.Uri

Especifique la URI de la sesión con nombre para conectarse al server MSSQL.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.
Las credenciales incrustadas se ignorarán.
El único esquema compatible es sqlserver://.
El esquema puede omitirse.

Predeterminado: sqlserver://localhost:1433

Plugins.MSSQL.Sessions.<SessionName>.User

Especifique el nombre de usuario de la sesión con nombre para un servidor MSSQL protegido.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Plugins.MSSQL.System.Path

Especifique la ruta al ejecutable del plugin MSSQL.
Configuración global para el plugin MSSQL. Se aplica a todas las conexiones.

Ejemplo: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql

Plugins.MSSQL.Timeout

Establezca la duración, en segundos, que se esperará a que un server responda al conectarse por primera vez y en las operaciones posteriores de la sesión.

Predeterminado: global timeout
Rango: 1-30

Opciones

Parameter Description
-V --version Muestra la versión del plugin y la información de la licencia.
-h --help Muestra la información de ayuda (forma abreviada).
-t, --test <item key> Inicia el plugin para pruebas (se ignora la configuración del plugin).

Véase también