Registro

Overview

A partir de la versión 2.18, el driver .NET/C# utiliza la API estándar .NET logging API. En esta guía, puede aprender cómo usar el controlador para configurar el registro de su aplicación.

Configurar registro

Para especificar la configuración de logging de tu aplicación, crea una nueva instancia de la clase LoggingSettings, y asígnala a la propiedad LoggingSettings de tu objeto MongoClientSettings.

El constructor LoggingSettings acepta los siguientes parámetros:

El siguiente ejemplo de código muestra cómo crear un MongoClient que registre todos los mensajes de depuración en la consola:

using var loggerFactory = LoggerFactory.Create(b =>
{
  b.AddSimpleConsole();
  b.SetMinimumLevel(LogLevel.Debug);
});
var settings = MongoClientSettings.FromConnectionString("<connection string>");
settings.LoggingSettings = new LoggingSettings(loggerFactory);
var client = new MongoClient(settings);

Mensajes de registro por categoría

A cada mensaje generado por un clúster de MongoDB se le asigna una categoría. Esto permite especificar diferentes niveles de registro para distintos tipos de mensajes.

MongoDB utiliza las siguientes categorías para clasificar los mensajes:

Configurar el Nivel de Verbosidad de los Registros

Puede configurar el nivel de verbosidad de los registros de cada categoría de mensajes utilizando el mecanismo de registro estándar de .NET. El siguiente ejemplo de código muestra cómo configurar un MongoClient para registrar dos tipos de mensajes:

• Todos los mensajes con nivel de registro Error o superior de todas las categorías

• Todos los mensajes con nivel de registro Debug o superior, de la categoría SDAM.

En este ejemplo, la configuración se realiza en memoria. El código crea un Dictionary<string, string> donde la clave es "LogLevel:<category>" y el valor es el nivel de registro mínimo de los mensajes en esa categoría. A continuación, el código añade el diccionario a un objeto ConfigurationBuilder, y luego añade el ConfigurationBuilder a un LoggerFactory.

var categoriesConfiguration = new Dictionary<string, string>
{
  { "LogLevel:Default", "Error" },
  { "LogLevel:MongoDB.SDAM", "Debug" }
};
var config = new ConfigurationBuilder()
  .AddInMemoryCollection(categoriesConfiguration)
  .Build();
using var loggerFactory = LoggerFactory.Create(b =>
{
  b.AddConfiguration(config);
  b.AddSimpleConsole();
});
var settings = MongoClientSettings.FromConnectionString("<connection string>");
settings.LoggingSettings = new LoggingSettings(loggerFactory);
var client = new MongoClient(settings);