OpenTracing support for Requests
This package enables tracing http requests in a Requests Session 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.
Run the following command:
$ pip install signalfx-instrumentation-requests
The provided requests.Session subclass allows the tracing of http methods using the OpenTracing API. All that it requires is for a SessionTracing instance to be initialized using an instance of an OpenTracing tracer and treated as a standard Requests session.
SessionTracing takes the Tracer instance that is supported by OpenTracing and an optional dictionary of desired tags for each created span. You can also specify whether you’d like your current trace context to be propagated via http headers with your client request. To create a SessionTracing 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 requests_opentracing import SessionTracing opentracing_tracer = # some OpenTracing tracer implementation traced_session = SessionTracing(opentracing_tracer, propagate=False, # propagation allows distributed tracing in span_tags=dict(my_helpful='tag')) # upstream services you control (True by default). resp = traced_session.get(my_url)
from requests_opentracing import SessionTracing import opentracing import requests opentracing.tracer = # some OpenTracing tracer implementation traced_session = SessionTracing() # default to opentracing.tracer
You can now monkeypatch the requests.Session and requests.sessions.Session objects to point to the SessionTracing subclass for easier initialization:
from requests_opentracing import monkeypatch_requests monkeypatch_requests() from requests import Session opentracing_tracer = # some OpenTracing tracer implementation traced_session = Session(opentracing_tracer, propagate=False, # Same arguments as provided to SessionTracing span_tags=dict(my_helpful='tag')) resp = traced_session.get(my_url)
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 email@example.com.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for signalfx-instrumentation-requests-1.0.1.tar.gz