Trask Stalnaker 68ebe00c8b Revert "Remove db.connection_string (#11089)" (#11366) 10 months ago
..
src 68ebe00c8b Revert "Remove db.connection_string (#11089)" (#11366) 10 months ago
README.md 0a717edeb8 Small library doc updates (#9868) 1 year ago
build.gradle.kts 5a14788fc1 Use .service instead of .getService() to get testcontainersBuildService (#8188) 1 year ago

README.md

MongoDB library instrumentation

This package contains the library to help instrument MongoDB Client.

Quickstart

Dependencies

Replace OPENTELEMETRY_VERSION with the latest release.

For Maven, add to your pom.xml dependencies:

<dependencies>
  <dependency>
    <groupId>io.opentelemetry.instrumentation</groupId>
    <artifactId>opentelemetry-mongo-3.1</artifactId>
    <version>OPENTELEMETRY_VERSION</version>
  </dependency>
</dependencies>

For Gradle, add to your dependencies:

implementation("io.opentelemetry.instrumentation:instrumentation:opentelemetry-mongo-3.1:OPENTELEMETRY_VERSION")

Usage

The instrumentation is initialized by passing a MongoTelemetry::newCommandListener() to the MongoClientSettings builder. You must set the OpenTelemetry to use with the feature.

OpenTelemetry openTelemetry = ...;

MongoTelemetry mongoTelemetry = MongoTelemetry.builder(openTelemetry).build();

MongoClientSettings settings = MongoClientSettings.builder()
    .applyConnectionString(ConnectionString("mongodb://localhost:27017"))
    .addCommandListener(mongoTelemetry.newCommandListener())
    .build();

// With Reactive Streams
MongoClient client = MongoClients.create(settings);