GenAI

Query GenAI trace summaries — traces containing spans with `gen_ai.*` attributes.

Changed on

duration_ms is the only field guaranteed to be milliseconds. gen_ai.* span attributes (e.g. time-to-first-token, token latency) often follow the OTel GenAI semantic conventions, which use seconds (a fractional double), not milliseconds — do not read them as ms without converting.

get/otel/genai/traces

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/otel/genai/traces
  • Auth: HTTP bearer

Query parameters

project_idinteger required

Project ID

service_namestring

Filter by service name

gen_ai_systemstring

Filter by AI system (openai, anthropic, etc.)

gen_ai_modelstring

Filter by model (gpt-4, claude-sonnet-4-20250514, etc.)

start_timestring

Start time (RFC 3339)

end_timestring

End time (RFC 3339)

limitinteger

Max traces to return (default: 50, max: 100)

offsetinteger

Offset for pagination

Response

GenAI trace summaries

totalinteger required

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status