Struct AwsSpanBuilder

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

Builder for creating AWS-specific OpenTelemetry spans.

This builder provides a fluent interface for constructing spans with AWS-specific attributes and proper span kinds for different types of AWS operations.

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<'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 key-value 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 key-value 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.