GenAI Settings

AI data health checks

Counts LLM spans with no model price, no agent identity, zero duration, or no session id in a trace stream and window. Pass include_samples=true for sample trace ids per failing check. Results are cached for about a minute; pass refresh=true to recompute.

get/api/{org_id}/gen_ai/data_health

Request

Path parameters

org_idstring required

Organization ID

Query parameters

stream_namestring required

Trace stream to check.

start_timeinteger required

Window start, microseconds.

end_timeinteger required

Window end, microseconds.

agentstring

Only spans of this agent name (gen_ai_agent_name); ignored when agent_id is set.

agent_idstring

Only spans of this agent id (gen_ai_agent_id). Agents that emit only an id are listed with the id as their name, so the id is the filter that matches their spans.

envstring

Only spans of this environment (gen_ai_agent_env).

versionstring

Only spans of this agent version (gen_ai_agent_version).

refreshboolean

Skip the short server-side cache.

include_samplesboolean

Also return up to three recent trace ids per failing check; off by default, one query each.

Response

Data health checks

checked_atinteger required

When the checks ran, microseconds.

Changes

No recorded changes to this operation across all 1 revision of this API.