Class DatadogTracingHandle

java.lang.Object
codes.grow.packages.datadogapm.DatadogTracingHandle
All Implemented Interfaces:
AutoCloseable

public final class DatadogTracingHandle extends Object implements AutoCloseable
A running Datadog tracing setup returned by DatadogTracing.initTracing(). It wraps the generic TracingHandle (handle()) and adds the resolved OTLP endpoint().
  • Method Details

    • handle

      public TracingHandle handle()
      The generic tracing handle (for example for the conformance TracingTarget).
      Returns:
      handle
    • endpoint

      public String endpoint()
      The OTLP traces URL spans are exported to.
      Returns:
      endpoint URL
    • openTelemetry

      public io.opentelemetry.sdk.OpenTelemetrySdk openTelemetry()
      The OpenTelemetry SDK instance.
      Returns:
      SDK
    • tracerProvider

      public io.opentelemetry.sdk.trace.SdkTracerProvider tracerProvider()
      The tracer provider.
      Returns:
      tracer provider
    • propagators

      public io.opentelemetry.context.propagation.ContextPropagators propagators()
      The configured propagators (tracecontext, datadog, baggage by default).
      Returns:
      propagators
    • config

      public TracingConfig config()
      The effective tracing config (endpoint, propagators and resource attributes resolved).
      Returns:
      config
    • tracer

      public io.opentelemetry.api.trace.Tracer tracer(String name)
      Returns a tracer.
      Parameters:
      name - instrumentation scope name
      Returns:
      tracer
    • tracer

      public io.opentelemetry.api.trace.Tracer tracer(String name, String version)
      Returns a tracer with a scope version.
      Parameters:
      name - instrumentation scope name
      version - instrumentation scope version
      Returns:
      tracer
    • forceFlush

      public void forceFlush()
      Exports all finished spans, waiting at most the export timeout.
    • forceFlush

      public void forceFlush(Duration timeout)
      Exports all finished spans.
      Parameters:
      timeout - maximum wait
    • forceFlushAsync

      public CompletableFuture<Void> forceFlushAsync(Duration timeout)
      Asynchronous forceFlush(Duration).
      Parameters:
      timeout - maximum wait
      Returns:
      completes when flushed
    • shutdown

      public void shutdown()
      Flushes and shuts the tracer provider down; idempotent.
    • shutdownAsync

      public CompletableFuture<Void> shutdownAsync()
      Asynchronous shutdown().
      Returns:
      completes when shut down
    • isShutdown

      public boolean isShutdown()
      Whether shutdown() was called.
      Returns:
      shutdown flag
    • close

      public void close()
      Same as shutdown().
      Specified by:
      close in interface AutoCloseable
    • toString

      public String toString()
      Overrides:
      toString in class Object