---
title: "Get snapshot mirror sync metrics"
method: GET
path: "/api/cephfs/mirror/{fs_name}/status"
tags: ["CephfsMirror"]
---

# Get snapshot mirror sync metrics

`GET /api/cephfs/mirror/{fs_name}/status`

## Path parameters

- `fs_name` string, required

## Query parameters

- `path` string
- `peer_id` string

## Response `200`

OK

- object
  - `metrics` object, required — Snapshot mirror sync metrics grouped by mirrored directory path
    - `/dir_path` object, required — Mirror directory metrics keyed by absolute path
      - `peer` object, required — Peer sync statistics for the mirrored directory
        - `peer_uuid` object, required — Sync statistics keyed by peer UUID
          - `current_syncing_snap` object, required — Snapshot currently being synchronized
            - `avg_read_throughput_bytes` string, required — Average read throughput
            - `avg_write_throughput_bytes` string, required — Average write throughput
            - `bytes` object, required — Byte sync progress
              - …
            - `crawl` object, required — Directory crawl progress
              - …
            - `datasync_queue_wait` object, required — Data sync queue wait progress
              - …
            - `eta` string, required — Estimated time remaining for the current sync
            - `files` object, required — File sync progress
              - …
            - `id` integer, required — Snapshot ID
            - `name` string, required — Snapshot name
            - `sync-mode` string, required — Snapshot sync mode: full or delta
          - `failure_reason` string, required — Last sync failure reason when state is failed
          - `last_synced_snap` object, required — Last successfully synchronized snapshot
            - `crawl_duration` string, required — Time taken to scan directory
            - `datasync_queue_wait_duration` string, required — Time in data sync queue
            - `id` integer, required — Snapshot ID
            - `name` string, required — Snapshot name
            - `sync_bytes` string, required — Bytes synced for the snapshot
            - `sync_duration` string, required — Snapshot sync duration
            - `sync_files` integer, required — Number of files synced for the snapshot
            - `sync_time_stamp` string, required — Wall-clock time when the snapshot sync finished
          - `metrics_updated_at` number, required — Wall-clock time when metrics were last updated
          - `snaps_deleted` integer, required — Total number of snapshots deleted on the peer
          - `snaps_renamed` integer, required — Total number of snapshots renamed on the peer
          - `snaps_synced` integer, required — Total number of snapshots synchronized
          - `state` string, required — Mirror sync state: idle, syncing, stale, or failed

## Other responses

- `400` — Operation exception. Please check the response body for details.
- `401` — Unauthenticated access. Please login first.
- `403` — Unauthorized access. Please check your permissions.
- `500` — Unexpected error. Please check the response body for the stack trace.

## Changes

- **2026-08-24** `474e652a8dce` — 1 info
  - endpoint added
- **2026-08-18** `7a8c7ea97213` — 1 breaking
  - api path removed without deprecation
- **2026-08-11** `1a1fbc6e3786` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ceph/apis/ceph-rest-api/changes/api/cephfs/mirror/:fs_name/status/get.md)

---

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