Skip to main content

Async Tracing Instrumentation using OpenTracing API (

Project description

PyPI version Python versions Pypi Downloads Build Status Coverage Status


A collection of asyncio instrumentation tools to enable tracing with OpenTracing API.


Make sure you are running recent enough versions of pip and setuptools, e.g. before installing your project requirements execute this:

pip install --upgrade "setuptools>=29" "pip>=9"

The module name is opentracing_async_instrumentation.

What's inside

Supported client frameworks

The following libraries are instrumented for tracing in this module:


  • Only Python 3.5+ is currently supported.

Server instrumentation

For inbound requests a helper function before_request is provided for creating middleware for frameworks like aiohttp and possibly Tornado.

A middleware is provided for aiohttp.

In-process Context Propagation

As part of the OpenTracing 2.0 API, in-process Span propagation happens through the newly defined ScopeManager interface.


This library provides two types of instrumentation, explicit instrumentation for server endpoints, and implicit instrumentation for client call sites.


Server endpoints are instrumented by creating a (or using a provided) middleware class that:

  1. initializes the specific tracer implementation
  2. wraps incoming request handlers into a method that reads the incoming tracing info from the request and creates a new tracing Span
from aiohttp import web
from opentracing_async_instrumentation.client_hooks import aiohttpserver

async def handler(request):
    return web.Response(body='Hello World')

app = web.Application()
app.router.add_get('/', handler)

if __name__ == '__main__':


Client call sites are instrumented implicitly by executing a set of available client_hooks that monkey-patch some API points in several common libraries like aiohttp and aiobotocore. The initialization of those hooks is usually also done from the middleware class's __init__ method.

Usage is via the client_hooks interface.

from opentracing_async_instrumentation import client_hooks



For the aiohttp library, in case you want to set custom tags to spans depending on content or some metadata of responses, you can set response_handler_hook. The hook must be a method with a signature (response, span), where response and span are positional arguments, so you can use different names for them if needed.

from opentracing_async_instrumentation.client_hooks.aiohttpclient import patcher

def hook(response, span):
    if not response.ok:
        span.set_tag('error', 'true')



To prepare a development environment please execute the following commands.

virtualenv env
source env/bin/activate
make bootstrap
make test

You can use tox to run tests as well.


Project details

Download files

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

Source Distribution

opentracing_async_instrumentation-0.2.0.tar.gz (13.9 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page