# dd-trace-java-kinesis-example

**Repository Path**: mirrors_DataDog/dd-trace-java-kinesis-example

## Basic Information

- **Project Name**: dd-trace-java-kinesis-example
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2026-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Kinesis Context Propagation Examples

This repository contains example producers and consumers using the AWS sdk in additon to KPL/KCL.  It leaves out the details of setting up the specific clients

The `SomeMessage` class implements `TextMap` which is the holder for propagation headers and values. An alternative approach to using a `Map` inside the message would be to specify fields for all of the propagation headers separately inside the class and implementing iterator on those

The headers for Datadog propagation are:
```
  TRACE_ID_KEY = "x-datadog-trace-id";
  SPAN_ID_KEY = "x-datadog-parent-id";
  SAMPLING_PRIORITY_KEY = "x-datadog-sampling-priority";
  ORIGIN_KEY = "x-datadog-origin";
``` 

from [DatadogHttpCodec](https://github.com/DataDog/dd-trace-java/blob/master/dd-trace-core/src/main/java/datadog/trace/core/propagation/DatadogHttpCodec.java#L17)
with `"ot-baggage-{name}"` used for baggage

The headers for B3 propagation are: 
```
  TRACE_ID_KEY = "X-B3-TraceId";
  SPAN_ID_KEY = "X-B3-SpanId";
  SAMPLING_PRIORITY_KEY = "X-B3-Sampled";
```
from [B3HttpCodec](https://github.com/DataDog/dd-trace-java/blob/master/dd-trace-core/src/main/java/datadog/trace/core/propagation/B3HttpCodec.java#L23)

A third approach would be using a separate bridge class that implements `TextMap` and in turn set/gets items from message

### Setting up the tracer
With the java agent installed with the application, there is no setup required.  If the java agent is not installed, `NoAgentMain` shows an example of setting up the tracer manually.

### Reference Documentation:
* [Java Tracer Documentation](https://docs.datadoghq.com/tracing/setup/java/)
* [Custom Instrumentation Documentation](https://docs.datadoghq.com/tracing/custom_instrumentation/java/)
* [dd-trace-java on Github](https://github.com/DataDog/dd-trace-java)