OpenTelemetry.Internal.Trace.Id

Documentation

newtype TraceId

A valid trace identifier is a 16-byte array with at least one non-zero byte.

Constructors

TraceId ShortByteString

Instances

IsString TraceId

Defined in OpenTelemetry.Internal.Trace.Id

Methods

fromString :: String -> TraceId

Generic TraceId

Defined in OpenTelemetry.Internal.Trace.Id

Associated Types

type Rep TraceId :: Type -> Type

Methods

from :: TraceId -> Rep TraceId x

to :: Rep TraceId x -> TraceId

Show TraceId

Defined in OpenTelemetry.Internal.Trace.Id

Methods

showsPrec :: Int -> TraceId -> ShowS

show :: TraceId -> String

showList :: [TraceId] -> ShowS

Eq TraceId

Defined in OpenTelemetry.Internal.Trace.Id

Methods

(==) :: TraceId -> TraceId -> Bool

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

Ord TraceId

Defined in OpenTelemetry.Internal.Trace.Id

Methods

compare :: TraceId -> TraceId -> Ordering

(<) :: TraceId -> TraceId -> Bool

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

(>) :: TraceId -> TraceId -> Bool

(>=) :: TraceId -> TraceId -> Bool

max :: TraceId -> TraceId -> TraceId

min :: TraceId -> TraceId -> TraceId

Hashable TraceId

Defined in OpenTelemetry.Internal.Trace.Id

Methods

hashWithSalt :: Int -> TraceId -> Int

hash :: TraceId -> Int

type Rep TraceId

Defined in OpenTelemetry.Internal.Trace.Id

type Rep TraceId = D1 ('MetaData "TraceId" "OpenTelemetry.Internal.Trace.Id" "hs-opentelemetry-api-0.2.0.0-2Szn2AZ2vnoHm5uYEjNBGv" 'True) (C1 ('MetaCons "TraceId" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 ShortByteString)))

newTraceId :: MonadIO m => IdGenerator -> m TraceId

Generate a TraceId using the provided IdGenerator

This function is generally called by the hs-opentelemetry-sdk, but may be useful in some testing situations.

Since: 0.1.0.0

isEmptyTraceId :: TraceId -> Bool

Check whether all bytes in the TraceId are zero.

Since: 0.1.0.0

traceIdBytes :: TraceId -> ByteString

Access the byte-level representation of the provided TraceId

Since: 0.1.0.0

bytesToTraceId :: ByteString -> Either String TraceId

Convert a ByteString to a TraceId. Will fail if the ByteString is not exactly 16 bytes long.

Since: 0.1.0.0

baseEncodedToTraceId :: Base -> ByteString -> Either String TraceId

Convert a ByteString of a specified base-encoding into a TraceId. Will fail if the decoded value is not exactly 16 bytes long.

Since: 0.1.0.0

traceIdBaseEncodedBuilder :: Base -> TraceId -> Builder

Output a TraceId into a base-encoded bytestring Builder.

Since: 0.1.0.0

traceIdBaseEncodedByteString :: Base -> TraceId -> ByteString

Output a TraceId into a base-encoded ByteString.

Since: 0.1.0.0

traceIdBaseEncodedText :: Base -> TraceId -> Text

Output a TraceId into a base-encoded Text.

Since: 0.1.0.0

newtype SpanId

A valid span identifier is an 8-byte array with at least one non-zero byte.

Constructors

SpanId ShortByteString

Instances

IsString SpanId

Defined in OpenTelemetry.Internal.Trace.Id

Methods

fromString :: String -> SpanId

Show SpanId

Defined in OpenTelemetry.Internal.Trace.Id

Methods

showsPrec :: Int -> SpanId -> ShowS

show :: SpanId -> String

showList :: [SpanId] -> ShowS

Eq SpanId

Defined in OpenTelemetry.Internal.Trace.Id

Methods

(==) :: SpanId -> SpanId -> Bool

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

Ord SpanId

Defined in OpenTelemetry.Internal.Trace.Id

Methods

compare :: SpanId -> SpanId -> Ordering

(<) :: SpanId -> SpanId -> Bool

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

(>) :: SpanId -> SpanId -> Bool

(>=) :: SpanId -> SpanId -> Bool

max :: SpanId -> SpanId -> SpanId

min :: SpanId -> SpanId -> SpanId

Hashable SpanId

Defined in OpenTelemetry.Internal.Trace.Id

Methods

hashWithSalt :: Int -> SpanId -> Int

hash :: SpanId -> Int

newSpanId :: MonadIO m => IdGenerator -> m SpanId

Generate a SpanId using the provided IdGenerator

This function is generally called by the hs-opentelemetry-sdk, but may be useful in some testing situations.

Since: 0.1.0.0

isEmptySpanId :: SpanId -> Bool

Check whether all bytes in the SpanId are zero.

Since: 0.1.0.0

spanIdBytes :: SpanId -> ByteString

Access the byte-level representation of the provided SpanId

Since: 0.1.0.0

bytesToSpanId :: ByteString -> Either String SpanId

Convert a ByteString of a specified base-encoding into a SpanId. Will fail if the decoded value is not exactly 8 bytes long.

Since: 0.1.0.0

data Base

The different bases that can be used.

See RFC4648 for details. In particular, Base64 can be standard or URL-safe. URL-safe encoding is often used in other specifications without padding characters.

RFC 2045 defines a separate Base64 encoding, which is not supported. This format requires a newline at least every 76 encoded characters, which works around limitations of older email programs that could not handle long lines. Be aware that other languages, such as Ruby, encode the RFC 2045 version by default. To decode their output, remove all newlines before decoding.

Examples

A quick example to show the differences:

>>> let input = "Is 3 > 2?" :: ByteString
>>> let convertedTo base = convertToBase base input :: ByteString
>>> convertedTo Base16
"49732033203e20323f"
>>> convertedTo Base32
"JFZSAMZAHYQDEPY="
>>> convertedTo Base64
"SXMgMyA+IDI/"
>>> convertedTo Base64URLUnpadded
"SXMgMyA-IDI_"
>>> convertedTo Base64OpenBSD
"QVKeKw.8GBG9"

Constructors

Base16

similar to hexadecimal

Instances

Show Base

Defined in Data.ByteArray.Encoding

Methods

showsPrec :: Int -> Base -> ShowS

show :: Base -> String

showList :: [Base] -> ShowS

Eq Base

Defined in Data.ByteArray.Encoding

Methods

(==) :: Base -> Base -> Bool

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

baseEncodedToSpanId :: Base -> ByteString -> Either String SpanId

Convert a ByteString of a specified base-encoding into a SpanId. Will fail if the decoded value is not exactly 8 bytes long.

Since: 0.1.0.0

spanIdBaseEncodedBuilder :: Base -> SpanId -> Builder

Output a SpanId into a base-encoded bytestring Builder.

Since: 0.1.0.0

spanIdBaseEncodedByteString :: Base -> SpanId -> ByteString

Output a SpanId into a base-encoded ByteString.

Since: 0.1.0.0

spanIdBaseEncodedText :: Base -> SpanId -> Text

Output a SpanId into a base-encoded Text.

Since: 0.1.0.0