---
title: "Read app metrics"
method: GET
path: "/platform/deployments/custom/{deployment_id}/metrics"
---

# Read app metrics

`GET /platform/deployments/custom/{deployment_id}/metrics`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/deployments/custom/{deployment_id}/metrics`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Recent per-app metrics from its server: container state (running/restarting/exited), restart count, CPU percent, memory bytes against its limit, and volume bytes — minute-bucketed over the last 24 hours. The state "unknown" means the agent has not reported recently; unknown is never "healthy". Numbers only — the report the agent sends cannot carry configuration or secrets. Since 25 September 2026, minute points live 48 hours, a daily rollup consolidates closed hours (>24h) into an hourly table kept 90 days, reads past 24 hours merge hourly and minute rows with every point marking its resolution, the minutes range grows to 129600, and CPU becomes the sample-weighted bucket average when the agent reports cpu_avg_pct/cpu_samples (no agent release sends them yet, so current agents keep one instant sample per minute, samples=1).

## Path parameters

- `deployment_id` string, required: The application (dpl_...).

## Query parameters

- `minutes` number: How far back the series goes (5-1440, default 120; up to 129600 once the retention increment ships).

## Response `200`

API response envelope. For apply operations acceptance is queued, not verified completion.

## Other responses

- `400`: Invalid input or confirmation
- `403`: Missing permission or unsupported capability
- `404`: Owned resource not found
- `409`: Review expired, conflict or unavailable operation

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)