This is an automated email from the ASF dual-hosted git repository. abesto pushed a commit to branch sync-from-githubio in repository https://gitbox.apache.org/repos/asf/incubator-zipkin-website.git
commit febd736f0e8da4fd1b4cc6cc72fc8dd53fdef40f Author: Gunhee Lee <[email protected]> AuthorDate: Tue Jan 1 13:56:25 2019 +0900 Adds integration page (#119) --- _data/community_transport_integrations.yml | 6 ++++ _data/openzipkin_transport_integrations.yml | 50 +++++++++++++++++++++++++++++ pages/existing_transport_integrations.md | 39 ++++++++++++++++++++++ 3 files changed, 95 insertions(+) diff --git a/_data/community_transport_integrations.yml b/_data/community_transport_integrations.yml new file mode 100644 index 0000000..200c6e4 --- /dev/null +++ b/_data/community_transport_integrations.yml @@ -0,0 +1,6 @@ +- type: Storage + module: >- + [zipkin-scouter storage-scouter](https://github.com/scouter-project/zipkin-scouter) + product: >- + [Scouter APM](https://github.com/scouter-project/scouter) + notes: only supports sending to an Scouter diff --git a/_data/openzipkin_transport_integrations.yml b/_data/openzipkin_transport_integrations.yml new file mode 100644 index 0000000..deabfe7 --- /dev/null +++ b/_data/openzipkin_transport_integrations.yml @@ -0,0 +1,50 @@ +- type: Collector + module: >- + [zipkin-aws collector-sqs](https://github.com/openzipkin/zipkin-aws/tree/master/autoconfigure/collector-sqs) + product: >- + [AWS SQS](https://aws.amazon.com/sqs/) + notes: + +- type: Collector + module: >- + [zipkin-aws collector-kinesis](https://github.com/openzipkin/zipkin-aws/tree/master/autoconfigure/collector-kinesis) + product: >- + [AWS Kinesis](https://aws.amazon.com/kinesis/) + notes: + +- type: Storage + module: >- + [zipkin-aws storage-elasticsearch-aws](https://github.com/openzipkin/zipkin-aws/tree/master/autoconfigure/storage-elasticsearch-aws) + product: >- + [AWS Elasticsearch Service](https://aws.amazon.com/elasticsearch-service/) + notes: + +- type: Storage + module: >- + [zipkin-aws storage-xray](https://github.com/openzipkin/zipkin-aws/tree/master/autoconfigure/storage-xray) + product: >- + [AWS X-Ray](https://aws.amazon.com/xray/) + notes: only supports sending to an XRay UDP daemon + +- type: Storage + module: >- + [zipkin-gcp storage-stackdriver](https://github.com/openzipkin/zipkin-gcp/tree/master/autoconfigure/storage-stackdriver) + product: >- + [GCP Stackdriver](https://cloud.google.com/stackdriver/) + notes: only supports sending to an Stackdriver + +- type: Collector + module: >- + [zipkin-collector kafka08](https://github.com/openzipkin/zipkin/tree/master/zipkin-autoconfigure/collector-kafka08) + product: >- + [Apache kafka](https://kafka.apache.org/) + notes: Kafka 8.2.2+ + +- type: Collector + module: >- + [zipkin-collector scribe](https://github.com/openzipkin/zipkin/tree/master/zipkin-autoconfigure/collector-scribe) + product: >- + [Scribe](https://github.com/facebookarchive/scribe) + notes: + + diff --git a/pages/existing_transport_integrations.md b/pages/existing_transport_integrations.md new file mode 100644 index 0000000..638b101 --- /dev/null +++ b/pages/existing_transport_integrations.md @@ -0,0 +1,39 @@ +--- +title: Existing server integrations +weight: 4 +--- + +### OpenZipkin server integrations +Zipkin server bundles integration 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. Zipkin is extensible with external modules which allow alternate transport or storage options. Here is a list of ones maintained by the core team. + +| Type | Module | Related product | Other notes | +|:-----|:--------|:----------------|:------------|{% for integration in site.data.openzipkin_transport_integrations %} +| {{ integration.type }} | {{ integration.module }} | {{integration.product}} | {{ integration.notes }} |{% endfor %} +{: .wide-table} + + +### Community server integrations + +| Type | Module | Related product | Other notes | +|:-----|:--------|:----------------|:------------|{% for integration in site.data.community_transport_integrations %} +| {{ integration.type }} | {{ integration.module }} | {{integration.product}} | {{ integration.notes }} |{% endfor %} +{: .wide-table} + + +### Community server Alternatives +Listed below are alternative servers 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, these integrations aim to allow existing zipkin clients to use alternative backends the OpenZipkin team does not support. Hence, direct questions to their respective communities. + + - [Apache SkyWalking](https://github.com/apache/incubator-skywalking) + - When [zipkin-receiver](https://github.com/apache/incubator-skywalking/blob/master/docs/en/setup/backend/backend-receivers.md) is enabled, Skywalking 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. + - this integration uses the same encoding library and same endpoints as zipkin does. + - [jaeger](https://github.com/jaegertracing/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, but not 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](https://github.com/openzipkin/zipkin/tree/master/zipkin-collector/kafka#legacy-encoding) in Zipkin. Most instrumentation bundle multiple spans per message in v2 format. + + +Did we miss an integration? Please open a pull-request to +[openzipkin.github.io](https://github.com/openzipkin/openzipkin.github.io). +
