Package com.tnsai.quality.tracing

Class Observation

java.lang.Object

com.tnsai.quality.tracing.Observation

public final class Observation
extends Object

A single observation within a trace.

Observations form a tree: each observation may have a parent via parentId(). The root observation has a null parentId.

For ObservationType.GENERATION observations, use the builder's generation-specific methods (model, inputTokens, etc.).

Instances are immutable once built.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	Observation.Builder

Method Summary

Modifier and Type	Method	Description
static Observation.Builder	builder(String name, ObservationType type)
String	completion()
double	cost()
long	durationMs()	Returns the duration in milliseconds, or -1 if endTime is not set.
Instant	endTime()
boolean	equals(Object o)
static Observation.Builder	event(String name)
static Observation.Builder	generation(String name)
int	hashCode()
String	id()
String	input()
int	inputTokens()
Map<String,String>	metadata()
String	model()
String	name()
String	output()
int	outputTokens()
String	parentId()
String	prompt()
static Observation.Builder	span(String name)
Instant	startTime()
String	toString()
int	totalTokens()	Returns total tokens (input + output).
ObservationType	type()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Details

id

public String id()

name

public String name()

type

public ObservationType type()

startTime

public Instant startTime()

endTime

public Instant endTime()

parentId

public String parentId()

input

public String input()

output

public String output()

metadata

public Map<String,String> metadata()

model

public String model()

inputTokens

public int inputTokens()

outputTokens

public int outputTokens()

cost

public double cost()

prompt

public String prompt()

completion

public String completion()

totalTokens

public int totalTokens()

Returns total tokens (input + output). Convenience for generation observations.

durationMs

public long durationMs()

Returns the duration in milliseconds, or -1 if endTime is not set.

builder

public static Observation.Builder builder(String name,
 ObservationType type)

span

public static Observation.Builder span(String name)

generation

public static Observation.Builder generation(String name)

event

public static Observation.Builder event(String name)

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object