Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

OpenTracing support for Flask applications

Project Description

Description-Content-Type: UNKNOWN
Description: #################

This package enables distributed tracing in Flask applications 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`_.

.. _The OpenTracing Project:
.. _source code:


Run the following command:

.. code-block::

$ pip install Flask-Opentracing


This Flask extension allows for tracing of Flask apps using the OpenTracing API. All
that it requires is for a FlaskTracing tracer to be initialized using an
instance of an OpenTracing tracer. You can either trace all requests to your site, or use function decorators to trace certain individual requests.

**Note:** `optional_args` in both cases are any number of attributes (as strings) of `flask.Request` that you wish to set as tags on the created span


`FlaskTracer` wraps the tracer instance that's supported by opentracing. To create a `FlaskTracer` object, you can either pass in a tracer object directly or a callable that returns the tracer object. For example:

.. code-block:: python

import opentracing
from flask_opentracing import FlaskTracer

opentracing_tracer = ## some OpenTracing tracer implementation
tracer = FlaskTracer(opentracing_tracer, ...)


.. code-block:: python

import opentracing
from flask_opentracing import FlaskTracer

def initialize_tracer():
return opentracing_tracer

tracer = FlaskTracer(initialize_tracer, ...)

Trace All Requests

.. code-block:: python

import opentracing
from flask_opentracing import FlaskTracer

app = Flask(__name__)

opentracing_tracer = ## some OpenTracing tracer implementation
tracer = FlaskTracer(opentracing_tracer, True, app, [optional_args])

Trace Individual Requests

.. code-block:: python

import opentracing
from flask_opentracing import FlaskTracer

app = Flask(__name__)

opentracing_tracer = ## some OpenTracing tracer implementation
tracer = FlaskTracer(opentracing_tracer)

def some_view_func():
return some_view

Accessing Spans Manually

In order to access the span for a request, we've provided an method `FlaskTracer.get_span(request)` that returns the span for the request, if it is exists and is not finished. This can be used to log important events to the span, set tags, or create child spans to trace non-RPC events. If no request is passed in, the current request will be used.

Tracing an RPC

If you want to make an RPC and continue an existing trace, you can inject the current span into the RPC. For example, if making an http request, the following code will continue your trace across the wire:

.. code-block:: python

def some_view_func(request):
new_request = some_http_request
current_span = tracer.get_span(request)
text_carrier = {}
opentracing_tracer.inject(span, opentracing.Format.TEXT_MAP, text_carrier)
for k, v in text_carrier.iteritems():
... # make request


See `examples`_ to view and run an example of two Flask applications
with integrated OpenTracing tracers.

.. _examples:

Further Information

If you're interested in learning more about the OpenTracing standard, please visit ``_ 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 ``_.

.. _join the mailing list:

Platform: any
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(8.7 kB) Copy SHA256 Hash SHA256
Wheel py2.py3 Jan 8, 2018
(6.0 kB) Copy SHA256 Hash SHA256
Source None Jan 8, 2018

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers