Package ai.acolite.agentsdk.core.tracing

Class NoopTraceProcessor

java.lang.Object

ai.acolite.agentsdk.core.tracing.NoopTraceProcessor

All Implemented Interfaces:

TraceProcessor, AutoCloseable

public class NoopTraceProcessor
extends Object
implements TraceProcessor

No-op trace processor that does nothing.

Used when tracing is disabled to avoid conditional checks throughout the codebase. All methods are no-ops.

Singleton pattern for efficiency.

Ported from TypeScript OpenAI Agents SDK Source: tracing/processor.ts

Field Summary

Fields

Modifier and Type	Field	Description
static final NoopTraceProcessor	INSTANCE	Singleton instance

Method Summary

Modifier and Type	Method	Description
void	close()	AutoCloseable implementation.
CompletableFuture<Void>	forceFlush()	Flush all pending traces/spans.
void	onSpanEnd(Span<?> span)	Called when a span ends.
void	onSpanStart(Span<?> span)	Called when a span starts.
void	onTraceEnd(Trace trace)	Called when a trace ends.
void	onTraceStart(Trace trace)	Called when a trace starts.
CompletableFuture<Void>	shutdown(long timeoutMs)	Shutdown the processor gracefully.

Methods inherited from class java.lang.Object

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

Methods inherited from interface ai.acolite.agentsdk.core.tracing.TraceProcessor

shutdown

Field Details

INSTANCE

public static final NoopTraceProcessor INSTANCE

Singleton instance

Method Details

onTraceStart

public void onTraceStart(Trace trace)

Description copied from interface: TraceProcessor

Called when a trace starts. Processors can export the trace immediately or buffer it.

Specified by:

onTraceStart in interface TraceProcessor

onTraceEnd

public void onTraceEnd(Trace trace)

Description copied from interface: TraceProcessor

Called when a trace ends.

Specified by:

onTraceEnd in interface TraceProcessor

onSpanStart

public void onSpanStart(Span<?> span)

Description copied from interface: TraceProcessor

Called when a span starts.

Specified by:

onSpanStart in interface TraceProcessor

onSpanEnd

public void onSpanEnd(Span<?> span)

Description copied from interface: TraceProcessor

Called when a span ends. Most processors export spans on end to capture complete data.

Specified by:

onSpanEnd in interface TraceProcessor

forceFlush

public CompletableFuture<Void> forceFlush()

Description copied from interface: TraceProcessor

Flush all pending traces/spans. Blocks until all data is exported.

Specified by:

forceFlush in interface TraceProcessor

shutdown

public CompletableFuture<Void> shutdown(long timeoutMs)

Description copied from interface: TraceProcessor

Shutdown the processor gracefully. Flushes pending data and releases resources.

Specified by:

shutdown in interface TraceProcessor

Parameters:

timeoutMs - Maximum time to wait for shutdown (milliseconds)

close

public void close()

Description copied from interface: TraceProcessor

AutoCloseable implementation. Calls shutdown() and blocks.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface TraceProcessor