Registro

Variables de entorno

Puede configurar el registro para diferentes componentes del controlador especificando un nivel de gravedad en una o más de las siguientes variables de entorno:

• MONGODB_LOG_ALL: Especifica la gravedad predeterminada para cualquier componente no configurado

• MONGODB_LOG_COMMAND:Registra todos los comandos enviados al servidor

• MONGODB_LOG_TOPOLOGY:Registra cualquier cambio en la topología del clúster

• MONGODB_LOG_SERVER_SELECTION:Registra el proceso de selección del servidor

• MONGODB_LOG_CONNECTION: Registra todos los eventos del pool de conexiones

• MONGODB_LOG_CLIENT:Registra todos los eventos del cliente

Si no especifica ninguna de las variables de entorno anteriores, el controlador utiliza el valor de MONGODB_LOG_ALL, que si no se especifica, se establece implícitamente en off.

El siguiente ejemplo establece el nivel de registro para todos los componentes en debug excepto MONGODB_LOG_COMMAND:

export MONGODB_LOG_ALL="debug"
export MONGODB_LOG_COMMAND="off"

export MONGODB_LOG_PATH="stderr"

export MONGODB_LOG_MAX_DOCUMENT_LENGTH=500

Opciones del cliente

Puede configurar el registro programáticamente especificando las opciones del cliente en el constructor MongoClient. Dado que las opciones del cliente prevalecen sobre las variables de entorno, especifíquelas en el cliente solo si ya no desea que el controlador responda a las variables de entorno.

Puede especificar para qué componente configurar el registro especificando una o más de las siguientes opciones de cliente:

• default: Especifica la gravedad predeterminada para cualquier componente no configurado

• command:Registra todos los comandos enviados al servidor

• topology:Registra cualquier cambio en la topología del clúster

• serverSelection:Registra el proceso de selección del servidor

• connection: Registra todos los eventos del pool de conexiones

• client:Registra todos los eventos del cliente

Para especificar un nivel de registro para un componente, configure la opción mongodbLogComponentSeverities en un objeto que contenga el componente y el nivel de gravedad deseado. El siguiente ejemplo configura el nivel de registro para todos los componentes en debug, excepto para command:

const client = new MongoClient("<connection string>", {
    mongodbLogComponentSeverities: {
        default: "debug",
        command: "off"
    }
});

const mongodbLogComponentSeverities = {
    default: "debug"
};
const mongodbLogPath = "stdout";
const client = new MongoClient("<connection string>",
    { mongodbLogComponentSeverities, mongodbLogPath }
);

import fs from 'node:fs/promises';
import util from 'node:util';
const mongodbLogPath = {
    file: await fs.open(`./server-${+new Date()}.logs`, 'w'),
    async write(log) {
        try {
            await this.file?.appendFile(util.inspect(log) + '\n');
        } catch (fileError) {
            console.log('cannot log anymore', fileError);
            this.file = null;
        }
    }
}
const client = new MongoClient("<connection string>", { mongodbLogPath });

const mongodbLogComponentSeverities = {
    default: "debug"
};
const mongodbLogLength = 500;
const client = new MongoClient("<connection string>", {
    mongodbLogComponentSeverities,
    mongodbLogLength
});

Documentación de la API

Para obtener más información sobre cualquiera de las opciones o tipos analizados en esta guía, consulte la siguiente documentación de API:

• MongoClientOptions

• Gravedad de los componentes de registro de mongodb

• mongodbLogMaxDocumentLength

• Ruta de registro de mongodb