signalfx-instrumentation-requests 1.0.1

Initialize

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)

or

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)