Get Observability Logs

Per-job log lines for one agent or KB.

Replaces the namespace-scoped kubectl tail with a per-job_name ClickHouse query. agent_id resolves to the prefix agent_<id>_ or kb_<id>_ via the doc's job_type; the prefix LIKE catches every redeploy version of the entity so log history survives re-deploys.

Returns 404 when the id doesn't belong to this tenant + service (or the doc's job_type isn't agent / KB). Returns 503 with a structured kind when the flink_logs table is missing or a column has drifted.

agent_idstring required

Agent or knowledge base id (Mongo ObjectId)

fromstring nullable

Time range start (ISO 8601)

tostring nullable

Time range end (ISO 8601)

levelstring

Floor level — DEBUG | INFO | WARN | ERROR (used when levels is absent)

levelsstring nullable

Explicit comma-separated level set (e.g. 'WARN,ERROR'). Overrides the level floor when present.

searchstring nullable

Substring filter on the log column

limitinteger

Max lines per call

sincestring nullable

Live-tail cursor — only rows newer than this ISO 8601 ts

Response

Successful Response

scope'agent'

job_id_prefixstring required

v3

Get Observability Logs

Query parameters

Response