zipkin-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From abe...@apache.org
Subject [incubator-zipkin-website] 03/16: Adds integration page (#119)
Date Sun, 21 Apr 2019 21:02:27 GMT
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 <gunlee01@gmail.com>
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).
+


Mime
View raw message