Guardrails & Violations
Guardrail Invocations
Recent guardrail evaluation spans
GET
Guardrail Invocations
Recent
Returns
tracectrl.guardrail.evaluation spans for a specific (agent_id, guardrail_name) pair, ordered newest first. Reads directly from otel_traces and does not depend on the analytics pipeline tick.
Query Parameters
string
required
The agent that owns the guardrail.
string
required
The guardrail to query.
integer
default:"50"
Maximum rows to return.
400 if agent_id or guardrail_name is missing.
Response
Array ofGuardrailInvocation objects:
string
Trace ID of the evaluation span
string
Span ID of the evaluation span
string
ISO-8601 timestamp
string
pass, fail, or errorstring
pre_input or post_outputstring
Judge’s reasoning
string
Evidence captured at evaluation time
string
Severity level
string
judge_llm or protector_plusstring
Model used for the decision
string
Structured response payload (Protector Plus only; empty for legacy judge_llm spans)

