OpenTelemetry.Trace.TraceState

The main purpose of the tracestate HTTP header is to provide additional vendor-specific trace identification information across different distributed tracing systems and is a companion header for the traceparent field. It also conveys information about the request’s position in multiple distributed tracing graphs.

The tracestate field may contain any opaque value in any of the keys. Tracestate MAY be sent or received as multiple header fields. Multiple tracestate header fields MUST be handled as specified by RFC7230 Section 3.2.2 Field Order. The tracestate header SHOULD be sent as a single field when possible, but MAY be split into multiple header fields. When sending tracestate as multiple header fields, it MUST be split according to RFC7230. When receiving multiple tracestate header fields, they MUST be combined into a single header according to RFC7230.

See the W3C specification https://www.w3.org/TR/trace-context/#tracestate-header for more details.

Documentation

newtype TraceState

Data structure compliant with the storage and serialization needs of the W3C tracestate header.

Constructors

TraceState [(Key, Value)]

Instances

Show TraceState

Defined in OpenTelemetry.Trace.TraceState

Methods

showsPrec :: Int -> TraceState -> ShowS

show :: TraceState -> String

showList :: [TraceState] -> ShowS

Eq TraceState

Defined in OpenTelemetry.Trace.TraceState

Methods

(==) :: TraceState -> TraceState -> Bool

(/=) :: TraceState -> TraceState -> Bool

Ord TraceState

Defined in OpenTelemetry.Trace.TraceState

Methods

compare :: TraceState -> TraceState -> Ordering

(<) :: TraceState -> TraceState -> Bool

(<=) :: TraceState -> TraceState -> Bool

(>) :: TraceState -> TraceState -> Bool

(>=) :: TraceState -> TraceState -> Bool

max :: TraceState -> TraceState -> TraceState

min :: TraceState -> TraceState -> TraceState

newtype Key

Constructors

Key Text

Instances

Show Key

Defined in OpenTelemetry.Trace.TraceState

Methods

showsPrec :: Int -> Key -> ShowS

show :: Key -> String

showList :: [Key] -> ShowS

Eq Key

Defined in OpenTelemetry.Trace.TraceState

Methods

(==) :: Key -> Key -> Bool

(/=) :: Key -> Key -> Bool

Ord Key

Defined in OpenTelemetry.Trace.TraceState

Methods

compare :: Key -> Key -> Ordering

(<) :: Key -> Key -> Bool

(<=) :: Key -> Key -> Bool

(>) :: Key -> Key -> Bool

(>=) :: Key -> Key -> Bool

max :: Key -> Key -> Key

min :: Key -> Key -> Key

newtype Value

Constructors

Value Text

Instances

Show Value

Defined in OpenTelemetry.Trace.TraceState

Methods

showsPrec :: Int -> Value -> ShowS

show :: Value -> String

showList :: [Value] -> ShowS

Eq Value

Defined in OpenTelemetry.Trace.TraceState

Methods

(==) :: Value -> Value -> Bool

(/=) :: Value -> Value -> Bool

Ord Value

Defined in OpenTelemetry.Trace.TraceState

Methods

compare :: Value -> Value -> Ordering

(<) :: Value -> Value -> Bool

(<=) :: Value -> Value -> Bool

(>) :: Value -> Value -> Bool

(>=) :: Value -> Value -> Bool

max :: Value -> Value -> Value

min :: Value -> Value -> Value

empty :: TraceState

An empty TraceState key-value pair dictionary

insert :: Key -> Value -> TraceState -> TraceState

Add a key-value pair to a TraceState

O(n)

update :: Key -> (Value -> Value) -> TraceState -> TraceState

Update a value in the TraceState. Does nothing if the value associated with the given key doesn't exist.

O(n)

delete :: Key -> TraceState -> TraceState

Remove a key-value pair for the given key.

O(n)

toList :: TraceState -> [(Key, Value)]

Convert the TraceState to a list.

O(1)