[BUG]: pymongo >=4.12 does not report spans

[kamilbednarz]

Tracer Version(s)

3.9.1

Python Version(s)

3.11.9

Pip Version(s)

25.0.1

Bug Report

ddtrace seems to not report pymongo spans to datadog in latest versions of pymongo.
Main API traces are visible, but all the pymongo computing time contributes toward main python span.

Recently we did pymongo upgrade and here are my observations re: versions that worked fine/do not work:
✅ pymongo 4.6.x & motor 3.1.1
✅ pymongo 4.9.x & motor 3.7.1
✅ pymongo 4.10.x & motor 3.7.1
✅ pymongo 4.11.x & motor 3.7.1
🔴 pymongo 4.12.x & motor 3.7.1
🔴 pymongo 4.13.x & motor 3.7.1

The patching code is not changed between versions.
Application runtime is not wrapped with ddtrace-run.

I tried different startup methods:

• ddtrace-run
• import ddtrace.auto
  None of them helped so it makes me suspect that maybe the ddtrace package & its patching code is just not compatible with latest pymongo versions.

LMK if you need any more details to reproduce/troubleshoot.

Reproduction Code

from ddtrace import patch_all, config
patch_all(all=True)

Error Logs

No errors are reported by ddtrace.

Libraries in Use

pymongo==4.13.0
motor==3.7.1
ddtrace==3.9.1

Operating System

No response

[wantsui]

Thanks for the report! I plan to look into it this week to see what work it would entail to support the newer versions!

[mabdinur]

Hey @kamilbednarz,

Are you instrumenting your application via Single Step Instrumentation? I believe we restrict supported versions to pymongo<=4.10 (here) because do not test against more recent versions (at least not yet). I ran our test suite manually and am I able to confirm that ddtrace v3.9 is compatible with pymongo v4.13. We will update out SSI guardrails to reflect this.

cc: @wconti27

In the meantime you could set DD_INJECT_FORCE=True to skip this validation.

If you are not using SSI then I will need help with a reproduction. I was able to generate pymongo spans using the following steps:

Step 1

Install ddtrace==3.9.4 and pymongo==4.13.2

Step 2

Run the code below to execute pymongo operations when ddtrace instrumentation is enabled. Set DD_TRACE_DEBUG=1 to enable tracer debug logs:

import ddtrace.auto # Equivalent to ddtrace-run
import pymongo
from ddtrace import tracer


# 1. Connect to MongoDB server (default: localhost on port 27017)
client = pymongo.MongoClient("mongodb://localhost:27017/")

# 2. Create or connect to a database
db = client["mydatabase"]

# 3. Create or connect to a collection
collection = db["users"]

# 4. Insert a document
user = {"name": "Alice", "email": "alice@example.com", "age": 30}
insert_result = collection.insert_one(user)
print("Inserted ID:", insert_result.inserted_id)

# 5. Query the document
found_user = collection.find_one({"name": "Alice"})
print("Found User:", found_user)

Tracer debug logs showing spans being finished:

finishing span name='pymongo.cmd' id=7370484426611997805 trace_id=138732355762184097065793766706904613798 parent_id=3848623476007993364 service='pymongo' resource='insert users' type='mongodb' start=1751048508.1358452 end=1751048508.1377301 duration=0.001885 error=0 tags={'component': 'pymongo', 'db.system': 'mongodb', 'mongodb.collection': 'users', 'mongodb.db': 'mydatabase', 'mongodb.ordered': 'True', 'out.host': 'localhost', 'server.address': 'localhost', 'span.kind': 'client'} metrics={'_dd.measured': 1, 'mongodb.documents': 1, 'network.destination.port': 27017} links='' events='' (enabled:True)
finishing span name='pymongo.checkout' id=3848623476007993364 trace_id=138732355762184097065793766706904613798 parent_id=None service='pymongo' resource='pymongo.checkout' type='mongodb' start=1751048508.127598 end=1751048508.138072 duration=0.010474 error=0 tags={'_dd.base_service': 'datadog', '_dd.p.dm': '-0', '_dd.p.tid': '685ee13c00000000', 'component': 'pymongo', 'db.system': 'mongodb', 'language': 'python', 'out.host': 'localhost', 'runtime-id': '22f86a7d41794cac8b63e9e67c617b6f', 'server.address': 'localhost', 'span.kind': 'client'} metrics={'_dd.measured': 1, '_dd.top_level': 1, '_dd.tracer_kr': 1.0, '_sampling_priority_v1': 1, 'network.destination.port': 27017, 'process_id': 4963} links='' events='' (enabled:True)

finishing span name='pymongo.cmd' id=13466330320388608461 trace_id=138732355762184097074654922842809418073 parent_id=18398585883722104403 service='pymongo' resource='find users {"name": "?"}' type='mongodb' start=1751048508.138579 end=1751048508.140996 duration=0.002417 error=0 tags={'component': 'pymongo', 'db.system': 'mongodb', 'mongodb.collection': 'users', 'mongodb.db': 'mydatabase', 'mongodb.query': '{"name": "?"}', 'out.host': 'localhost', 'server.address': 'localhost', 'span.kind': 'client'} metrics={'_dd.measured': 1, 'db.row_count': 1, 'network.destination.port': 27017} links='' events='' (enabled:True)
finishing span name='pymongo.checkout' id=18398585883722104403 trace_id=138732355762184097074654922842809418073 parent_id=None service='pymongo' resource='pymongo.checkout' type='mongodb' start=1751048508.1385229 end=1751048508.141182 duration=0.002659 error=0 tags={'_dd.base_service': 'datadog', '_dd.p.dm': '-0', '_dd.p.tid': '685ee13c00000000', 'component': 'pymongo', 'db.system': 'mongodb', 'language': 'python', 'out.host': 'localhost', 'runtime-id': '22f86a7d41794cac8b63e9e67c617b6f', 'server.address': 'localhost', 'span.kind': 'client'} metrics={'_dd.measured': 1, '_dd.top_level': 1, '_dd.tracer_kr': 1.0, '_sampling_priority_v1': 1, 'network.destination.port': 27017, 'process_id': 4963} links='' events='' (enabled:True)

[kamilbednarz]

Hey @mabdinur,

we initialize ddtrace using this code in python (fastapi application, top of the main entrypoint file):

from ddtrace import patch_all, config
config.env = 'dev'
config.version = '1.0.0'
config.service = 'app-1'
patch_all(all=True)

The same code works fine with pymongo 4.11, but does not work for 4.12 and 4.13. Or rather: the code works, but traces do not report spans for pymongo.

We don't wrap the executable with ddtrace-run (however, I tried that too and also did not work for me).

LMK if I can help with further troubleshooting.