Struct SpanAttributesBuilder

pub struct SpanAttributesBuilder<S: State = Empty> { /* private fields */ }

Use builder syntax to set the inputs and finish with build().

Implementations

impl<S: State> SpanAttributesBuilder<S>

pub fn build(self) -> SpanAttributes

where S: IsComplete,

Finish building and return the requested object

pub fn kind(self, value: String) -> SpanAttributesBuilder<SetKind<S>>

where S::Kind: IsUnset,

Optional (Some / Option setters).

Optional span kind (defaults to SERVER if not provided) Valid values: “SERVER”, “CLIENT”, “PRODUCER”, “CONSUMER”, “INTERNAL”

pub fn maybe_kind( self, value: Option<String>, ) -> SpanAttributesBuilder<SetKind<S>>

where S::Kind: IsUnset,

Optional (Some / Option setters).

Optional span kind (defaults to SERVER if not provided) Valid values: “SERVER”, “CLIENT”, “PRODUCER”, “CONSUMER”, “INTERNAL”

pub fn span_name(self, value: String) -> SpanAttributesBuilder<SetSpanName<S>>

where S::SpanName: IsUnset,

Optional (Some / Option setters).

Optional span name. For HTTP spans, this should be “{http.method} {http.route}” Example: “GET /users/:id”

pub fn maybe_span_name( self, value: Option<String>, ) -> SpanAttributesBuilder<SetSpanName<S>>

where S::SpanName: IsUnset,

Optional (Some / Option setters).

Optional span name. For HTTP spans, this should be “{http.method} {http.route}” Example: “GET /users/:id”

pub fn attributes( self, value: HashMap<String, Value>, ) -> SpanAttributesBuilder<SetAttributes<S>>

where S::Attributes: IsUnset,

Optional (Some / Option setters). Default: <HashMap<String, Value> as Default>::default().

Custom attributes to add to the span. Follow OpenTelemetry semantic conventions for naming: https://opentelemetry.io/docs/specs/semconv/

pub fn maybe_attributes( self, value: Option<HashMap<String, Value>>, ) -> SpanAttributesBuilder<SetAttributes<S>>

where S::Attributes: IsUnset,

Optional (Some / Option setters). Default: <HashMap<String, Value> as Default>::default().

Custom attributes to add to the span. Follow OpenTelemetry semantic conventions for naming: https://opentelemetry.io/docs/specs/semconv/

pub fn links(self, value: Vec<Link>) -> SpanAttributesBuilder<SetLinks<S>>

where S::Links: IsUnset,

Optional (Some / Option setters). Default: <Vec<Link> as Default>::default().

Optional span links for connecting related traces. Useful for batch processing or joining multiple workflows.

pub fn maybe_links( self, value: Option<Vec<Link>>, ) -> SpanAttributesBuilder<SetLinks<S>>

where S::Links: IsUnset,

Optional (Some / Option setters). Default: <Vec<Link> as Default>::default().

Optional span links for connecting related traces. Useful for batch processing or joining multiple workflows.

pub fn carrier( self, value: HashMap<String, String>, ) -> SpanAttributesBuilder<SetCarrier<S>>

where S::Carrier: IsUnset,

Optional (Some / Option setters).

Optional carrier headers for context propagation. Supports both W3C Trace Context and AWS X-Ray formats:

• traceparent: W3C format containing trace ID, span ID, and trace flags
• tracestate: W3C vendor-specific trace information
• x-amzn-trace-id: AWS X-Ray trace header format

pub fn maybe_carrier( self, value: Option<HashMap<String, String>>, ) -> SpanAttributesBuilder<SetCarrier<S>>

where S::Carrier: IsUnset,

Optional (Some / Option setters).

Optional carrier headers for context propagation. Supports both W3C Trace Context and AWS X-Ray formats:

• traceparent: W3C format containing trace ID, span ID, and trace flags
• tracestate: W3C vendor-specific trace information
• x-amzn-trace-id: AWS X-Ray trace header format

pub fn trigger(self, value: String) -> SpanAttributesBuilder<SetTrigger<S>>

where S::Trigger: IsUnset,

Optional (Some / Option setters). Default: TriggerType::Other.to_string().

The type of trigger for this Lambda invocation. Common values: “datasource”, “http”, “pubsub”, “timer”, “other” Custom values can be used for more specific triggers.

pub fn maybe_trigger( self, value: Option<String>, ) -> SpanAttributesBuilder<SetTrigger<S>>

where S::Trigger: IsUnset,

Optional (Some / Option setters). Default: TriggerType::Other.to_string().

The type of trigger for this Lambda invocation. Common values: “datasource”, “http”, “pubsub”, “timer”, “other” Custom values can be used for more specific triggers.