---
title: "Get Observability Logs Histogram"
method: GET
path: "/agentic/observability/logs/histogram"
tags: ["Agents Observability"]
---

# Get Observability Logs Histogram

`GET /agentic/observability/logs/histogram`

Level-stacked log histogram for one agent or KB.

Same scope rules as :func:`get_observability_logs` (404 on
cross-scope id, 503 when the table isn't deployed). The histogram
surfaces all four levels regardless of the line viewer's current
level filter — the user is meant to see the full level distribution
so they can pick a filter floor.

## Query parameters

- `agent_id` string, required — Agent or knowledge base id
- `from` string, nullable — Time range start (ISO 8601)
- `to` string, nullable — Time range end (ISO 8601)
- `buckets` integer

## Response `200`

Successful Response

- ObservabilityLogHistogramResponse — `/agentic/observability/logs/histogram` response envelope.
  - `buckets` ObservabilityLogHistogramBucket[], required
    - `bucket_start` string, date-time, required
    - `error` integer
    - `warn` integer
    - `info` integer
    - `debug` integer
    - `total` integer, required
  - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/versions/8aea6143d003/schema)