Supervisión del pool de conexiones

Overview

Esta guía te muestra cómo usar el driver de Rust para supervisar el pool de conexiones del driver. Un pool de conexiones es un conjunto de conexiones abiertas de Protocolo de control de transmisión (TCP) que tu driver mantiene con una instancia de MongoDB. El pool de conexiones ayuda a reducir la cantidad de nuevas conexiones que tu aplicación necesita crear, lo que posiblemente haga que tu aplicación funcione más rápido.

Puedes utilizar la información sobre los cambios en tu pool de conexiones en tu aplicación, o puedes supervisar el pool de conexiones para aprender más sobre cómo el driver utiliza las conexiones.

Esta guía incluye las siguientes secciones:

• Descripciones de eventos describe los eventos del pool de conexiones que el driver puede generar

• Ejemplo de suscripción a eventos proporciona un código de ejemplo que muestra cómo suscribirse a un evento de un pool de conexiones.

• Ejemplo de documentos de eventos proporciona muestras de cada evento de pool de conexiones.

• Información adicional proporciona enlaces a recursos y documentación de la API para los tipos y métodos mencionados en esta guía

Descripciones de eventos

Puedes suscribirse a uno o más de los siguientes eventos de supervisión del pool de conexiones:

Ejemplo de suscripción a eventos

Puede acceder a uno o más eventos de pool de conexiones suscribiéndose a ellos en su aplicación. El siguiente ejemplo se conecta a una implementación de MongoDB y se suscribe al ConnectionCreatedEvent tipo de evento:

struct ConnectionCreatedHandler;
impl CmapEventHandler for ConnectionCreatedHandler {
    fn handle_connection_created_event(&self, event: ConnectionCreatedEvent) {
        eprintln!("Connection created: {:?}", event);
    }
}
let handler: Arc<dyn CmapEventHandler> = Arc::new(ConnectionCreatedHandler);
client_options.cmap_event_handler = Some(handler);
let client = Client::with_options(client_options)?;
// ... perform actions with the client to generate events

Documentos de eventos de ejemplo

Las siguientes secciones muestran la salida de muestra para cada tipo de evento de supervisión del pool de conexiones.

PoolCreatedEvent {
  address: ...,
  options: {...}
}

PoolReadyEvent {
  address: ...
}

PoolClearedEvent {
  address: ...,
  service_id: ...,
}

PoolClosedEvent {
  address: ...
}

ConnectionCreatedEvent {
  address: ...,
  connection_id: 1
}

ConnectionReadyEvent {
  address: ...,
  connection_id: 1
}

ConnectionClosedEvent {
  address: ...,
  connection_id: 1,
  reason: ...,
  /* private fields */
}

ConnectionCheckOutStartedEvent {
  address: ...,
}

ConnectionCheckOutFailedEvent {
  address: ...,
  reason: ...,
  /* private fields */
}

ConnectionCheckedOutEvent {
  address: ...,
  connection_id: 1
}

ConnectionCheckedInEvent {
  address: ...,
  connection_id: 1
}

Información Adicional

Para obtener más información sobre la supervisión de una implementación de MongoDB, consulte el artículo Cómo supervisar MongoDB.

Para obtener más información sobre cómo conectarse a MongoDB, consulte la Guía de conexión.

Para obtener más información sobre cómo mejorar el rendimiento de la aplicación, consulta la guía sobre consideraciones sobre rendimiento.