Skip to content

Latest commit

 

History

History
57 lines (42 loc) · 3.5 KB

extensions_choices.md

File metadata and controls

57 lines (42 loc) · 3.5 KB
Raw
title weight
Server extensions and choices
4

Server extensions

Zipkin server bundles extension for span collection and storage. By default spans can be collected over http, Kafka or RabbitMQ transports and stored in-memory or in MySQL, Cassandra or Elasticsearch.

The following modules add storage or transport extensions to the default server build. Please refer to their individual documentation for setup and configuration guides.

OpenZipkin supported

The following extensions are supported by the OpenZipkin team and are hosted at the OpenZipkin GitHub group. You can reach out to the team on Zipkin Gitter chat.

| Type | Module | Related product | Other notes | |:-----|:--------|:----------------|:------------|{% for extension in site.data.extensions %} | {{ extension.type }} | {{ extension.module }} | {{extension.product}} | {{ extension.notes }} |{% endfor %} {: .wide-table}

Community supported

| Type | Module | Related product | Other notes | |:-----|:--------|:----------------|:------------|{% for extension in site.data.community_extensions %} | {{ extension.type }} | {{ extension.module }} | {{extension.product}} | {{ extension.notes }} |{% endfor %} {: .wide-table}

Alternative servers

The OpenZipkin team publish apis, data formats, and shared libraries that allow alternate backends to process the same data sent to the default Zipkin server.

Community supported

Listed below are alternative backends that accept Zipkin format. Some use the same code as Zipkin on the same endpoints while others are on alternative endpoints or partially support features. In any case, the following aim to allow existing zipkin clients to use backends the OpenZipkin team does not support. Hence, direct questions to their respective communities.

  • Apache SkyWalking
    • When zipkin trace component is enabled, Skywalking exposes the same HTTP POST endpoints and Kafka topic Zipkin does
      • http port 9411 accepts /api/v1/spans (thrift, json) and /api/v2/spans (json, proto) POST requests.
      • Kafka zipkin topic, and zipkin group ID accepts v2 spans encoded as a thrift/json/proto list per message.
      • this extension uses the same encoding library and same endpoints as Zipkin does.
    • Zipkin Lens UI is also bundled in SkyWalking booster UI since 9.4.0. /zipkin is exposed by SkyWalking webapp.
  • Jaeger
    • When COLLECTOR_ZIPKIN_HTTP_PORT=9411 is set, Jaeger exposes a partial implementation of Zipkin's HTTP POST endpoints
      • http port 9411 accepts /api/v1/spans (thrift, json) and /api/v2/spans (json, proto) POST requests.
    • When SPAN_STORAGE_TYPE=kafka and zipkin-thrift, Jaeger reads Zipkin v1 thrift encoded span messages from a Kafka topic.
      • Note: The above is a deprecated practice in Zipkin. Most instrumentation bundle multiple spans per message in v2 format.
  • Pitchfork
    • Pitchfork exposes the same HTTP POST endpoints Zipkin does
      • http port 9411 accepts /api/v1/spans (thrift, json) and /api/v2/spans (json, proto) POST requests.

Did we miss a server extension or alternative? Please open a pull-request to openzipkin.github.io.