nl.jomco.ring-trace-context — nl.jomco/ring-trace-context 0.0.5

*trace-context* clj

The trace-context in the current scope.

This will be set by wrap-trace-context automatically. Use with-context otherwise.

generate-traceparent clj

(generate-traceparent trace-context)

Returns a traceparent header value from the given trace-context.

get-context clj

(get-context request-or-response)

Get the trace-context from the given ring request-or-response.

Will return nil if no traceparent header is present.

new-context clj

(new-context)

(new-context base-trace-context)

Returns a new context off the given base-trace-context.

The returned trace-context has the same properties as the given base-trace-context but with a random :parent-id.

If base-trace-context is nil, returns a random context.

If no argument is passed, uses *trace-context* as the base.

new-span clj

(new-span)

(new-span trace-context)

Same as new-context.

parse-traceparent clj

(parse-traceparent traceparent)

Parse traceparent string and return a trace-context map.

This will fully parse version "00" traceparent values.

trace-context map contains :version, :trace-id, :parent-id and :trace-flags (a set of keywords).

The only currently supported trace-flag is :sampled.

Returns nil if traceparent is not a valid traceparent value.

See also https://www.w3.org/TR/trace-context

parse-tracestate clj

(parse-tracestate s)

random-context clj

(random-context)

Create new random trace-context.

:trace-id and :parent-id are random. :version is always 00 and :trace-flags are empty.

set-context clj

(set-context request-or-response trace-context)

Set the traceparent header for trace-context on request-or-response.

with-context clj macro

(with-context trace-context & body)

Bind trace-context to trace-context and evaluate body.

wrap-trace-context clj

(wrap-trace-context handler)

Ring middleware for Trace Context.

Implements the W3C Trace Context protocol. When a request has a traceparent header, this gets parsed into a trace-context which is set on the request, before passing it to handler.

The parsed trace-context is set on the request and response as the :trace-context key.

If no traceparent is set, or traceparent is not valid, a new random trace-context is created.

Sets the response traceparent header to the trace-context used.

During call to handler, *trace-context* is also bound to trace-context.

See https://www.w3.org/TR/trace-context/