Zipkin Auto Configuration: Azure Event Hub Collector

Zipkin Azure (Parent)

License

License

Categories

Categories

Zipkin Application Testing & Monitoring Application Performance Monitoring (APM) Auto Application Layer Libs Code Generators config Configuration
GroupId

GroupId

io.zipkin.azure
ArtifactId

ArtifactId

zipkin-autoconfigure-collector-eventhub
Last Version

Last Version

0.7.2
Release Date

Release Date

Type

Type

jar
Description

Description

Zipkin Auto Configuration: Azure Event Hub Collector
Zipkin Azure (Parent)
Project Organization

Project Organization

OpenZipkin

Download zipkin-autoconfigure-collector-eventhub

How to add to project

<!-- https://jarcasting.com/artifacts/io.zipkin.azure/zipkin-autoconfigure-collector-eventhub/ -->
<dependency>
    <groupId>io.zipkin.azure</groupId>
    <artifactId>zipkin-autoconfigure-collector-eventhub</artifactId>
    <version>0.7.2</version>
</dependency>
// https://jarcasting.com/artifacts/io.zipkin.azure/zipkin-autoconfigure-collector-eventhub/
implementation 'io.zipkin.azure:zipkin-autoconfigure-collector-eventhub:0.7.2'
// https://jarcasting.com/artifacts/io.zipkin.azure/zipkin-autoconfigure-collector-eventhub/
implementation ("io.zipkin.azure:zipkin-autoconfigure-collector-eventhub:0.7.2")
'io.zipkin.azure:zipkin-autoconfigure-collector-eventhub:jar:0.7.2'
<dependency org="io.zipkin.azure" name="zipkin-autoconfigure-collector-eventhub" rev="0.7.2">
  <artifact name="zipkin-autoconfigure-collector-eventhub" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.zipkin.azure', module='zipkin-autoconfigure-collector-eventhub', version='0.7.2')
)
libraryDependencies += "io.zipkin.azure" % "zipkin-autoconfigure-collector-eventhub" % "0.7.2"
[io.zipkin.azure/zipkin-autoconfigure-collector-eventhub "0.7.2"]

Dependencies

compile (4)

Group / Artifact Type Version
io.zipkin.azure : zipkin-collector-eventhub jar 0.7.2
org.springframework.boot : spring-boot-autoconfigure jar
io.zipkin.zipkin2 : zipkin jar 2.11.7
io.zipkin.zipkin2 : zipkin-collector jar 2.11.7

test (5)

Group / Artifact Type Version
org.springframework.boot : spring-boot-test jar
junit : junit jar 4.12
org.assertj : assertj-core jar 3.11.1
io.zipkin.zipkin2 : zipkin test-jar 2.11.7
ch.qos.logback : logback-classic jar 1.2.3

Project Modules

There are no modules declared in this project.

Gitter chat Build Status Download

zipkin-azure

Shared libraries that provide Zipkin integration with Azure services. Requires JRE 6 or later.

Usage

These components provide Zipkin Senders and Collectors which build off interfaces provided by the zipkin-reporter-java and zipkin projects.

Senders

Collectors

Zipkin collectors receives and decodes span messages from a source. These spans are later stored.

Collector Description
Event Hub An alternative to Kafka.

Server integration

In order to integrate with zipkin-server, you need to use properties launcher to load your collector (or sender) alongside the zipkin-server process.

To integrate a module with a Zipkin server, you need to:

  • add a module jar to the loader.path
  • enable the profile associated with that module
  • launch Zipkin with PropertiesLauncher

Each module will also have different minimum variables that need to be set.

Ex.

$ java -Dloader.path='eventhub.jar,eventhub.jar!/lib' -Dspring.profiles.active=eventhub -cp zipkin.jar org.springframework.boot.loader.PropertiesLauncher

Example integrating the Azure Event Hub Collector

If you cannot use our Docker image, you can still integrate yourself by downloading a couple jars. Here's an example of integrating the Azure Event Hub Collector.

For Windows users Powershell is recommended.

Step 1: Download zipkin-server jar

Download the latest released server as zipkin.jar:

cd /tmp
curl -sSL https://zipkin.io/quickstart.sh | bash -s

Step 2: Download the latest eventhub-module jar

Download the latest released Event Hub module as eventhub.jar:

cd /tmp
curl -sSL https://zipkin.io/quickstart.sh | bash -s io.zipkin.azure:zipkin-autoconfigure-collector-eventhub:LATEST:module eventhub.jar

Step 3: Run the server with the "eventhub" profile active

When you enable the "eventhub" profile, you can configure eventhub with short environment variables similar to other Zipkin integrations.

cd /tmp
EVENTHUB_CONNECTION_STRING=Endpoint=sb://< EventHub Address>;SharedAccessKeyName=<name>;SharedAccessKey=<key> \
EVENTHUB_STORAGE_CONNECTION_STRING=<connection string>;DefaultEndpointsProtocol=https;AccountName=<yourAccountName>;AccountKey=<yourAccountKey> \
java -Dloader.path='eventhub.jar,eventhub.jar!/lib' -Dspring.profiles.active=eventhub -cp zipkin.jar org.springframework.boot.loader.PropertiesLauncher

** NOTE: Make sure the parameters are defined in the same line or use environment variables **

Below command for powershell users:

cd /tmp
EVENTHUB_CONNECTION_STRING=Endpoint=sb://< EventHub Address>;SharedAccessKeyName=<name>;SharedAccessKey=<key>
EVENTHUB_STORAGE_CONNECTION_STRING=<connection string>;DefaultEndpointsProtocol=https;AccountName=<yourAccountName>;AccountKey=<yourAccountKey>
java '-Dloader.path=eventhub.jar,eventhub.jar!/lib' '-Dspring.profiles.active=eventhub' -cp zipkin.jar org.springframework.boot.loader.PropertiesLauncher
io.zipkin.azure

Open Zipkin

Versions

Version
0.7.2
0.7.1
0.7.0
0.6.3
0.6.2
0.6.1
0.6.0
0.5.1
0.5.0
0.4.3
0.4.2
0.4.1
0.4.0
0.3.9
0.3.8
0.3.7
0.3.6
0.3.5
0.3.4
0.3.3
0.3.2
0.3.1
0.3.0
0.2.2
0.2.1
0.2.0
0.1.9
0.1.8
0.1.7
0.1.6
0.1.5
0.1.4
0.1.3
0.1.2
0.1.1
0.1.0