List log entries

Returns log entries from the in-memory ring buffer and, when the page is short, the rotated JSONL log files on disk. Query filters apply to both sources; request payloads are scrubbed of secrets before persistence.

GET /logs

List log entries

cURL

curl --request GET \
  --url http://localhost:9371/logs

200

{
  "items": [
    {
      "timestamp": 123,
      "seq": 123,
      "level": "trace",
      "type": "app",
      "message": "<string>",
      "pid": 123,
      "event": "<string>",
      "requestId": "<string>",
      "processId": 123,
      "adapterId": "<string>",
      "serviceId": "<string>",
      "moduleId": "<string>",
      "moduleType": "adapter",
      "environmentId": "<string>",
      "executionId": 123,
      "dispatchId": "<string>",
      "toolId": "<string>",
      "phase": "<string>",
      "method": "<string>",
      "path": "<string>",
      "statusCode": 123,
      "durationMs": 123,
      "req": {},
      "res": {},
      "error": null,
      "suppressedCount": 123,
      "metadata": {}
    }
  ],
  "nextCursor": "<string>",
  "hasMore": true
}

Query Parameters

from · integer | null

Required range: x >= 0

to · integer | null

Required range: x >= 0

level · enum<string>

Available options: trace, debug, info, warn, error, fatal

levelMin · enum<string>

Available options: trace, debug, info, warn, error, fatal

type · enum<string>

Available options: app, request, module

moduleType · enum<string>

Available options: adapter, environment

query · string

Substring filter against the entry message.

Maximum string length: 500

event · string

Maximum string length: 200

requestId · string

Maximum string length: 200

processId · integer string

Required range: x > 0

adapterId · string

Maximum string length: 200

serviceId · string

Maximum string length: 200

moduleId · string

Maximum string length: 200

environmentId · string

Maximum string length: 200

executionId · integer

Required range: x > 0

dispatchId · string

Maximum string length: 200

toolId · string

Maximum string length: 200

phase · string

Maximum string length: 200

statusCode · integer

Required range: 0 < x <= 599

durationMin · integer | null

Required range: x >= 0

durationMax · integer | null

Required range: x >= 0

sort · enum<string>

Sort order; defaults to timestamp:desc.

Available options: timestamp:asc, timestamp:desc, duration:asc, duration:desc

cursor · string

Opaque pagination token returned as nextCursor by the previous response. Pass it back unchanged to fetch the next page; null/omitted fetches the first page. Cursors encode position, not filters, so change filters only between pages when starting over.

Maximum string length: 2048

limit · integer · default: 20

Maximum number of items per page. Clamped to a maximum of 100; defaults to 20.

Required range: 1 <= x <= 100

Response

200

application/json

Matching log entries.

Paginated collection envelope.

items · object[] · required

Log entries that match the supplied filters, ordered by the requested sort.

Show child attributes

nextCursor · string | null · required

Opaque cursor for the next page; null when there are no more items. Echo it back as the cursor query parameter to continue paginating.

hasMore · boolean · required

Whether additional pages exist. When true, nextCursor is a valid cursor; when false, pagination has reached the end.