Struct AwsSpanBuilder

pub struct AwsSpanBuilder<'a> { /* private fields */ }

Builder for creating AWS-specific OpenTelemetry spans.

This builder provides a fluent interface for constructing AwsSpan with required attributes and proper span kinds for different types of AWS operations. It automatically sets standard RPC attributes following OpenTelemetry semantic conventions for AWS services.

Usage

This builder can be used with AwsInstrument trait to instrument any AWS operation, or to manually create AwsSpan if you need control over span lifecycle. For automatic instrumentation, use AwsBuilderInstrument trait.

Implementations

impl AwsSpanBuilder<'_>

pub fn dynamodb( method: impl Into<StringValue>, table_names: impl IntoIterator<Item = impl Into<StringValue>>, ) -> Self

Creates a DynamoDB operation span builder.

This method creates a span builder configured for DynamoDB operations with appropriate semantic attributes according to OpenTelemetry conventions.

Arguments

• method - The DynamoDB operation method name (e.g., “GetItem”, “PutItem”)
• table_names - Iterator of table names involved in the operation

Returns

A configured AWS span builder for the DynamoDB operation

impl AwsSpanBuilder<'_>

pub fn firehose( operation_kind: MessagingOperationKind, method: impl Into<StringValue>, stream_name: Option<impl Into<StringValue>>, ) -> Self

Creates a Firehose operation span builder.

This method creates a span builder configured for Firehose operations with appropriate messaging semantic attributes.

Arguments

• operation_kind - The type of messaging operation being performed
• method - The Firehose operation method name
• stream_name - Optional stream name for operations that target specific streams

impl AwsSpanBuilder<'_>

pub fn sns( operation_kind: MessagingOperationKind, method: impl Into<StringValue>, topic_arn: Option<impl Into<StringValue>>, ) -> Self

Creates an SNS operation span builder.

This method creates a span builder configured for SNS operations with appropriate messaging semantic attributes.

Arguments

• operation_kind - The type of messaging operation being performed
• method - The SNS operation method name
• topic_arn - Optional topic ARN for operations that target specific topics

impl AwsSpanBuilder<'_>

pub fn sqs( operation_kind: MessagingOperationKind, method: impl Into<StringValue>, queue: Option<impl Into<StringValue>>, ) -> Self

Creates an SQS operation span builder.

This method creates a span builder configured for SQS operations with appropriate messaging semantic attributes.

Arguments

• operation_kind - The type of messaging operation being performed
• method - The SQS operation method name
• queue - Optional SQS queue URL or name for operations that target specific queues

impl<'a> AwsSpanBuilder<'a>

pub fn client( service: impl Into<StringValue>, method: impl Into<StringValue>, attributes: impl IntoIterator<Item = KeyValue>, ) -> Self

Creates a client span builder for AWS operations.

Client spans represent outbound calls to AWS services from your application.

Arguments

• service - The AWS service name (e.g., “S3”, “DynamoDB”)
• method - The operation name (e.g., “GetObject”, “PutItem”)
• attributes - Additional custom attributes for the span

pub fn producer( service: impl Into<StringValue>, method: impl Into<StringValue>, attributes: impl IntoIterator<Item = KeyValue>, ) -> Self

Creates a producer span builder for AWS operations.

Producer spans represent operations that send messages or data to AWS services.

Arguments

• service - The AWS service name (e.g., “SQS”, “SNS”)
• method - The operation name (e.g., “SendMessage”, “Publish”)
• attributes - Additional custom attributes for the span

pub fn consumer( service: impl Into<StringValue>, method: impl Into<StringValue>, attributes: impl IntoIterator<Item = KeyValue>, ) -> Self

Creates a consumer span builder for AWS operations.

Consumer spans represent operations that receive messages or data from AWS services.

Arguments

• service - The AWS service name (e.g., “SQS”, “Kinesis”)
• method - The operation name (e.g., “ReceiveMessage”, “GetRecords”)
• attributes - Additional custom attributes for the span

pub fn attributes(self, iter: impl IntoIterator<Item = KeyValue>) -> Self

Adds multiple attributes to the span being built.

Arguments

• iter - An iterator of KeyValue attributes to add to the span

pub fn attribute(self, attribute: KeyValue) -> Self

Adds a single attribute to the span being built.

This is a convenience method for adding one attribute at a time.

Arguments

• attribute - The KeyValue attribute to add to the span

pub fn context(self, context: &'a Context) -> Self

Sets the parent Context for the span.

Arguments

• context - The OpenTelemetry Context to use as the parent

pub fn set_context(self, context: Option<&'a Context>) -> Self

Optionally sets the parent Context for the span.

Arguments

• context - An optional OpenTelemetry Context to use as the parent

pub fn start(self) -> AwsSpan

Starts the span and returns an AwsSpan.

This method creates and starts the span using either the explicitly set context or the current tracing span’s context as the parent.