ankurcha/stackdriver-zipkin repository overview

⁠Stackdriver Trace adapters for Zipkin.

This project provides adapters so that Zipkin tracing libraries can be used with the Stackdriver Trace service.

Note: Due to differences between the Zipkin data model and the Stackdriver Trace data model, only Zipkin traces that are recorded from Zipkin libraries that properly record timestamps⁠ will be converted correctly. Converting Zipkin traces from other libraries may result in disconnected spans within a trace.

⁠Collector

A drop-in replacement for the standard Zipkin HTTP collector that writes to the Stackdriver Trace service.

⁠Credentials

The collector uses Google Application Default Credentials⁠ for authentication to the Stackdriver Trace API.

⁠Example Usage

⁠Using an explicit file path

GOOGLE_APPLICATION_CREDENTIALS="/path/to/credentials.json" PROJECT_ID="my_project_id" java -jar collector.jar

⁠Using a built-in GCP service account (such as on Google Compute Engine)

PROJECT_ID="my_project_id" java -jar collector.jar

⁠Using Docker

docker run -d -e PROJECT_ID="my_project_id" -p 9411:9411 b.gcr.io/stackdriver-trace-docker/zipkin-collector

⁠Storage

A write-only Zipkin storage component that writes to the Stackdriver Trace service. This can be used with zipkin-server.

⁠Translation

Contains code for translating from the Zipkin data model to the Stackdriver Trace data model.