Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Zipkin is a distributed tracing system
Java Scala JavaScript Thrift Ruby Python Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
doc
project
zipkin-cassandra/src
zipkin-collector-core/src
zipkin-collector-scribe/src
zipkin-collector-service
zipkin-common/src
zipkin-finatra
zipkin-gems
zipkin-hadoop-job-runner/src
zipkin-hadoop/src
zipkin-kafka
zipkin-query-core/src
zipkin-query-service
zipkin-scrooge/src
zipkin-test
zipkin-thrift/src/main/thrift
.gitignore
.travis.yml
CHANGELOG
LICENSE
NOTICE
README.md
RELEASE
build.sbt

README.md

Zipkin (doc/zipkin-logo-200x119.jpg)

Zipkin is a distributed tracing system that helps us gather timing data for all the disparate services at Twitter.

Full documentation

See http://twitter.github.com/zipkin

Quick start

You'll need Scala 2.9.1

Clone the repo, git clone git://github.com/twitter/zipkin, or download a release

To run a collector daemon: bin/collector

To run a query daemon: bin/query

To run a UI daemon: bin/ui

For a more in-depth installation guide, see: http://twitter.github.com/zipkin/install.html

Get involved

Check out the #zipkin IRC channel on chat.freenode.com to see if any developers are there for questions or live debugging tips. Otherwise, there are two mailing lists you can use to get in touch with other users and developers.

Users: https://groups.google.com/group/zipkin-user

Developers: https://groups.google.com/group/zipkin-dev

Issues

Noticed a bug? https://github.com/twitter/zipkin/issues

Contributions

Contributions are very welcome! Please create a pull request on github and we'll look at it as soon as possible.

Try to make the code in the pull request as focused and clean as possible, stick as close to our code style as you can.

If the pull request is becoming too big we ask that you split it into smaller ones.

Areas where we'd love to see contributions include: adding tracing to more libraries and protocols, interesting reports generated with Hadoop from the trace data, extending collector to support more transports and storage systems and other ways of visualizing the data in the web UI.

Versioning

We use SemVer style versioning.

Authors

Thanks to everyone below for making Zipkin happen!

Zipkin server

Zipkin UI

Instrumentation

License

Copyright 2012 Twitter, Inc.

Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0

Something went wrong with that request. Please try again.