Logging

Overview

Starting in version 2.18, the .NET/C# Driver uses the standard .NET logging API. In this guide, you can learn how to use the driver to configure logging for your application.

Configure Logging

To specify the logging settings for your application, create a new instance of the LoggingSettings class, then assign it to the LoggingSettings property of your MongoClientSettings object.

The LoggingSettings constructor accepts the following parameters:

The following code sample shows how to create a MongoClient that logs all debug messages to the console:

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);

Log Messages by Category

Each message generated by a MongoDB cluster is assigned a category. This lets you specify different log levels for different types of messages.

MongoDB uses the following categories to classify messages:

Configure Log Verbosity

You can configure the log verbosity of each message category by using the standard .NET logging mechanism. The following code sample shows how to configure a MongoClient to log two types of messages:

• All messages with log level Error or higher from all categories

• All messages with log level Debug or higher from the SDAM category

In this example, the configuration is done in-memory. The code creates a Dictionary<string, string> where the key is "LogLevel:<category>" and the value is the minimum log level of messages in that category. The code then adds the dictionary to a ConfigurationBuilder object, then adds the ConfigurationBuilder to a 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);