Parámetros y configuración

Parámetros

--conf	Ruta al archivo de configuración
--target_databases	Ruta al archivolistado de configuración que contiene los targets de las bases de datos objetivo a monitorizar
--target_agents	Ruta al archivolistado de configuraciónagentes objetivo en los que contienealmacenar los targetsdatos de las bases de datos objetivo. Este parámetro es opcional, y se usará para dar nombres de agentes personalizados a los agentes generados por el plugin.
--custom_queries	Ruta al archivofichero con la definición de configuración que contiene las consultas personalizadas a las bases de datos objetivo. Este parámetro es opcional y cada consulta realizada se corresponderá con un módulo.

 

Archivo de configuración (--conf)

El contenido del fichero será el siguiente:

agents_group_id = < ID del grupo en el que iranse destinadoscrearán los agentes >
interval = < Intervalo ende segundosmonitorización en el que se crearande los agentes en segundos >
user = < Usuario de microsoft server sqlconexión >
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 losde módulos creados >
execute_custom_queries = < Activar con 1 para habilitar el uso de consultas personalizadas >
scan_databases 
agent_per_database 
db_agent_prefix 
analyze_connections = < Activar con 1 para habilitar ella chequeomonitorización de conexiones, se creará un módulo con esta informaciónconexiones >
engine_uptime = < Activar con 1 para habilitar ella monitorización del tiempo queen lleva ejecutandose, se creará un módulo con esta informacióejecución >
query_stats = < Activar con 1 para habilitar estadísticas de las consultas , se creará un módulo con esta información >
innodb_stats = < Activar con 1 para habilitar la monitorización de estadísticas de innodb , se creará un módulo con esta información >
cache_stats = < Activar con 1 para habilitar la monitorización de estadísticas de cache , se creará un módulo con esta información >

Ejemplo de archivo de configuraciónEjemplo:

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
innodb_stats = 1
cache_stats = 1

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

El archivo debe de tener el siguiente formato:

mysql:port

Ejemplo de archivo de configuraciónListado de bases de datos objetivo (--target_databases)

El contenido del fichero será un listado de bases de datos objetivo, separando cada base de datos por comas o por líneas. El formato para una base de datos podrá ser cualquiera de los siguientes:

ip:puerto
ip

En caso de no indicarse el puerto, se usará el puerto 3306 TCP por defecto para la conexión al objetivo.

Ejemplo:

172.17.0.4:33062, 172.17.0.2:3
172.17.0.4:3306

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

SeEl debencontenido introducirdel fichero será un listado de bases de nombres de agentes, separando cada agente por comas o por líneas. Estos nombres de agentes se usarán para volcar la 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 separadosde porforma comas,automática.

se

La puedenposición dividirde cada nombre de agente en cadael 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íneaneas en blanco son ignoradas.

Ejemplo de archivo de configuración de agentesEjemplo:

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 warning
max_warning
str_warning
warning_inverse
min_critical
max_critical
str_critical
critical_inverse
module_interval
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

EjemploEn caso de archivohabilitarse dela configuraciómonitorización de cada base de datos dentro de los servidores MySQL objetivo, las consultas personalizadas se lanzarán para cada una de dichas bases de datos. En esos casos, es posible referenciar a la base de datos en uso con la variable "$__self_dbname".

Ejemplo:

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_dbname
description Number of invalid objects
operation value
datatype generic_data
min_warning 5
target SELECT COUNT(*) FROM $__self_dbname.tagente;
target_databases pandora
check_end

check_begin
name Agents in $__self_dbname
description Invalid objects (detail)
operation full
datatype generic_data
target SELECT id_agente, nombre FROM $__self_dbname.tagente limit 10;
target_databases pandora
check_end