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.