Skip to main content

Parámetros y configuración

Parámetros

--conf Ruta al archivo de configuración
--target_databases Ruta al archivo de configuración que contiene los targets de las bases de datos
--target_agents Ruta al archivo de configuración que contiene los targets de los agentes
--custom_queries Ruta al archivo de configuración que contiene las consultas personalizadas

 

Archivo de configuración

agents_group_id = < ID del grupo en el que iran destinados los agentes >
interval = < Intervalo en segundos en el que se crearan los agentes >
user = < Usuario de microsoft server sql >
password = < Contraseña de microsoft server sql >
threads = < Número de hilos que se usaran para la creación de agentes >
modules_prefix = < Prefijo que contendrán los módulos creados >
execute_custom_queries = < Activar con 1 para habilitar el uso de consultas personalizadas >
analyze_connections = < Activar con 1 para habilitar el chequeo de conexiones, se creará un módulo con esta información >
engine_uptime = < Activar con 1 para habilitar el tiempo que lleva ejecutandose, se creará un módulo con esta información >
query_stats = < Activar con 1 para habilitar estadísticas de las consultas , se creará un módulo con esta información >

Ejemplo de archivo de configuración

agents_group_id = 10
interval = 300
user = sa 
password = HHgD85V@
threads = 1
modules_prefix = 
execute_custom_queries = 1
analyze_connections = 1
engine_uptime = 1
query_stats = 1

Archivo de configuración con las bases de datos a las que se apuntará

El contenido del archivo ( cada línea)  debe de tener uno de los siguientes formatos:

mssql,ip
mssql:port,ip:puerto
mssql\instancia,ip\instancia
mssql:port\ip:puerto\instancia

Ejemplo de archivo de configuración de bases de datos

172.17.0.4:1433\test
172.17.0.2:1433\Daxter1

ArchivoListado de configuración con los agentes queobjetivo se apuntará(--target_agents)

SeEl debencontenido introducirdel losfichero será un listado de bases de nombres de agentes, separando cada agente por comas o por líneas. Estos nombres de agentes separados por comas, se puedenusarán dividirpara envolcar cadala línea

Ejemplo de archivo de configuracióinformación de cada base de datos objetivo en el nombre de agente indicado correspondiente, en lugar de dejar que el plugin genere los nombres de agentes de forma automática.

La posición de cada nombre de agente en el listado debe coincidir con la posición de la base de datos objetivo en su propio listado, es decir, el nombre para la primera base de datos objetivo será el primer nombre de este listado, teniendo en cuenta que las líneas en blanco son ignoradas.

Ejemplo:

agente1,,agente3
agente4
agente5,agente6,agente7,,agente9

Archivo de configuración con las consultasConsultas personalizadas (--custom_queries)

Se debe introducir un módulo por cada consulta personalizada que se pretenda monitorizar. Los módulos deben seguir una estructura, que es la siguiente:

check_begin      --> Etiqueta de abertura del módulo
name             --> Nombre del módulo
description      --> Descripción del módulo.
operation        --> Tipo de operación 
datatype         --> Tipo de módulo
min_warning      --> Configuración del umbral mínimo de warning
max_warning      --> Configuración del umbral máximo de warning
str_warning      --> Configuración de string del warning
warning_inverse  --> Activar el intervalo inverso con 1 para umbral de warning
min_critical     --> Configuración del umbral mínimo de critical
max_critical     --> Configuración del umbral máximo de warning
str_critical     --> Configuración de string de critical
critical_inverse --> Activar el intervalo inverso con 1 para umbral de crítico
module_interval  --> Este intervalo se calcula como un multiplicador del intervalo del agente. 
target           --> Consulta personalizada
target_databases --> Agentes de bases de datos en los que se creará el módulo
check_end        --> Etiqueta de cierre del módulo

Ejemplo de archivo de configuración de consultas personalizadas

check_begin
name Select 1 
$__self_dbname
description Number of invalid objects
operation value
datatype generic_data
min_warning 5
target SELECT 1;
target_databases all
check_end

check_begin
name Agents count in $__self_dbnameNumeroConexiones
description Number of invalid objectsconnections
operation value
datatype generic_data
min_warning 510
target SELECT COUNT(*) AS NumeroConexiones FROM $__self_dbname.tagente;sys.dm_exec_sessions WHERE is_user_process = 1;
target_databases pandora
check_end

check_begin
name Agentslista_table_size.MB
description table size in $__self_dbname
description Invalid objects (detail)MB
operation full
datatype generic_data
target SELECT id_agente,SUM(reserved_page_count) nombre* 8 / 1024.0 AS TamañoMB FROM $__self_dbname.tagentesys.dm_db_partition_stats limitWHERE 10;object_id = OBJECT_ID('lista');
target_databases pandora
check_end