# MongoDB Driver

<!-- llms-txt-link: /llms.txt -->

> OpenTelemetry Java agent instrumentation

This instrumentation enables database client spans and database client metrics for the MongoDB Java driver.

- **Name**: `mongo-3.7`
- **Scope**: `io.opentelemetry.mongo-3.7`
- **Target versions**: `org.mongodb:mongo-java-driver:[3.7, 4.0)`, `org.mongodb:mongodb-driver-core:[3.7, 4.0)`
- **Library**: https://www.mongodb.com/docs/drivers/java-drivers/

## Telemetry

- **Metrics**: `db.client.operation.duration`
- **Span attributes**: `db.connection_string`, `db.mongodb.collection`, `db.name`, `db.operation`, `db.statement`, `db.system`, `server.address`, `server.port`, `db.collection.name`, `db.namespace`, `db.operation.name`, `db.query.text`, `db.system.name`

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.common.db.query-sanitization.enabled` | boolean | true | Enables query sanitization for database queries. |
| `otel.instrumentation.mongo.query-sanitization.enabled` | boolean | true | Enables query sanitization for MongoDB queries. Takes precedence over otel.instrumentation.common.db.query-sanitization.enabled. |

## Data

- **JSON**: [/data/javaagent/instrumentations/mongo-3.7/mongo-3.7-4970a9e9b1a4.json](/data/javaagent/instrumentations/mongo-3.7/mongo-3.7-4970a9e9b1a4.json)
- **Explore**: [/java-agent/instrumentation/mongo-3.7](/java-agent/instrumentation/mongo-3.7)