cephfs-top(8)
| CEPHFS-TOP(8) | Ceph | CEPHFS-TOP(8) |
NAME
cephfs-top - Ceph Filesystem Top Utility
SYNOPSIS
cephfs-top [flags]
DESCRIPTION
cephfs-top provides top(1) like functionality for Ceph Filesystem. Various client metrics are displayed and updated in realtime.
Ceph Metadata Servers periodically send client metrics to Ceph Manager. Stats plugin in Ceph Manager provides an interface to fetch these metrics.
OPTIONS
- --cluster
- Cluster: Ceph cluster to connect. Defaults to ceph.
- --id
- Id: Client used to connect to Ceph cluster. Defaults to fstop.
- --selftest
- Perform a selftest. This mode performs a sanity check of stats module.
- --conffile [CONFFILE]
- Path to cluster configuration file
- -d [DELAY], --delay [DELAY]
- Refresh interval in seconds (default: 1)
- --dump
- Dump the metrics to stdout
- --dumpfs <fs_name>
- Dump the metrics of the given filesystem to stdout
DESCRIPTIONS OF FIELDS
- chit
- cap hit rate
- dlease
- dentry lease rate
- ofiles
- number of opened files
- oicaps
- number of pinned caps
- oinodes
- number of opened inodes
- rtio
- total size of read IOs
- wtio
- total size of write IOs
- raio
- average size of read IOs
- waio
- average size of write IOs
- rsp
- speed of read IOs compared with the last refresh
- wsp
- speed of write IOs compared with the last refresh
- rlatavg
- average read latency
- rlatsd
- standard deviation (variance) for read latency
- wlatavg
- average write latency
- wlatsd
- standard deviation (variance) for write latency
- mlatavg
- average metadata latency
- mlatsd
- standard deviation (variance) for metadata latency
AVAILABILITY
cephfs-top is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at http://ceph.com/ for more information.
SEE ALSO
COPYRIGHT
2010-2025, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
| August 1, 2025 | dev |