This package enables tracing Mongo commands in a PyMongo MongoClient via The OpenTracing Project. Once a production system contends with real concurrency or splits into many services, crucial (and formerly easy) tasks become difficult: user-facing latency optimization, root-cause analysis of backend errors, communication about distinct pieces of a now-distributed system, etc. Distributed tracing follows a request on its journey from inception to completion from mobile/browser all the way to the microservices.
As core services and libraries adopt OpenTracing, the application builder is no longer burdened with the task of adding basic tracing instrumentation to their own code. In this way, developers can build their applications with the tools they prefer and benefit from built-in tracing instrumentation. OpenTracing implementations exist for major distributed tracing systems and can be bound or swapped with a one-line configuration change.
If you want to learn more about the underlying Python API, visit the Python source code.
Installation
Run the following command:
$ pip install signalfx-instrumentation-pymongoUsage
This PyMongo monitor allows the tracing of database queries and commands using the OpenTracing API. All that it requires is for a CommandTracing listener instance to be initialized using an instance of an OpenTracing tracer and registered via the pymongo.monitoring module.
Initialize
CommandTracing takes the Tracer instance that is supported by OpenTracing and an optional dictionary of desired tags for each created span. To create a CommandTracing object, you can either pass in a tracer object directly or default to the opentracing.tracer global tracer that’s set elsewhere in your application:
from pymongo_opentracing import CommandTracing
from pymongo import monitoring
opentracing_tracer = ## some OpenTracing tracer implementation
# All future clients will have CommandTracing registered for their events
monitoring.register(CommandTracing(opentracing_tracer,
span_tags={'MyCustomTag': 'HelpfulVal'}))or
from pymongo_opentracing import CommandTracing
import opentracing
import pymongo
opentracing.tracer = ## some OpenTracing tracer implementation
# Only this client will have CommandTracing trace their events
client = pymongo.MongoClient(event_listeners=[CommandTracing()])Further Information
If you’re interested in learning more about the OpenTracing standard, please visit opentracing.io or join the mailing list. If you would like to implement OpenTracing in your project and need help, feel free to send us a note at community@opentracing.io.
1 maintainer
Metadata
1 maintainer
Release files for signalfx-instrumentation-pymongo 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| signalfx-instrumentation-pymongo-1.0.0.tar.gz | 4.1 kB | Details |
Release files / signalfx-instrumentation-pymongo-1.0.0.tar.gz
| Download URL | signalfx-instrumentation-pymongo-1.0.0.tar.gz |
|---|---|
| Size | 4.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4e6379d7040558c812ca1783050090e315f3bedf50982f2793954e7a8d718faf
|
|
BLAKE2b-256 checksum How to use checksums |
c61d4837d94372f1acfceed9549cf61eb23f8f1789d296eeba01b74c22847968
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.6.11
|
