This is a cache of https://www.elastic.co/guide/en/apm/agent/dotnet/current/setup-mongo-db.html. It is a snapshot of the page at 2024-09-14T01:03:51.450+0000.
MongoDB | APM .NET Agent Reference [<strong>1</strong>.x] | Elastic

MongoDB

edit

Quick start

edit

Instrumentation for MongoDB works with the official MongoDb.Driver 2.4.4+ driver packages. A prerequisite for auto instrumentation is to configure the MongoClient with MongoDbEventSubscriber:

var settings = MongoClientSettings.FromConnectionString(mongoConnectionString);

settings.ClusterConfigurator = builder => builder.Subscribe(new MongoDbEventSubscriber());
var mongoClient = new MongoClient(settings);

Once the above configuration is in place

  • if the agent is included by referencing the Elastic.Apm.NetCoreAll package, it will automatically capture calls to MongoDB on every active transaction, and no further action is required.
  • you can manually activate auto instrumentation from the Elastic.Apm.MongoDb package by calling
Agent.Subscribe(new MongoDbDiagnosticsSubscriber());

MongoDB integration is currently supported on .NET Core and newer. Due to MongoDb.Driver assemblies not being strongly named, they cannot be used with Elastic APMR17;s strongly named assemblies on .NET Framework.