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.

GET/agentic/observability/logs

Authorization

AuthorizationBearer token · headerrequired

Query parameters

agent_idstringrequired

Agent or knowledge base id (Mongo ObjectId)

fromstring | any

Time range start (ISO 8601)

tostring | any

Time range end (ISO 8601)

levelstring

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

default: "INFO"

levelsstring | any

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

searchstring | any

Substring filter on the log column

limitinteger

Max lines per call

min 1 · max 2000 · default: 200

sincestring | any

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

Responses

200

Successful Response

linesObservabilityLogLine[]required

Show properties

Array of ObservabilityLogLine

timestampstringrequired

levelstringrequired

messagestringrequired

scopestring

default: "agent"

job_id_prefixstringrequired

422

Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X GET "https://api.streamkap.com/agentic/observability/logs?agent_id=string" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.streamkap.com/agentic/observability/logs?agent_id=string", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.streamkap.com/agentic/observability/logs?agent_id=string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "lines": [
    {
      "timestamp": "string",
      "level": "string",
      "message": "string"
    }
  ],
  "scope": "agent",
  "job_id_prefix": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}