Tracing

Adds an event to the current span.

Attributes

Adds an event with attributes to the current span.

Attributes

attributes: event attributes

Extracts the span from carrier C and set its child span with name 'spanName' as the current span.

Ends the span when the effect finishes.

Attributes

C: carrier
carrier: mutable data from which the parent span is extracted
errorMapper: error mapper
links: spanContexts of the linked Spans.
propagator: implementation of zio.telemetry.opentelemetry.tracing.propagation.TraceContextPropagator
spanKind: kind of the child span
spanName: name of the child span
zio: body of the child span

Extracts the span from carrier C and unsafely set its child span with name 'spanName' as the current span.

You need to make sure to call the finalize effect to end the span.

Primarily useful for interop.

Attributes

C: carrier
carrier: mutable data from which the parent span is extracted
propagator: implementation of zio.telemetry.opentelemetry.tracing.propagation.TraceContextPropagator
spanKind: kind of the child span
spanName: name of the child span

Gets the current Context

Attributes

Gets the current Span.

Attributes

Gets the current SpanContext.

Attributes

Mark this effect as the child of an externally provided span. Ends the span when the effect finishes. zio-opentelemetry will mark the span as being the child of the external one.

This is designed for use-cases where you are incrementally introducing zio & zio-telemetry in a project that already makes use of instrumentation, and you need to interoperate with futures-based code.

The caller is solely responsible for managing the external span, including calling Span.end

It also could be useful in combination with extractSpanUnsafe or spanUnsafe:

 for {
   (span, finalize) <- tracing.spanUnsafe("unsafe-span")
   // run some logic that would be wrapped in the span
   // modify the span
   _                <- zio @@ tracing.inSpan(span, "child-of-unsafe-span")
 } yield ()

Attributes

errorMapper: error mapper
links: spanContexts of the linked Spans.
span: externally provided span
spanKind: kind of the child span
spanName: name of the child span
zio: body of the child span

Injects the current span into carrier C.

Attributes

C: carrier
carrier: mutable data from which the parent span is extracted
propagator: implementation of zio.telemetry.opentelemetry.tracing.propagation.TraceContextPropagator

Sets the current span to be the new root span with name 'spanName'.

Ends the span when the effect finishes.

Attributes

errorMapper: error mapper
links: spanContexts of the linked Spans.
spanKind: name of the new root span
spanName: name of the new root span
zio: body of the new root span

Introduces a thread-local scope during the execution allowing for non-zio context propagation.

Closes the scope when the effect finishes.

Attributes

effect: piece of code to execute in the current context

Introduces a thread-local scope from the currently active zio span allowing for non-zio context propagation. This scope will only be active during Future creation, so another mechanism must be used to ensure that the scope is passed into the Future callbacks.

The java auto instrumentation package provides such a mechanism out of the box, so one is not provided as a part of this method.

CLoses the scope when the effect finishes.

Attributes

make: function for providing a scala.concurrent.Future by a given scala.concurrent.ExecutionContext to execute in the current context

Introduces a thread-local scope during the execution allowing for non-zio context propagation.

Closes the scope when the effect finishes.