Package com.ants.platform.tracing

Class AntsGeneration

java.lang.Object

com.ants.platform.tracing.AntsObservation

com.ants.platform.tracing.AntsGeneration

public class AntsGeneration
extends AntsObservation

Specialized AntsObservation for LLM generations. Adds model, model parameters, token usage, cost, and prompt attributes.

Report usage(java.util.Map<java.lang.String, ? extends java.lang.Number>) together with model(java.lang.String); the backend computes cost server-side from the model's price book, so cost(java.util.Map<java.lang.String, ? extends java.lang.Number>) is optional.

Field Summary

Fields inherited from class com.ants.platform.tracing.AntsObservation

otelSpan

Method Summary

Modifier and Type	Method	Description
AntsGeneration	completionStartTime(Instant completionStartTime)	Timestamp when the model began streaming the completion.
AntsGeneration	cost(Map<String,? extends Number> cost)	Cost breakdown (optional; the backend computes cost from model + usage).
AntsGeneration	input(Object input)	Sets the observation input (serialized to JSON).
AntsGeneration	level(String level)	Sets the observation level (e.g.
AntsGeneration	metadata(Object metadata)	Sets observation metadata.
AntsGeneration	model(String model)	Name of the model used (e.g.
AntsGeneration	modelParameters(Map<String,?> params)	Model invocation parameters (temperature, max_tokens, ...), serialized to JSON.
AntsGeneration	output(Object output)	Sets the observation output (serialized to JSON).
AntsGeneration	prompt(String name, int version)	Links this generation to a managed prompt by name + version.
AntsGeneration	recordError(Throwable error)	Records an error on this observation: sets the OTel status to ERROR, level=ERROR and a status message, and records the exception.
AntsGeneration	statusMessage(String statusMessage)	Sets a human-readable status message (typically with level("ERROR")).
AntsGeneration	updateTrace(TraceAttributes attrs)	Updates trace-level attributes on this observation's span.
AntsGeneration	usage(long inputTokens, long outputTokens)	Convenience: report input/output token counts; total is their sum.
AntsGeneration	usage(long inputTokens, long outputTokens, long totalTokens)	Convenience: report input/output/total token counts.
AntsGeneration	usage(Map<String,? extends Number> usage)	Token usage as an arbitrary map (e.g.
AntsGeneration	version(String version)	Sets a version identifier for the code/model being traced.

Methods inherited from class com.ants.platform.tracing.AntsObservation

end, end, id, otelSpan, startChild, startChildGeneration, traceId, type

Methods inherited from class java.lang.Object

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

Method Details

model

public AntsGeneration model(String model)

Name of the model used (e.g. gpt-4o-mini); drives server-side cost.

modelParameters

public AntsGeneration modelParameters(Map<String,?> params)

Model invocation parameters (temperature, max_tokens, ...), serialized to JSON.

usage

public AntsGeneration usage(Map<String,? extends Number> usage)

Token usage as an arbitrary map (e.g. {input, output, total}).

usage

public AntsGeneration usage(long inputTokens,
 long outputTokens)

Convenience: report input/output token counts; total is their sum.

usage

public AntsGeneration usage(long inputTokens,
 long outputTokens,
 long totalTokens)

Convenience: report input/output/total token counts.

cost

public AntsGeneration cost(Map<String,? extends Number> cost)

Cost breakdown (optional; the backend computes cost from model + usage).

completionStartTime

public AntsGeneration completionStartTime(Instant completionStartTime)

Timestamp when the model began streaming the completion.

prompt

public AntsGeneration prompt(String name,
 int version)

Links this generation to a managed prompt by name + version.

input

public AntsGeneration input(Object input)

Description copied from class: AntsObservation

Sets the observation input (serialized to JSON).

Overrides:

input in class AntsObservation

output

public AntsGeneration output(Object output)

Description copied from class: AntsObservation

Sets the observation output (serialized to JSON).

Overrides:

output in class AntsObservation

metadata

public AntsGeneration metadata(Object metadata)

Description copied from class: AntsObservation

Sets observation metadata. A map is flattened to one attribute per top-level key (ants-platform.observation.metadata.<key>), matching the other SDKs; anything else is serialized whole.

Overrides:

metadata in class AntsObservation

level

public AntsGeneration level(String level)

Description copied from class: AntsObservation

Sets the observation level (e.g. DEBUG, DEFAULT, WARNING, ERROR).

Overrides:

level in class AntsObservation

statusMessage

public AntsGeneration statusMessage(String statusMessage)

Description copied from class: AntsObservation

Sets a human-readable status message (typically with level("ERROR")).

Overrides:

statusMessage in class AntsObservation

version

public AntsGeneration version(String version)

Description copied from class: AntsObservation

Sets a version identifier for the code/model being traced.

Overrides:

version in class AntsObservation

recordError

public AntsGeneration recordError(Throwable error)

Description copied from class: AntsObservation

Records an error on this observation: sets the OTel status to ERROR, level=ERROR and a status message, and records the exception.

Overrides:

recordError in class AntsObservation

updateTrace

public AntsGeneration updateTrace(TraceAttributes attrs)

Description copied from class: AntsObservation

Updates trace-level attributes on this observation's span.

Overrides:

updateTrace in class AntsObservation