---
title: "Get metric statistics over time"
method: GET
path: "/monitoring/metrics/{metric}/stats"
tags: ["metrics"]
---

# Get metric statistics over time

`GET /monitoring/metrics/{metric}/stats`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/monitoring/metrics/{metric}/stats`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-7/docs/monitoring/metrics/:metric/stats/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves metric values over a specified time range with a given interval

## Path parameters

- `metric` 'connections' | 'totalConnections' | 'numberOfSubscriptions' | 'sentMessages' | 'sentBytes' | 'receivedMessages' | 'receivedBytes' | 'slowConsumers' | 'memory' | 'storage' | 'accounts' | 'haAssets' | 'apiTotal' | 'apiErrors' | 'apiInflight' | 'streams' | 'consumers' | 'totalMessages' | 'totalBytes' | 'numberOfSubjects' | 'numberOfDeleted' | 'lostMessages' | 'lostBytes' | 'numberOfAckPending' | 'numberOfRedelivered' | 'numberOfWaiting' | 'numberOfPending' | 'pushBound' | 'paused' | 'deliveredConsumerSequence' | 'deliveredStreamSequence' | 'deliveredLastActive' | 'ackFloorConsumerSequence' | 'ackFloorStreamSequence' | 'ackFloorLastActive' | 'ram' | 'cpu' | 'slowConsumersClients' | 'slowConsumersRoutes' | 'slowConsumersGateways' | 'slowConsumersMeshs' | 'sentMessagesRate' | 'sentBytesRate' | 'receivedMessagesRate' | 'receivedBytesRate', required

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `interval` integer
- `node` string
- `account` string
- `stream` string
- `consumer` string

## Response `200`

Successful operation

- MetricStatsResponse
  - `message` string: Response message
  - `data` MetricPoint[]: Array of metric data points
    - `ts` integer: Timestamp in milliseconds since epoch
    - `value` number, double: Metric value
  - `metadata` object: Optional metadata

## Other responses

- `400`: Bad request
- `404`: Not found
- `500`: Server error

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-7.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-7/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-7/revisions/e9272a5ed3e3?raw)