elodina/zipkin

Name: zipkin

Owner: Elodina

Description: Zipkin is a distributed tracing system

Created: 2015-10-26 12:18:50.0

Updated: 2015-12-23 03:18:28.0

Pushed: 2015-10-26 01:17:03.0

Homepage: http://zipkin.io

Size: 6484

Language: Scala

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Zipkin is a distributed tracing system. It helps gather timing data needed to troubleshoot latency problems in microservice architectures. The front end is a “waterfall” style graph of service calls showing call durations as horizontal bars:

Running Zipkin

Zipkin is a collection of processes (a backend for the data, a “collector”, and query engine, and a web UI) and all of them need to be running to make any progress:

If you are familiar with Docker, the quickest way to get started quickly is to use the Docker Zipkin project, which (in addition to being able to build docker images) provides scripts and a docker-compose.yml for launching pre-built images, e.g.

t clone https://github.com/openzipkin/docker-zipkin
 docker-zipkin
cker-compose up

If you are happy building from source you can use the scripts in the bin directory of this repository.

Here's how to start zipkin using the default file-based backend and view traces.

t the zipkin source and change to its directory
t clone https://github.com/openzipkin/zipkin; cd zipkin
art the collector server in a new terminal session or tab
bin/collector
art the query server in a new terminal session or tab
bin/query
art the web server in a new terminal session or tab
bin/web
eate dummy traces
bin/tracegen
en the ui and look at them!
en http://localhost:8080/

Full documentation

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

Get involved

Join the openzipkin/zipkin gitter chat for questions and to talk with the developers. 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? Please file an issue

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