Skip to main content

Paremeters and configuration

Parameters

--conf RutaPath alto archivoconfiguration de configuraciónfile
--target_databases RutaPath alto listadothe delist basesof detarget datosdatabases objetivoto abe monitorizarmonitored
--target_agents RutaPath alto listadothe delist agentesof objetivotarget enagents losin quewhich almacenarto losstore datosthe detarget lasdatabase basesdata. deThis datosparameter objetivo.is Esteoptional, parámetroand eswill opcional,be yused seto usarágive paracustom daragent nombresnames deto agentesthe personalizadosagents agenerated losby agentes generados por elthe plugin.
--custom_queries RutaPath alto ficherothe confile lawith definiciónthe dedefinition consultasof personalizadascustomized queries to the target databases. This parameter is optional and each query performed will correspond to a las bases de datos objetivo. Este parámetro es opcional y cada consulta realizada se corresponderá con un módulo.module.

ArchivoConfiguration de configuraciónfile (--conf)

ElThe contenidocontents delof ficherothe seráfile elwill siguiente:be as follows:

agents_group_id = < ID delof grupothe engroup elin quewhich sethe crearánagents loswill agentesbe created >
interval = < IntervaloAgents demonitoring monitorizacióninterval dein los agentes en segundosseconds >
user = < UsuarioLogin de conexiónuser >
password = < ContraseñaPassword >
threads = < NúmeroNumber deof hilosthreads queto sebe usaranused parafor laagent creación de agentescreation >
modules_prefix = < PrefijoModule de módulosprefix >
execute_custom_queries = < ActivarActivate conwith 1 parato habilitarenable elthe usouse deof consultascustom personalizadasqueries >
scan_databases = < ActivarEnable conwith 1 parato monitorizarmonitor todasall lasdatabases baseson de datos delthe server >
agent_per_database = < ActivarEnable conwith 1 parato crearcreate unan agenteagent porfor cadaeach basedatabase defound datosin encontradathe entargets losto objetivosbe a monitorizarmonitored >
db_agent_prefix = < PrefijoPrefix queto sebe incluiraincluded enin elthe nombrename deof cadaeach agenteagent creadocreated parafor cadaeach basedatabase defound datosin encontradathe entargets losto objetivosbe a monitorizarmonitored >
analyze_connections = < ActivarActivate conwith 1 parato habilitarenable laconnection monitorización de conexionesmonitoring >
engine_uptime = < ActivarActivate conwith 1 parato habilitarenable lathe monitorizaciónmonitoring delof tiempothe enexecution ejecucióntime >
query_stats = < ActivarEnable conwith 1 parato habilitarenable laquery moitorizaciónstatistics de estadísticas de consultasmonitoring >
innodb_stats = < ActivarEnable conwith 1 parato habilitar la monitorización de estadísticas deenable innodb statistics monitoring >
cache_stats = < ActivarActivate conwith 1 parato habilitar la monitorización de estadísticas deenable cache statistics monitoring >

Ejemplo:Example:

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
scan_databases = 1
agent_per_database = 1
db_agent_prefix = mysql.

ListadoList deof basestarget de datos objetivodatabases (--target_databases)target_databases)

ElThe contenidocontent delof ficherothe seráfile unwill listadobe dea baseslist deof datostarget objetivo,databases, separandoseparating cadaeach basedatabase deby datoscommas poror comasby olines. porThe líneas.format Elfor formatoa paradatabase unacan basebe deany datosof podráthe ser cualquiera de los siguientes:following:

ip:puertoport
ip

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

Ejemplo:Example:

172.17.0.2, 172.17.0.3
172.17.0.4:3306

ListadoList deof agentestarget objetivoagents (--target_agents)target_agents)

ElThe contenidocontent delof ficherothe seráfile unwill listadobe dea baseslist deof nombresagent dename agentes,bases, separandoseparating cadaeach agenteagent porby comascommas oor porby líneas.lines. EstosThese nombresagent denames agenteswill sebe usaránused parato volcardump lathe informacióninformation defrom cadaeach basetarget dedatabase datosinto objetivothe encorresponding elindicated nombreagent dename, agenteinstead indicadoof correspondiente,letting en lugar de dejar que elthe plugin generegenerate losthe nombresagent denames agentes de forma automática.automatically.

LaThe posiciónposition deof cadaeach nombreagent dename agentein enthe ellisting listadomust debematch coincidirthe conposition laof posiciónthe detarget ladatabase basein deits datosown objetivolisting, eni.e. suthe propioname listado,for esthe decir,first eltarget nombredatabase parawill labe primerathe basefirst dename datosin objetivothis serálisting, eltaking primerinto nombreaccount dethat esteblank listado,lines teniendoare en cuenta que las líneas en blanco son ignoradas.ignored.

Ejemplo:Example:

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

ConsultasCustom personalizadasqueries (--custom_queries)

SeA debemodule introducirmust unbe móduloentered porfor cadaeach consultacustom personalizadaquery queto sebe pretendamonitored. monitorizar.The Losmodules módulosmust debenfollow seguira unastructure, estructura,which queis esas la siguiente:follows:

check_begin --> EtiquetaModule deopening abertura del módulolabel
name --> NombreModule del móduloname
description --> DescripciónModule del módulo.description.
operation --> TipoOperation de operacióntype 
datatype --> TipoModule de módulotype
min_warning --> Configuración del umbral mínimo deMinimum warning threshold setting
max_warning --> Configuración del umbral máximo deMaximum warning threshold configuration
str_warning --> Configuración deWarning string de warningconfiguration
warning_inverse --> ActivarEnable elinverse intervalointerval inverso conwith 1 para umbral defor warning threshold
min_critical --> Configuración del umbral mínimo deMinimum critical threshold setting
max_critical --> Configuración del umbral máximo deMaximum critical threshold configuration
str_critical --> Configuración deCritical string de criticalconfiguration
critical_inverse --> ActivarActivate elinverse intervalointerval inverso conwith 1 parafor umbralcritical de críticothreshold
module_interval --> EsteThis intervalointerval seis calculacalculated comoas una multiplicadormultiplier delof intervalothe delagent agente.interval. 
target --> ConsultaCustom personalizadaquery
target_databases --> AgentesDatabase deagents basesin dewhich datosthe enmodule loswill quebe se creará el módulocreated.
check_end --> EtiquetaModule's declosing cierre del módulotag.

EnIn casocase demonitoring habilitarseof laeach monitorizacióndatabase dewithin cadathe base de datos dentro de los servidorestarget MySQL objetivo,servers lasis consultasenabled, personalizadascustom sequeries lanzaránwill parabe cadalaunched unafor deeach dichasof basesthose dedatabases. datos.In Ensuch esoscases, casos,it esis posiblepossible referenciarto areference lathe basedatabase dein datosuse enwith uso con lathe variable "$__self_dbname"__self_dbname".

Ejemplo:Example:

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