Tracing

Adds an event to the current span.

Attributes

Adds an event with attributes to the current span.

Value parameters

attributes: event attributes

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.

Type parameters

C: carrier

Value parameters

carrier: mutable data from which the parent span is extracted
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
statusMapper: status mapper
zio: body of the child span

Attributes

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.

Type parameters

C: carrier

Value parameters

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

Attributes

Gets the current Context

Attributes

Gets the current SpanContext.

Attributes

Gets the current Span.

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 ()

Value parameters

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

Attributes

Injects the current span into carrier C.

Type parameters

C: carrier

Value parameters

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

Attributes

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

Ends the span when the effect finishes.

Value parameters

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

Attributes

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

Closes the scope when the effect finishes.

Value parameters

effect: piece of code to execute in the current context

Attributes

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.

Value parameters

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

Attributes

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

Closes the scope when the effect finishes.