v1

latestOpenAPI 3.1.02026-07-175793186.0 KB
sessions

Inspect session MLflow trace mapping

Resolve one MLflow trace for the session and classify each span against the workspace chat component model.

get/api/v1/sessions/{session_id}/trace-debug

Path parameters

session_idstring required

Identifier of the session whose trace to inspect.

Identifier of the session whose trace to inspect.

Query parameters

trace_idstring nullable

Optional explicit MLflow trace id to inspect.

Optional explicit MLflow trace id to inspect.

client_request_idstring nullable

Optional Fleet client request id used to resolve the trace.

Optional Fleet client request id used to resolve the trace.

Response

Successful Response

trace_idstring required

Resolved MLflow trace identifier.

client_request_idstring nullable

Resolved Fleet client request identifier when available.

statestring nullable

Top-level MLflow trace state.

request_previewstring nullable

Trace request preview.

response_previewstring nullable

Trace response preview.

resolved_from'trace_id' | 'client_request_id' | 'session_row' | 'runtime_session_id' required

How the trace was resolved for this session debug request.

runtime_session_idstring nullable

Authorized runtime session id used for fallback lookup when applicable.

span_countinteger required

Total spans in the resolved trace.

renderable_span_countinteger required

How many spans map to a renderable chat component.

non_rendered_span_countinteger required

How many spans are intentionally observability-only.