STstreamkap
Agents

Get Agent Logs

Changed on

Recent agent log lines from the Flink task managers, plus recent job exceptions.

Requires write:agents because agent log lines may contain customer payloads that flowed through prompts and tool arguments.

Lines are scoped to the agent's namespace: when several agents share a task manager, lines from other agents may appear.

tail (1-500, default 100) caps the number of lines; level filters by log level. 400 for an out-of-range tail or an unknown level. since is an optional ISO 8601 cutoff for incremental polling. The response is always bounded by tail, so if since is far back, widen tail to reach it.

get/agents/{job_id}/logs

Request

Path parameters

job_idstring required

Query parameters

tailinteger
levelstring
searchstring nullable
sincestring nullable

Response

Successful Response

scope'namespace' | 'agent'

Per-line scoping of returned lines. namespace means lines may include [AGENT] entries from other agents sharing a TaskManager (current limitation). agent will be returned once the agent runtime emits per-line agent IDs.

Changes