https://github.com/yammer/telemetry

A dapper-like substance in Java.
https://github.com/yammer/telemetry

Last synced: about 2 months ago
JSON representation

A dapper-like substance in Java.

• Host: GitHub
• URL: https://github.com/yammer/telemetry
• Owner: yammer
• License: apache-2.0
• Created: 2013-07-22T16:06:12.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2014-06-26T20:36:58.000Z (over 11 years ago)
• Last Synced: 2025-07-06T17:49:48.043Z (6 months ago)
• Language: Java
• Homepage:
• Size: 967 KB
• Stars: 19
• Watchers: 43
• Forks: 7
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-java - Telemetry

README

          
# Telemetry [![Build Status](https://travis-ci.org/yammer/telemetry.png)](https://travis-ci.org/yammer/telemetry)

Make your app talk…and talk…and talk. Inspired by Google's [Dapper](http://research.google.com/pubs/pub36356.html).

Here is a sample trace view generated by the

[TracingBundle](telemetry-dropwizard/src/main/java/com/yammer/telemetry/dropwizard/TracingBundle.java) of the

execution of the [TracedResource](telemetry-example/src/main/java/com/yammer/telemetry/example/resources/TracedResource.java) in the telemetry-example application.

![Sample Span](/telemetry-service/screenshot.png "Sample Span View")

## IDs

Trace and span IDs will be expressed as 64-bit and 32-bit longs respectively.

## Trace/Span Passing

In order to trace across hosts trace ID and span ID information must be passed from one host to the next.

### Over HTTP

Clients will pass the current trace ID and the current span ID to downstream services via HTTP request headers:

    X-Telemetry-TraceId: {current trace ID}

    X-Telemetry-SpanId: {current span ID}

    X-Telemetry-Parent-SpanId: {parent span ID, may be absent if this is the root span}

## Notes

   * Under heavy development - stuff **will** change

   * Telemetry-Service has been deprecated for now to concentrate on instrumentation and trace recording