io.zipkin.aws:brave-instrumentation-parent

Zipkin AWS (Parent)

License	The Apache Software License, Version 2.0
Categories	AWS Container PaaS Providers Zipkin Application Testing & Monitoring Application Performance Monitoring (APM)
GroupId	io.zipkin.aws
ArtifactId	brave-instrumentation-parent
Last Version	0.22.1
Release Date	Nov 1, 2020
Type	pom
Description	Zipkin AWS (Parent)
Project Organization	OpenZipkin

Download brave-instrumentation-parent

Filename	Size
brave-instrumentation-parent-0.22.1.pom	1 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.zipkin.aws/brave-instrumentation-parent/ -->
<dependency>
    <groupId>io.zipkin.aws</groupId>
    <artifactId>brave-instrumentation-parent</artifactId>
    <version>0.22.1</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.zipkin.aws/brave-instrumentation-parent/
implementation 'io.zipkin.aws:brave-instrumentation-parent:0.22.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.zipkin.aws/brave-instrumentation-parent/
implementation ("io.zipkin.aws:brave-instrumentation-parent:0.22.1")

Apache Buildr

'io.zipkin.aws:brave-instrumentation-parent:pom:0.22.1'

Apache Ivy

<dependency org="io.zipkin.aws" name="brave-instrumentation-parent" rev="0.22.1">
  <artifact name="brave-instrumentation-parent" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.zipkin.aws', module='brave-instrumentation-parent', version='0.22.1')
)

Scala SBT

libraryDependencies += "io.zipkin.aws" % "brave-instrumentation-parent" % "0.22.1"

Leiningen

[io.zipkin.aws/brave-instrumentation-parent "0.22.1"]

Dependencies

test (7)

Group / Artifact	Type	Version
junit : junit	jar	4.13.1
org.junit.jupiter : junit-jupiter	jar	5.7.0
org.junit.vintage : junit-vintage-engine	jar	5.7.0
org.junit.jupiter : junit-jupiter-api	jar	5.7.0
org.junit.jupiter : junit-jupiter-engine	jar	5.7.0
org.assertj : assertj-core	jar	3.17.2
ch.qos.logback : logback-classic	jar	1.2.3

Project Modules

• aws-java-sdk-core
• aws-java-sdk-v2-core
• aws-java-sdk-sqs

zipkin-aws

Shared libraries that provide Zipkin integration with AWS Kinesis, SQS, and X-Ray. Requires JRE 8 or later.

Usage

These components provide Zipkin Reporters and Senders, which build off interfaces provided by the zipkin-reporters-java, and and Collectors, which are used in a Zipkin server.

We also have tracing libraries that extend Brave.

Tracing libraries

Tracing libraries extend Brave and ensure Amazon libraries are visible in your traces.

Instrumentation	Description
AWS SDK	Traces AmazonWebServiceClient
AWS SDK V2	Traces SdkClient
AWS SQS Messaging	Traces AmazonSQS

We also have a library to read Amazon's trace header.

Reporters and Senders

The component in a traced application that sends timing data (spans) out of process is called a Reporter. It is responsible for handling the queueing and encoding of outbound spans.

Reporters that are sending Zipkin data to Zipkin typically make use of a Sender, which implements the wire protocol to a particular technology used to send the encoded spans. Typically Senders are called on interval by an async reporter.

NOTE: Applications can be written in any language. While we currently only have Reporters and Senders in Java, senders in other languages are welcome.

Reporter	Description
X-Ray UDP	Reports spans to X-Ray, AWS's alternative to Zipkin.

Sender	Description
SQS	Sends tracing data to Zipkin using SQS, a message queue service.
SQS v2	Sends tracing data to Zipkin using SQS, a message queue service.
Kinesis	Sends tracing data to Zipkin using Kinesis, an alternative similar to Kafka.

Collectors

The component in a zipkin server that receives trace data is called a collector. This decodes spans reported by applications and persists them to a configured storage component.

Collector	Description
SQS	An alternative to Kafka.
Kinesis	An alternative to Kafka.

Server integration

Integration with Zipkin server is done for you in [Docker][docker]. If you cannot use Docker, you can integrate a Java module instead.

Configuration layered over Zipkin server is documented here.

Artifacts

All artifacts publish to the group ID "io.zipkin.aws". We use a common release version for all components.

Library Releases

Releases are at Sonatype and Maven Central

Library Snapshots

Snapshots are uploaded to Sonatype after commits to master.

Docker Images

Released versions of zipkin-aws are published to Docker Hub as openzipkin/zipkin-aws and GitHub Container Registry as ghcr.io/openzipkin/zipkin-aws.

See docker for details.

Open Zipkin

Versions

Version
0.22.1 Nov 1, 2020
0.22.0 Oct 23, 2020
0.21.3 Aug 24, 2020
0.21.2 May 30, 2020
0.21.1 May 14, 2020
0.21.0 Apr 16, 2020
0.20.0 Feb 28, 2020
0.19.1 Nov 6, 2019
0.19.0 Oct 16, 2019
0.18.1 Sep 29, 2019
0.18.0 Aug 26, 2019
0.17.4 Aug 17, 2019
0.17.3 Aug 16, 2019
0.17.2 Jul 5, 2019
0.17.1 Jun 15, 2019
0.17.0 May 11, 2019
0.16.4 Apr 6, 2019
0.16.3 Apr 2, 2019
0.16.2 Mar 16, 2019
0.16.1 Mar 9, 2019
0.16.0 Mar 4, 2019
0.15.5 Mar 2, 2019
0.15.4 Feb 24, 2019
0.15.3 Jan 21, 2019
0.15.2 Dec 18, 2018
0.15.1 Dec 6, 2018
0.15.0 Dec 5, 2018
0.14.0 Oct 26, 2018