aiozipkin’s documentation!

aiozipkin is Python 3.6+ module that adds distributed tracing capabilities for asyncio applications with zipkin ( server instrumentation.

zipkin is a distributed tracing system. It helps gather timing data needed to troubleshoot latency problems in microservice architectures. It manages both the collection and lookup of this data. Zipkin’s design is based on the Google Dapper paper.

Applications instrumented with aiozipkin report timing data to zipkin. The Zipkin UI also presents a Dependency diagram showing how many traced requests went through each application. If you are troubleshooting latency problems or errors, you can filter or sort all traces based on the application, length of trace, annotation, or timestamp.

zipkin ui animation


  • Distributed tracing capabilities to asyncio applications.

  • Supports zipkin v2 protocol.

  • Easy to use API.

  • Explicit context handling, no thread local variables.

  • Can work with jaeger and stackdriver (google) through zipkin compatible API.

  • Can be integrated with AWS X-Ray by aws proxy.


Indices and tables