luisgabrielroldan/ddogzip repository overview

⁠DDogZip

DDogZip is a lightweight proxy server that receives traces from Datadog-instrumented applications and forwards them to a Zipkin collector. This allows you to use Datadog's APM instrumentation while visualizing trace data in Zipkin.

Perfect for local development - Debug your distributed tracing without sending data to Datadog's infrastructure.

⁠Features

• Receives traces via Datadog Agent protocol (v0.3, v0.4, v0.5)
• Converts Datadog traces to Zipkin format
• Supports both PUT and POST HTTP methods
• Graceful shutdown with span flushing
• Health check endpoint for container orchestration
• Enhanced error capture (error.msg, error.type, error.stack)
• Multi-architecture support (amd64, arm64)
• Minimal footprint using distroless base image

⁠Quick Start

docker run -p 8126:8126 \
  -e ZIPKIN_HOST=zipkin \
  luisgabrielroldan/ddogzip

⁠Configuration

⁠Docker Compose Example

services:
  zipkin:
    image: openzipkin/zipkin:latest
    ports:
      - "9411:9411"

  ddogzip:
    image: luisgabrielroldan/ddogzip:latest
    ports:
      - "8126:8126"
    environment:
      - ZIPKIN_HOST=zipkin
    depends_on:
      - zipkin

⁠API Endpoints

• PUT/POST /{version}/traces - Receives Datadog trace data (v0.3, v0.4, v0.5)
• GET /health - Health check endpoint

⁠How It Works

1. Datadog-instrumented applications send traces to DDogZip on port 8126
2. DDogZip decodes the msgpack-encoded Datadog trace data
3. Traces are converted from Datadog format to Zipkin format
4. Converted spans are forwarded to the Zipkin collector

⁠Links

• GitHub Repository⁠
• Report Issues⁠

⁠License

MIT License