Package ai.acolite.agentsdk.core.tracing

Class ConsoleTraceProcessor

java.lang.Object

ai.acolite.agentsdk.core.tracing.ConsoleTraceProcessor

All Implemented Interfaces:

TraceProcessor, AutoCloseable

public class ConsoleTraceProcessor
extends Object
implements TraceProcessor

Simple trace processor that prints to console.

Useful for: - Development and debugging - Examples and demos - Testing without OpenAI API

Output format: Pretty-printed JSON

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

Constructor Summary

Constructors

Constructor	Description
ConsoleTraceProcessor()	Create console processor with pretty printing enabled
ConsoleTraceProcessor(boolean prettyPrint)	Create console processor

Method Summary

Modifier and Type	Method	Description
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

close, shutdown

Constructor Details

ConsoleTraceProcessor

public ConsoleTraceProcessor()

Create console processor with pretty printing enabled

ConsoleTraceProcessor

public ConsoleTraceProcessor(boolean prettyPrint)

Create console processor

Parameters:

prettyPrint - Whether to pretty-print JSON output

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)