Package com.ants.platform.guardrails

Class AntsTracer

java.lang.Object

com.ants.platform.guardrails.AntsTracer

public class AntsTracer
extends Object

Fire-and-forget tracer that sends trace and generation events to the ANTS ingestion API (POST /api/public/ingestion).

All logging is asynchronous -- callers are never blocked.

 AntsTracer tracer = new AntsTracer("pk:sk", "http://localhost:3000");
 tracer.log(TracePayload.builder()
     .model("gpt-4o-mini")
     .provider("openai")
     .inputMessages(messages)
     .outputText(output)
     .build());
 

Constructor Summary

Constructors

Constructor	Description
AntsTracer(String antsApiKey)
AntsTracer(String antsApiKey, String baseUrl)

Method Summary

Modifier and Type	Method	Description
void	log(TracePayload payload)	Log a trace + generation event asynchronously (fire-and-forget).
void	shutdown()	Shut down the background executor.

Methods inherited from class java.lang.Object

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

Constructor Details

AntsTracer

public AntsTracer(String antsApiKey)

AntsTracer

public AntsTracer(String antsApiKey,
 String baseUrl)

Method Details

log

public void log(TracePayload payload)

Log a trace + generation event asynchronously (fire-and-forget). Errors are printed to stderr but never propagated to the caller.

shutdown

public void shutdown()

Shut down the background executor. Pending traces may be lost.