Skip to content
This repository

Zipkin is a distributed tracing system

sync oss

latest commit ce864cd5f8
Jeff Smick sprsquish authored April 16, 2014
Octocat-spinner-32 bin Oss sync April 16, 2014
Octocat-spinner-32 doc Oss sync April 15, 2014
Octocat-spinner-32 project Oss sync April 16, 2014
Octocat-spinner-32 zipkin-anormdb zipkin: Fix tests. April 02, 2014
Octocat-spinner-32 zipkin-browser-extension Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 zipkin-cassandra serially adding binary annotations to a span do not clobber each other April 16, 2014
Octocat-spinner-32 zipkin-collector-core Oss sync April 15, 2014
Octocat-spinner-32 zipkin-collector-scribe Oss sync April 15, 2014
Octocat-spinner-32 zipkin-collector-service Oss sync April 15, 2014
Octocat-spinner-32 zipkin-collector Oss sync April 16, 2014
Octocat-spinner-32 zipkin-common Oss sync April 16, 2014
Octocat-spinner-32 zipkin-example Oss sync April 15, 2014
Octocat-spinner-32 zipkin-gems Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 zipkin-hbase Oss sync April 16, 2014
Octocat-spinner-32 zipkin-kafka Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 zipkin-query-core Oss sync April 16, 2014
Octocat-spinner-32 zipkin-query-service Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 zipkin-query Oss sync April 16, 2014
Octocat-spinner-32 zipkin-receiver-scribe Oss sync April 16, 2014
Octocat-spinner-32 zipkin-redis Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 zipkin-sampler Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 zipkin-scrooge Oss sync April 16, 2014
Octocat-spinner-32 zipkin-storm Oss sync April 16, 2014
Octocat-spinner-32 zipkin-thrift Oss sync April 16, 2014
Octocat-spinner-32 zipkin-tracegen Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 zipkin-web Oss sync April 16, 2014
Octocat-spinner-32 zipkin-zookeeper Oss sync April 15, 2014
Octocat-spinner-32 .gitignore Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 .travis.yml Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 CHANGELOG Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 CONTRIBUTING.md Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 CONTRIBUTORS.md Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 LICENSE Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 NOTICE Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 README.md Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 RELEASE Bring OSS Zipkin into internal repo March 18, 2014
Octocat-spinner-32 build.sbt Bring OSS Zipkin into internal repo March 18, 2014
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

Zipkin provides three services:

  • To collect data: bin/collector
  • To extract data: bin/query
  • To display data: bin/web

You can run these services immediately after downloading Zipkin. Once all three daemons are running, you should be able to visit http://localhost:8080 to view the Zipkin UI. There is also a browser extension which shows visualizations of traces of each page as you browse your website.

The next step is to collect trace data to view in Zipkin. To do this, interface with the collector (e.g. by using Scribe) to record trace data. There are several libraries to make this easier to do in different environments. Twitter uses Finagle; external libraries (currently for Python, REST, node, and Java) are listed in the wiki; and there is also a Ruby gem and Ruby Thrift client.

See the in-depth installation guide for more information on larger / more complex Zipkin installations.

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

Contributing

See CONTRIBUTING.md for guidelines.

Areas where we'd love to see contributions:

  • 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
  • trace data visualizations in the web UI

Versioning

We use SemVer style versioning.

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.