Merging OpenTracing and OpenCensus: A Roadmap to Convergence

Ted Young
Ted Young
Apr 19, 2019 · 6 min read

Authored by Ted Young, Pritam Shah and the “technical specification committee” (Carlos Alberto, Bogdan Drutu, Sergey Kanzhelev, and Yuri Shkuro).

Update: The merged project now has a name!

The short, short version

  • We are creating a new, unified set of libraries and specifications for observability telemetry. It will merge the OpenTracing and OpenCensus projects, and provide a supported migration path.

Project Overview

We’re merging! The high level goal is to synthesize the OpenTracing and OpenCensus projects into a single, unified project. The core of the new project will be a set of clean and well thought interfaces, and a canonical distribution of libraries implementing those interfaces, referred to as the SDK. Recommended standards for data and wire protocols, along with common pieces of infrastructure, complete the project.

The result will be a complete telemetry system — suitable for monitoring microservices and other types of modern, distributed systems — and will be compatible with most major OSS and commercial backends.

Major Milestones

4/24 The reference candidate is presented for review.

5/8 Teams form, and work begins in all languages.

5/20 Project officially launched at Kubecon Barcelona.

9/6 C#, Golang, Java, NodeJS, and Python reach parity with existing projects.

11/6 OpenTracing and OpenCensus projects are officially sunset.

11/20 Sunset party at Observability Summit, Kubecon San Diego.

Timeline to Convergence

The migration for each language involves building a production-ready SDK, instrumentation for popular libraries, documentation, CI, a backwards compatibility bridge, and closing down the associated OpenCensus and OpenTracing projects (“sunsetting”). We have set an ambitious goal of September 2019 as the target date for parity in C#, Golang, Java, NodeJS, and Python. If a language is not ready by that time, we will push back the sunset date until it is. But we prefer this not to happen.

When checking out the goals below, think about how you would like to get involved. Let us know by filling in the signup sheet, or saying hello on the OpenTracing and OpenCensus Gitter chat rooms.

Click here to view the timeline as an infographic.

Goal: First draft of Cross-Language Specification (due May 8th)

It is important that the project remain cohesive, even as we work in parallel on separate languages. The Cross-Language Specification provides this guidance for the project. It is written in prose, and ensures that we maintain a coherent system which feels familiar regardless of programming language.

The first draft of the x-lang spec requires the following:

  • Definitions of common terminology.

This goal blocks all other work, and a first draft must be completed by May 8th.

Goal: First draft of Data Specification (due July 6th)

The Data Specification defines a common data format for tracing and metrics, so that data exported by all processes can be processed by the same telemetry infrastructure, regardless of how the process generated the data. This includes a data schema for the tracing model described in the Cross-Language spec. But it is also includes metadata definitions for common operations that tracing is used to capture, such as HTTP requests, errors, and database queries. These semantic conventions are an example.

The first draft is based on the current OpenCensus data format, and will contain the following:

  • Data Schema which implements the cross-language specification

Note that there is also a wire protocol for propagating traces in-band, which we would like to standardize on. The Trace-Context propagation format is being developed via the W3C, and can be found here.

Goal: Parity in all currently supported languages (due Sep 6th)

In order for the new project to replace the current ones, we must achieve parity with existing language ecosystems.

  • Interface definitions for tracing, metrics, and context propagation, based on the Cross-Language specification.

We also value backwards compatibility, and ensuring a smooth migration from the existing projects.

  • The new SDK will contain an OpenTracing bridge, which implements the current OpenTracing interface. This allows legacy OpenTracing instrumentation to work together with new instrumentation in the same process, so users may migrate their instrumentation code incrementally.

It is a lot of work to create a best-in-class SDK for each language, and this is where we need the most help.

Goal: Core Documentation (due Sep 6th)

Documentation is critical to the success of any open source project. We really want documentation and learning to be a first-class component, and people who write documentation are considered primary committers to this project. Teaching developers how to observe their software correctly is a critical part of the impact we want to make on the world.

At minimum, we need the following to get started:

  • Project Orientation

Writers of all backgrounds and skill levels are welcome! The new website is based on Hugo, written in markdown, and is very easy to contribute to.

Goal: Registry v1.0 (due July 6th)

Another critical component is the Registry, an improved version of the OpenTracing Registry.

  • Easily find libraries, plugins, installers, and other components.

If you’re interested in design, front end, and UX, this is a great project to be a part of.

Goal: Testing and release infrastructure (due Sep 6th)

We have a project wide commitment to building a quality testing and release pipeline, to ensure we continue to ship safe code we can rely on. If you care about testing, benchmarking, and release pipelines, please let us know. We will clearly mark the level of production readiness and the maturity of the testing infrastructure will be a major deciding factor.

Goal: Sunset OpenTracing and OpenCensus (due Nov 6th)

By September 6th, if the new project has reached parity, the existing projects will begin to be shut down. Two months after each language reaches parity, the corresponding OpenTracing and OpenCensus projects will be sunset. This means the following:

  • The repositories will be frozen, and no more commits will be made.

Get Involved

This is a huge project, and we need all hands on deck. If you’ve been curious to learn about observability, this is the perfect time to get involved!


A blog discussing distributed tracing and context…

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store