---
title: "Get latest raw metrics for a topic"
method: GET
path: "/topics/{topic_id}/raw-metrics"
tags: ["Topics"]
---

# Get latest raw metrics for a topic

`GET /topics/{topic_id}/raw-metrics`

Returns the latest raw metric values (per partition / task / context) from the ClickHouse `metrics` and `metrics_qa` tables for a single topic — bypassing the materialized-view aggregation that powers the lineage / observability surfaces.

Intended for debugging discrepancies between what raw CH holds and what the UI renders. Returns one row per (metric_name, partition, task, context); the caller is responsible for aggregating across partitions if needed (sum for lag, max for latency, etc.).

## Path parameters

- `topic_id` string, required

## Query parameters

- `since` string — Lookback window. Accepts '<int><unit>' where unit ∈ {s,m,h,d}. Defaults to 15m, capped at 3d (raw-table TTL).
- `metric_names` string, nullable — Comma-separated metric_name filter. Omit to return every metric_name seen in the window.
- `include_destinations` boolean
- `include_qa` boolean

## Response `200`

Successful Response

- TopicRawMetricsRes
  - `topic_id` string, required
  - `since` string, date-time, required
  - `source` TopicRawConnectorMetrics, required
    - `connector` string, required
    - `ch_topic` string, required
    - `metrics` TopicRawMetricRow[], required
      - `metric_name` string, required
      - `partition` string, required
      - `task` string, required
      - `context` string, required
      - `value` number, required
      - `updated_at` string, date-time, required
  - `destinations` TopicRawDestinationMetrics[]
    - `destination_id` string, required
    - `connector` string, required
    - `ch_topic` string, required
    - `pipeline_id` string, nullable
    - `transform_id` string, nullable
    - `metrics` TopicRawMetricRow[], required
      - `metric_name` string, required
      - `partition` string, required
      - `task` string, required
      - `context` string, required
      - `value` number, required
      - `updated_at` string, date-time, required
  - `qa` TopicRawQaRow[]
    - `metric_name` string, required
    - `connector_ctx` string, required
    - `connector_id` string, required
    - `value` number, required
    - `updated_at` string, date-time, 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)