Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
Docs Menu
Docs Home
/ /

Supervisar eventos de aplicaciones

En esta guía, puede aprender a configurar la supervisión en el controlador de sincronización de Kotlin.

La supervisión es el proceso de obtener información sobre las actividades que realiza un programa en ejecución para su uso en una aplicación o en una librería de gestión de rendimiento de aplicaciones.

Puedes usar el controlador Kotlin Sync para monitorizar los eventos de clúster, comandos del controlador y del pool de conexiones. Estas funcionalidades te ayudan a tomar decisiones informadas al diseñar y depurar tu aplicación.

Esta guía muestra cómo realizar las siguientes tareas:

  • Supervisa eventos específicos usando el driver de sincronización Kotlin

  • Supervisar eventos de pools de conexiones con Java Gestión Extensions (JMX) y JConsole

Tip

Esta guía muestra cómo usar la información sobre la metaactividad del conductor. Para aprender a registrar transacciones de datos, consulte Página deseguimiento de cambios en los datos.

Para supervisar un evento, debes registrar un escuchador en tu MongoClient instancia.

Un evento es cualquier acción que ocurre en un programa en ejecución. El controlador incluye funcionalidad para escuchar un subconjunto de los eventos que ocurren cuando el controlador está en funcionamiento.

Un oyente es una clase que realiza una acción cuando ocurren ciertos eventos. Su API define los eventos a los que puede responder.

Cada método de una clase oyente representa una respuesta a un determinado evento, y acepta como argumento un objeto de evento que representa dicho evento.

El driver Kotlin sincronizar organiza los eventos que define en tres categorías:

  • Eventos de comando

  • Eventos de detección y monitorización de servidores

  • Eventos del pool de conexiones

Las siguientes secciones muestran cómo supervisar cada categoría de evento. Para obtener una lista completa de los eventos que puede supervisar, consulta el paquete Java de eventos.

Un evento de comando es un evento relacionado con un comando de base de datos MongoDB. Algunos ejemplos de comandos de base de datos que producen eventos de comando son find, insert, delete y count.

Para supervisar los eventos de comando, crea una clase que implemente la interfaz CommandListener y registra una instancia de esa clase en tu instancia de MongoClient.

Para obtener más información sobre los comandos de base de datos de MongoDB, consulte la entrada del manual de MongoDB sobre comandos de base de datos en el manual del servidor MongoDB.

Nota

Comandos internos

El driver no publica eventos de los comandos que llama internamente. Esto incluye comandos de base de datos que el driver utiliza para supervisar tu clúster y comandos relacionados con el establecimiento de conexión, como el comando inicial hello.

Importante

Salida redactada

Como medida de seguridad, el controlador oculta el contenido de algunos eventos de comando. Esto protege la información sensible contenida en estos eventos de órdenes. Para obtener una lista completa de los eventos de comandos editados, consulta la Especificación de registro y supervisión de comandos de MongoDB.

Este ejemplo muestra cómo crear un contador para los comandos de base de datos. El contador driver la cantidad de veces que el driver ejecuta correctamente cada comando de base de datos e imprime esta información cada vez que se termina un comando de base de datos.

Para crear un contador, sigue estos pasos:

  1. Cree una clase con funcionalidad de contador que implemente la interfaz CommandListener.

  2. Agrega una instancia de la nueva clase a un objeto MongoClientSettings.

  3. Configura tu instancia MongoClient con el objeto MongoClientSettings.

El siguiente código implementa estos pasos:

import com.mongodb.kotlin.client.MongoClient
import org.bson.Document
import com.mongodb.event.*
import com.mongodb.MongoClientSettings
import com.mongodb.ConnectionString
class CommandCounter : CommandListener {
private val commands = mutableMapOf<String, Int>()
override fun commandSucceeded(event: CommandSucceededEvent) {
val commandName = event.commandName
val count = commands[commandName] ?: 0
commands[commandName] = count + 1
println(commands.toString())
}
override fun commandFailed(event: CommandFailedEvent) {
println("Failed execution of command '${event.commandName}' with id ${event.requestId}")
}
}
fun main() {
val uri = "<connection string uri>"
// Instantiate your new listener
val commandCounter = CommandCounter()
// Include the listener in your client settings
val settings = MongoClientSettings.builder()
.applyConnectionString(ConnectionString(uri))
.addCommandListener(commandCounter)
.build()
// Connect to your database
val mongoClient = MongoClient.create(settings)
val database = mongoClient.getDatabase("sample_mflix")
val collection = database.getCollection<Document>("movies")
// Run some commands to test the counter
collection.find().firstOrNull()
collection.find().firstOrNull()
mongoClient.close()
}
{find=1}
{find=2}
{find=2, endSessions=1}

Para obtener más información sobre las clases y métodos mencionados en esta sección, consulte la siguiente documentación de API:

Un evento de descubrimiento y monitoreo de servidor (SDAM) es un evento relacionado con un cambio en el estado de la instancia o el clúster de MongoDB al que ha conectado el controlador.

El controlador define nueve eventos SDAM y proporciona las siguientes interfaces de escucha, que escuchan tres eventos SDAM cada una:

Para supervisar un tipo de evento SDAM, crea una clase que implemente una de las tres interfaces anteriores y registra una instancia de esa clase en tu instancia de MongoClient.

Para obtener una descripción detallada de cada evento SDAM, consulte la especificación de eventos de monitoreo SDAM de MongoDB.

Este ejemplo muestra cómo crear una clase listener que imprimirá un mensaje sobre la disponibilidad de escritura de tu instancia MongoDB.

Para crear un evento que informe el estado de escritura, realice las siguientes tareas:

  1. Crear una clase que rastree los cambios en la descripción del clúster e implemente la interfaz ClusterListener.

  2. Agrega una instancia de la nueva clase a un objeto MongoClientSettings.

  3. Configura tu instancia MongoClient con el objeto MongoClientSettings.

El siguiente código implementa estos pasos:

import com.mongodb.kotlin.client.MongoClient
import org.bson.Document
import com.mongodb.event.*
import com.mongodb.MongoClientSettings
import com.mongodb.ConnectionString
class IsWriteable : ClusterListener {
private var isWritable = false
override fun clusterDescriptionChanged(event: ClusterDescriptionChangedEvent) {
if (!isWritable) {
if (event.newDescription.hasWritableServer()) {
isWritable = true
println("Able to write to cluster")
}
} else {
if (!event.newDescription.hasWritableServer()) {
isWritable = false
println("Unable to write to cluster")
}
}
}
}
fun main() {
val uri = "<connection string uri>"
// Instantiate your new listener
val clusterListener = IsWriteable()
// Include the listener in your client settings
val settings = MongoClientSettings.builder()
.applyConnectionString(ConnectionString(uri))
.applyToClusterSettings { builder ->
builder.addClusterListener(clusterListener)
}
.build()
// Connect to your database
val mongoClient = MongoClient.create(settings)
val database = mongoClient.getDatabase("sample_mflix")
val collection = database.getCollection<Document>("movies")
// Run a command to trigger a ClusterDescriptionChangedEvent event
collection.find().firstOrNull()
mongoClient.close()
}
Able to write to server

Para obtener más información sobre las clases y métodos mencionados en esta sección, consulte la siguiente documentación de API:

Un evento del pool de conexiones es un evento relacionado con un pool de conexiones mantenido por el driver. Un pool de conexiones es un conjunto de conexiones TCP abiertas que tu controlador mantiene con una instancia de MongoDB. Las agrupaciones de conexiones ayudan a reducir la cantidad de intercambios de red que realiza tu aplicación con una instancia de MongoDB y pueden ayudar a que tu aplicación funcione más rápido.

Para supervisar los eventos del grupo de conexiones, cree una clase que implemente la interfaz ConnectionPoolListener y registre una instancia de esa clase con su instancia MongoClient.

Este ejemplo muestra cómo crear una clase de escucha que imprima un mensaje cada vez que saque una conexión de su pool de conexiones.

Para crear un evento que informe sobre las comprobaciones de conexión, realice las siguientes tareas:

  1. Crea una clase que rastree los retiros y que implemente la interfaz CommandListener.

  2. Agrega una instancia de la nueva clase a un objeto MongoClientSettings.

  3. Configura tu instancia MongoClient con el objeto MongoClientSettings.

El siguiente código implementa estos pasos:

import com.mongodb.kotlin.client.MongoClient
import org.bson.Document
import com.mongodb.event.*
import com.mongodb.MongoClientSettings
import com.mongodb.ConnectionString
class ConnectionPoolLibrarian : ConnectionPoolListener {
override fun connectionCheckedOut(event: ConnectionCheckedOutEvent) {
println("Let me get you the connection with id ${event.connectionId.localValue}...")
}
override fun connectionCheckOutFailed(event: ConnectionCheckOutFailedEvent) {
println("Something went wrong! Failed to checkout connection.")
}
}
fun main() {
val uri = "<connection string uri>"
// Instantiate your new listener
val cpListener = ConnectionPoolLibrarian()
// Include the listener in your client settings
val settings = MongoClientSettings.builder()
.applyConnectionString(ConnectionString(uri))
.applyToConnectionPoolSettings({
it.addConnectionPoolListener(cpListener)
})
.build()
// Connect to your database
val mongoClient = MongoClient.create(settings)
val database = mongoClient.getDatabase("sample_mflix")
val collection = database.getCollection<Document>("movies")
// Run some commands to test the counter
collection.find().firstOrNull()
mongoClient.close()
}
Let me get you the connection with id 21...

Para obtener más información sobre las clases y métodos mencionados en esta sección, consulte la siguiente documentación de API:

Puedes supervisar eventos de pools de conexiones usando Java gestión Extensions (JMX). JMX proporciona herramientas para supervisar aplicaciones y dispositivos.

Para obtener más información sobre JMX, consulte la documentación oficial de Oracle JMX.

Para habilitar la supervisión del pool de conexiones JMX, agrega una instancia de la clase JMXConnectionPoolListener a tu objeto MongoClient.

La clase JMXConnectionPoolListener realiza las siguientes acciones:

  1. Crea instancias de MXBean para cada proceso mongod o mongos con el que el driver mantiene un pool de conexiones.

  2. Registra estas instancias MXBean con el servidor MBean de la plataforma.

Los MXBeans registrados en el servidor MBean de la plataforma tienen las siguientes propiedades:

Propiedad
Descripción

clusterId

Un identificador único generado por el cliente. Este identificador garantiza que cada MXBean que crea el driver tenga un nombre único cuando una aplicación tenga varias instancias de MongoClient conectadas al mismo implementación de MongoDB.

host

El nombre de host de la máquina que ejecuta el proceso mongod o mongos.

port

El puerto en el que está escuchando el proceso mongod o mongos.

minSize

El tamaño mínimo del grupo de conexiones, incluidas las conexiones inactivas y en uso.

maxSize

El tamaño máximo del grupo de conexiones, incluidas las conexiones inactivas y en uso.

size

El tamaño actual del pool de conexiones, incluidas las conexiones inactivas y en uso.

checkedOutCount

El recuento actual de conexiones que están en uso.

Todas las instancias de MXBean creadas por el driver están bajo el dominio "org.mongodb.driver".

Para obtener más información sobre los temas tratados en esta subsección, consulta los siguientes recursos de Oracle:

Este ejemplo muestra cómo supervisar los grupos de conexiones del controlador mediante JMX y JConsole. JConsole es una herramienta de monitorización de interfaz gráfica de usuario (GUI) compatible con JMX que se incluye en la plataforma Java.

Tip

Consulte la documentación oficial de JMX y JConsole

Las descripciones de JMX y JConsole en este ejemplo son ilustrativas, no una fuente de información veraz. Para garantizar la información actualizada, consulte los siguientes recursos oficiales de Oracle:

El siguiente fragmento de código añade una instancia JMXConnectionPoolListener a una instancia MongoClient. El código pausa la ejecución para que puedas acceder a JConsole e inspeccionar tus grupos de conexiones.

import com.mongodb.kotlin.client.MongoClient
import org.bson.Document
import com.mongodb.MongoClientSettings
import com.mongodb.ConnectionString
import com.mongodb.management.JMXConnectionPoolListener
fun main() {
val uri = "<connection string uri>"
// Instantiate your JMX listener
val connectionPoolListener = JMXConnectionPoolListener()
// Include the listener in your client settings
val settings = MongoClientSettings.builder()
.applyConnectionString(ConnectionString(uri))
.applyToConnectionPoolSettings {
it.addConnectionPoolListener(connectionPoolListener)
}
.build()
try {
// Connect to your database
val mongoClient = MongoClient.create(settings)
val database = mongoClient.getDatabase("sample_mflix")
val collection = database.getCollection<Document>("movies")
collection.find().firstOrNull()
collection.find().firstOrNull()
println("Navigate to JConsole to see your connection pools...")
// Pause execution
Thread.sleep(Long.MAX_VALUE)
mongoClient.close()
} catch (e: Exception) {
e.printStackTrace()
}
}
Navigate to JConsole to see your connection pools...

Una vez que hayas iniciado el servidor, abre JConsole en tu terminal usando el siguiente comando:

jconsole

Una vez abierto JConsole, realice las siguientes acciones en la GUI:

  1. Seleccione el proceso que ejecuta el código de ejemplo anterior.

  2. Presiona Insecure Connection en el cuadro de diálogo de advertencia.

  3. Haz clic en la pestaña MBeans.

  4. Inspeccione los eventos de su grupo de conexiones bajo el dominio "org.mongodb.driver".

Cuando ya no desee inspeccionar sus grupos de conexiones en JConsole, haga lo siguiente:

  1. Salga de JConsole cerrando la ventana de JConsole.

  2. Detener el programa que se ejecuta mediante el snippet de código anterior.

Para obtener más información sobre JMX y JConsole, consulta los siguientes recursos de Oracle:

Para obtener más información sobre la JMXConnectionPoolListener clase, consulte la documentación de la API de JMXConnectionPoolListener.

Si utilizas un sistema de seguimiento distribuido, puedes incluir datos de eventos del controlador. Un sistema de rastreo distribuido es una aplicación que rastrea las solicitudes a medida que se propagan a través de diferentes servicios en una arquitectura orientada a servicios.

Si usa el controlador en una aplicación Spring Cloud, use Spring Cloud Sleuth para incluir datos de eventos de MongoDB en el sistema de seguimiento distribuido Zipkin.

Si no utilizas Spring Cloud o deseas incluir datos de eventos del controlador en un sistema de rastreo distribuido que no sea Zipkin, deberás escribir un oyente de eventos de comandos que administre los spans para tu sistema de rastreo distribuido deseado.

Tip

Para obtener más información sobre los conceptos tratados en esta sección, revisión los siguientes recursos:

Volver

Registro

En esta página