Administrar conexiones con grupos de conexiones

maxPoolSize

Además de los sockets necesarios para admitir las solicitudes de tu aplicación, cada instancia de MongoClient abre hasta dos conexiones por servidor en la topología de MongoDB para supervisión del estado del servidor.

Por ejemplo, un cliente conectado a un conjunto de réplicas de tres nodos abre seis sockets de monitorización. Si la aplicación usa la configuración predeterminada para maxPoolSize y solo consulta el nodo principal (predeterminado), puede haber como máximo 106 sockets abiertos y 100 conexiones en el grupo de conexiones. Si la aplicación usa un preferencia de lectura para consultar los nodos secundarios, esos grupos de conexiones crecen y puede haber 306 conexiones en total, incluidos los sockets de monitoreo abiertos.

Para admitir una gran cantidad de solicitudes MongoDB simultáneas dentro de un proceso, puede aumentar maxPoolSize.

El siguiente código crea una instancia MongoClient con un tamaño máximo de grupo de conexiones de 200 especificando la opción maxPoolSize en el objeto options:

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  maxPoolSize: 200
});

maxConnecting

Los grupos de conexiones limitan la velocidad de establecimiento de conexiones. La opción maxConnecting determina el número de conexiones que el grupo puede crear en paralelo en cualquier momento. Por ejemplo, si el valor de maxConnecting es 2, la tercera solicitud que intenta verificar una conexión simultáneamente solo se realiza correctamente cuando se cumple una de las siguientes condiciones:

• El grupo de conexiones termina de crear una conexión y hay menos de maxPoolSize conexiones en el grupo.

• Una conexión existente se vuelve a incluir en el grupo.

El siguiente código crea una instancia MongoClient con una cantidad máxima de 2 conexiones que se establecerán simultáneamente por grupo especificando la opción maxConnecting en el objeto options:

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
   maxConnecting: 2
});

minPoolSize

Puede establecer el número mínimo de conexiones a cada servidor con la opción minPoolSize. El controlador garantiza que siempre haya al menos el número de conexiones establecido por la opción minPoolSize en el grupo de conexiones. Si se cierran los sockets, lo que provoca que el número total de sockets (tanto en uso como inactivos) caiga por debajo del mínimo, se abren más sockets hasta alcanzarlo.

El siguiente código crea una instancia MongoClient con un tamaño de grupo de conexiones mínimo de 10 especificando la opción minPoolSize en el objeto options:

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  minPoolSize: 10
});

maxIdleTimeMS

Puede establecer el número máximo de milisegundos que una conexión puede permanecer inactiva en el pool configurando la opción maxIdleTimeMS. Una vez que una conexión ha estado inactiva durante maxIdleTimeMS, el pool la elimina y la reemplaza. El valor predeterminado de esta opción es 0 (sin límite).

El siguiente código crea una instancia MongoClient con un tiempo de inactividad máximo de 10000 milisegundos (10 segundos) al especificar la configuración maxIdleTimeMS en el objeto options:

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  maxIdleTimeMS: 10000
});

waitQueueTimeoutMS

MongoClient Admite múltiples solicitudes simultáneas. Para cada proceso, cree un cliente y reutilícelo para todas las operaciones. Esta práctica es más eficiente que crear un cliente para cada solicitud.

El controlador no limita la cantidad de solicitudes que pueden esperar a que los sockets estén disponibles, y es responsabilidad de la aplicación limitar el tamaño de su grupo a la cola limitada durante un pico de carga. Las solicitudes esperan el tiempo especificado en la opción waitQueueTimeoutMS, cuyo valor predeterminado es 0 (sin límite).

Una solicitud que espera más tiempo del definido por waitQueueTimeoutMS para un socket genera un error de conexión. Use esta opción si es más importante limitar la duración de las operaciones durante un pico de carga que completar cada operación.

El siguiente código crea una instancia MongoClient con un tiempo de espera máximo de 10000 milisegundos (10 segundos) al declararla en el objeto options:

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  waitQueueTimeoutMS: 10000
});