AWS SDK
OpenTelemetry Java agent instrumentation
This instrumentation covers the AWS SDK 2.2+ client library, enabling messaging and client spans and metrics for calls to AWS services including DynamoDB, EC2, Kinesis, Lambda, RDS, S3, SNS/SQS and Bedrock.
- Name:
aws-sdk-2.2 - Scope:
io.opentelemetry.aws-sdk-2.2 - Target versions:
software.amazon.awssdk:aws-core:[2.2.0,),software.amazon.awssdk:bedrockruntime:[2.25.63,),software.amazon.awssdk:lambda:[2.17.0,),software.amazon.awssdk:sns:[2.2.0,),software.amazon.awssdk:sqs:[2.2.0,) - Library: https://aws.amazon.com/sdk-for-java/
Telemetry
- Metrics:
gen_ai.client.operation.duration,gen_ai.client.token.usage,db.client.operation.duration - Span attributes:
aws.agent,aws.dynamodb.consumed_capacity,aws.dynamodb.count,aws.dynamodb.global_secondary_indexes,aws.dynamodb.item_collection_metrics,aws.dynamodb.limit,aws.dynamodb.provisioned_read_capacity,aws.dynamodb.provisioned_write_capacity,aws.dynamodb.scanned_count,aws.dynamodb.select,aws.dynamodb.table_count,aws.dynamodb.table_names,aws.kinesis.stream_name,aws.lambda.function.arn,aws.lambda.function.name,aws.lambda.resource_mapping.id,aws.queue.name,aws.request_id,aws.s3.bucket,aws.secretsmanager.secret.arn,aws.sns.topic.arn,aws.sqs.queue.url,aws.step_functions.activity.arn,aws.step_functions.state_machine.arn,db.operation,db.system,gen_ai.operation.name,gen_ai.provider.name,gen_ai.request.max_tokens,gen_ai.request.model,gen_ai.request.stop_sequences,gen_ai.request.temperature,gen_ai.request.top_p,gen_ai.response.finish_reasons,gen_ai.usage.input_tokens,gen_ai.usage.output_tokens,http.request.method,http.response.status_code,messaging.destination.name,rpc.method,rpc.service,rpc.system,server.address,server.port,url.full,messaging.batch.message_count,messaging.message.id,messaging.operation,messaging.system,db.collection.name,db.operation.batch.size,db.operation.name,db.system.name
Configuration
| Option | Type | Default | Description |
|---|---|---|---|
otel.instrumentation.messaging.experimental.capture-headers | list | A comma-separated list of header names to capture as span attributes. | |
otel.instrumentation.aws-sdk.experimental-record-individual-http-error | boolean | false | Determines whether errors returned by each individual HTTP request should be recorded as events for the SDK span. |
otel.instrumentation.aws-sdk.experimental-span-attributes | boolean | false | Enables experimental span attributes aws.agent, aws.lambda.function.arn and aws.lambda.function.name for AWS SDK instrumentation. |
otel.instrumentation.aws-sdk.experimental-use-propagator-for-messaging | boolean | false | Determines whether the configured TextMapPropagator should be used to inject into supported messaging attributes (for SQS). |
otel.instrumentation.genai.capture-message-content | boolean | false | Determines whether Generative AI events include full content of user and assistant messages. Note that full content can have data privacy and size concerns and care should be taken when enabling this |
otel.instrumentation.messaging.experimental.receive-telemetry.enabled | boolean | false | Enables experimental receive telemetry, which will cause consumers to start a new trace, with only a span link connecting it to the producer trace. |