Package com.ants.platform.otel

Class AntsPlatformOtel

java.lang.Object

com.ants.platform.otel.AntsPlatformOtel

public final class AntsPlatformOtel
extends Object

Entry point for configuring Agentic Ants OpenTelemetry tracing.

Wires an AntsPlatformSpanProcessor into an SdkTracerProvider and registers it as the global OpenTelemetry instance, so the high-level com.ants.platform.tracing.Ants API and any other OTel instrumentation in the process export to the platform.

 AntsPlatformOtel.configure(AntsPlatformOtel.options()
     .publicKey("pk-ap-...")
     .secretKey("sk-ap-..."));   // baseUrl defaults to https://api.agenticants.ai

 // ... instrument with Ants.startObservation(...) / startActiveObservation(...) ...

 AntsPlatformOtel.shutdown();    // flush before the process exits
 

Field Summary

Fields

Modifier and Type	Field	Description
static final String	SDK_VERSION	SDK version reported on the x_antsPlatform_sdk_version header.

Method Summary

Modifier and Type	Method	Description
static io.opentelemetry.api.OpenTelemetry	configure(AntsPlatformSpanProcessor proc)	Registers a pre-built processor as the global tracer provider.
static io.opentelemetry.api.OpenTelemetry	configure(AntsPlatformSpanProcessor.Builder options)	Builds the span processor from options, registers a global OpenTelemetry, and returns it.
static void	flush()	Flushes any buffered spans without tearing down the provider.
static AntsPlatformSpanProcessor	getProcessor()	The active processor, or null if configure(com.ants.platform.otel.AntsPlatformSpanProcessor.Builder) has not run.
static String	getProjectId()	The resolved project id (for agent_id derivation), or null if unavailable.
static AntsPlatformSpanProcessor.Builder	options()	Mutable options for configure(com.ants.platform.otel.AntsPlatformSpanProcessor.Builder).
static void	shutdown()	Flushes and shuts down the tracer provider.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

SDK_VERSION

public static final String SDK_VERSION

SDK version reported on the x_antsPlatform_sdk_version header.

See Also:

• Constant Field Values

Method Details

options

public static AntsPlatformSpanProcessor.Builder options()

Mutable options for configure(com.ants.platform.otel.AntsPlatformSpanProcessor.Builder). Delegates to the processor builder.

configure

public static io.opentelemetry.api.OpenTelemetry configure(AntsPlatformSpanProcessor.Builder options)

Builds the span processor from options, registers a global OpenTelemetry, and returns it.

Parameters:

options - processor options (see options())

Returns:

the registered OpenTelemetry instance

configure

public static io.opentelemetry.api.OpenTelemetry configure(AntsPlatformSpanProcessor proc)

Registers a pre-built processor as the global tracer provider.

getProcessor

public static AntsPlatformSpanProcessor getProcessor()

The active processor, or null if configure(com.ants.platform.otel.AntsPlatformSpanProcessor.Builder) has not run.

getProjectId

public static String getProjectId()

The resolved project id (for agent_id derivation), or null if unavailable.

flush

public static void flush()

Flushes any buffered spans without tearing down the provider.

shutdown

public static void shutdown()

Flushes and shuts down the tracer provider. Call before process exit.