Java distributed tracing implementation compatible with Zipkin backend services.
Alternatives To Brave
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Jaeger18,7071520821 hours ago304November 02, 2023352apache-2.0Go
CNCF Jaeger, a Distributed Tracing Platform
Zipkin16,531476715 hours ago122November 16, 2023226apache-2.0Java
Zipkin is a distributed tracing system
Tempo3,376711 hours ago99August 17, 2022163agpl-3.0Go
Grafana Tempo is a high volume, minimal dependency distributed tracing backend.
Brave2,289731423 months ago142May 11, 2023124apache-2.0Java
Java distributed tracing implementation compatible with Zipkin backend services.
Spring Cloud Sleuth1,7351,242562 days ago72June 29, 202340apache-2.0Java
Distributed tracing for spring cloud
Opentelemetry Rust1,425121112 hours ago29November 06, 2023144apache-2.0Rust
OpenTelemetry API and SDK for Rust
4 years ago49apache-2.0C
php probe for zipkin and opentracing
Opencensus Java673713217 months ago47April 29, 2022113apache-2.0Java
A stats collection and distributed tracing framework
Opentelemetry Php612
9 days ago9March 30, 202225apache-2.0PHP
The OpenTelemetry PHP Library
Zipkin Go5821,4921,5734 months ago31August 10, 202313apache-2.0Go
Zipkin distributed tracing library for go.
Alternatives To Brave
Select To Compare

Alternative Project Comparisons

Gitter chat Build Status Maven Central


Brave is a distributed tracing instrumentation library. Brave typically intercepts production requests to gather timing data, correlate and propagate trace contexts. While typically trace data is sent to Zipkin server, third-party plugins are available to send to alternate services such as Amazon X-Ray.

This repository includes dependency-free Java libraries and instrumentation for common components used in production services. For example, this includes trace filters for Servlet and log correlation for Apache Log4J.

You can look at our example project for how to trace a simple web application.

What's included

Brave's dependency-free tracer library works against JRE6+. This is the underlying api that instrumentation use to time operations and add tags that describe them. This library also includes code that parses X-B3-TraceId headers.

Most users won't write tracing code directly. Rather, they reuse instrumentation others have written. Check our instrumentation and Zipkin's list before rolling your own. Common tracing libraries like JDBC, Servlet and Spring already exist. Instrumentation written here are tested and benchmarked.

If you are trying to trace legacy applications, you may be interested in Spring XML Configuration. This allows you to set up tracing without any custom code.

You may want to put trace IDs into your log files, or change thread local behavior. Look at our context libraries, for integration with tools such as SLF4J.

Version Compatibility policy

All Brave libraries match the minimum Java version of what's being traced or integrated with, and adds no 3rd party dependencies. The goal is to neither impact your projects' choices, nor subject your project to dependency decisions made by others.

For example, even including a basic reporting library, zipkin-sender-urlconnection, Brave transitively includes no json, logging, protobuf or thrift dependency. This means zero concern if your application chooses a specific version of SLF4J, Gson or Guava. Moreover, the entire dependency tree including basic reporting in json, thrift or protobuf is less than 512KiB of jars.

There is a floor Java version of 1.6, which allows older JREs and older Android runtimes, yet may limit some applications. For example, Servlet 2.5 works with Java 1.5, but due to Brave being 1.6, you will not be able to trace Servlet 2.5 applications until you use at least JRE 1.6.

All integrations set their associated library to "provided" scope. This ensures Brave doesn't interfere with the versions you choose.

Some libraries update often which leads to api drift. In some cases, we test versions ranges to reduce the impact of this. For example, we test gRPC and Kafka against multiple library versions.


All artifacts publish to the group ID "io.zipkin.brave". We use a common release version for all components.

Library Releases

Snapshots are uploaded to Sonatype which synchronizes with Maven Central

Library Snapshots

Snapshots are uploaded to Sonatype after commits to master.

Version alignments

When using multiple brave components, you'll want to align versions in one place. This allows you to more safely upgrade, with less worry about conflicts.

You can use our Maven instrumentation BOM (Bill of Materials) for this:

Ex. in your dependencies section, import the BOM like this:


Now, you can leave off the version when choosing any supported instrumentation. Also, any indirect use will have versions aligned:


With the above in place, you can use the property brave.version to override dependency versions coherently. This is most commonly to test a new feature or fix.

Note: If you override a version, always double check that your version is valid (equal to or later) than what you are updating. This will avoid class conflicts.

Popular Zipkin Projects
Popular Tracing Projects
Popular Operations Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Distributed Tracing