---
title: "GET /v1/volumes/:id/metrics — per-volume JuiceFS performance (API key)."
method: GET
path: "/v1/volumes/{id}/metrics"
tags: ["volumes"]
---

# GET /v1/volumes/:id/metrics — per-volume JuiceFS performance (API key).

`GET /v1/volumes/{id}/metrics`

## Path parameters

- `id` string, uuid, required

## Query parameters

- `range_secs` integer, nullable
- `step_secs` integer, nullable

## Response `200`

Volume performance metrics

- VolumeMetricsResponse — Per-volume JuiceFS performance metrics over a time range.
  - `metrics` object, required — Metric key → aggregate series across every worker mounting the volume. An empty series means "no data in range".
  - `range` MetricsRange, required — The resolved time window a metrics response covers.
    - `end` integer, required — Window end, epoch milliseconds.
    - `start` integer, required — Window start, epoch milliseconds.
    - `step_secs` integer, required — Sample resolution in seconds.
  - `volume_id` string, uuid, required — The volume these metrics belong to.

## Other responses

- `400` — Invalid time range or resolution
- `401` — Unauthorized
- `404` — Volume not found
- `502` — Metrics backend unavailable

---

[API](https://skmtc.dev/microsandbox/apis/microsandbox-api.md) · [All operations](https://skmtc.dev/microsandbox/apis/microsandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microsandbox/microsandbox-api/revisions/23f2a45cb09b/schema)