CEPHFS-TOP(8)

✨ CEPHFS-TOP(8) ✨

okay bestie, pull up a chair 🫶 this is the manual page for cephfs-top, living in the Ceph section of your manual. Buckle up, it's giving observability 💅

---

🌸 NAME 🌸

cephfs-top — the Ceph Filesystem Top Utility 👑

---

🎀 SYNOPSIS 🎀

cephfs-top [flags]

---

🦋 DESCRIPTION 🦋

So like, cephfs-top hands you top(1)-style functionality but for Ceph Filesystem, and honestly? iconic. Various client metrics get displayed and updated in realtime, so you can sit there and watch the numbers move like it's a livestream. 👀✨

Here's the lore: Ceph Metadata Servers periodically send client metrics over to the Ceph Manager. Then the stats plugin inside the Ceph Manager gives you an interface to fetch all of those metrics. That's the pipeline, no cap. 🌈

---

💖 OPTIONS 💖

• --cluster — Cluster: which Ceph cluster you're connecting to. Defaults to ceph. 🫶
• --id — Id: the client used to connect to the Ceph cluster. Defaults to fstop.
• --selftest — Perform a selftest. This mode runs a sanity check of the stats module. (vibe check, but for code ✨)
• --conffile [CONFFILE] — Path to the 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 🔥

okay so this is the part where you find out what all the little column names actually mean. no more squinting, bestie 😭

• 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. go read it, it's lowkey required reading 📚💜

---

👑 SEE ALSO 👑

• ceph <>(8)
• ceph-mds <>(8)

---

💜 Copyright 💜

2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)

---

and that's the whole page, bestie!! no skips, no skims, we ate that 🍓✨

signing off — this was dev, dated Aug 19, 2026, serving you CEPHFS-TOP(8) realness. mwah 💋💅