27 lines
1.1 KiB
Markdown
27 lines
1.1 KiB
Markdown
# AWS Java SDK v2 Instrumentation
|
|
|
|
Instrumentation for [AWS Java SDK v2](https://github.com/aws/aws-sdk-java-v2).
|
|
|
|
## Usage
|
|
|
|
To instrument all AWS SDK clients include the `opentelemetry-aws-sdk-2.2-autoconfigure` submodule in your classpath.
|
|
|
|
To register instrumentation only on a specific SDK client, register the interceptor when creating it.
|
|
|
|
```java
|
|
DynamoDbClient client = DynamoDbClient.builder()
|
|
.overrideConfiguration(ClientOverrideConfiguration.builder()
|
|
.addExecutionInterceptor(AwsSdk.newInterceptor()))
|
|
.build())
|
|
.build();
|
|
```
|
|
|
|
## Trace propagation
|
|
|
|
The AWS SDK instrumentation currently only supports injecting the trace header into the request
|
|
using the [AWS Trace Header](https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html#xray-concepts-tracingheader) format.
|
|
This format is the only format recognized by AWS managed services, and populating will allow
|
|
propagating the trace through them. If this does not fulfill your use case, perhaps because you are
|
|
using the same SDK with a different non-AWS managed service, let us know so we can provide
|
|
configuration for this behavior.
|