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

ceph(8), ceph-mds(8)