Skip to main content

Build Status

python-zipkin is an api for recording and sending messages to Zipkin. Why use it? From the http://twitter.github.io/zipkin/:

“Collecting traces helps developers gain deeper knowledge about how certain requests perform in a distributed system. Let’s say we’re having problems with user requests timing out. We can look up traced requests that timed out and display it in the web UI. We’ll be able to quickly find the service responsible for adding the unexpected response time. If the service has been annotated adequately we can also find out where in that service the issue is happening.”

Supported versions

Python: 2.6, 2.7 (the current Python Thrift release doesn’t support Python 3)

Recording annotations

python-zipkin creates a single span per served requests. It automatically adds a number of annotations (see below). You can also add your own annotations from anywhere in your code:

from zipkin.api import api as zipkin_api

zipkin_api.record_event('MySQL: "SELECT * FROM auth_users"', duration=15000)  # Note duration is in microseconds, as defined by Zipkin
zipkin_api.record_key_value('Cache misses', 15)  # You can use string, int, long and bool values

Hacking

See CONTRIBUTING.md for guidelines.

You can start hacking on python-zipkin with:

git clone https://github.com/prezi/python-zipkin.git
cd python-zipkin
git remote rename origin upstream
virtualenv virtualenv
. virtualenv/bin/activate
python setup.py test

Release files for zipkin 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zipkin 0.1.0
File Size Uploaded
zipkin-0.1.0.tar.gz 15.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for zipkin 0.1.0
File Interpreter ABI Platform
zipkin-0.1.0-py2-none-any.whl Python 2 none any Details

Total release size: 38.2 kB

Release files / zipkin-0.1.0.tar.gz

Download URL zipkin-0.1.0.tar.gz
Size 15.0 kB
Tags Source
SHA-256 checksum
How to use checksums
2cd0899f170ddf39f00090e59dd33ca8e5d0d72bd90b6d698017fddfc9ba5bea
BLAKE2b-256 checksum
How to use checksums
45235deac7015d0f3911c86d9016cced56cb8a16a9cda7760df24d12fb97e02d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / zipkin-0.1.0-py2-none-any.whl

Download URL zipkin-0.1.0-py2-none-any.whl
Size 23.1 kB
Tags Python 2
SHA-256 checksum
How to use checksums
b1ea2e000c129c7780b658fd5fdbac9990ef9ebc3a840d864c0f918f1a9a2cd7
BLAKE2b-256 checksum
How to use checksums
be4c01043aeadb96da11df472c45bccf9c1fd71f18feeab7cf346a334294edc6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page