.\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "CEPHFS-TOP" "8" "Nov 03, 2026" "dev" "Ceph" .SH NAME cephfs-top \- Ceph Filesystem Top Utility .SH SYNOPSIS .nf \fBcephfs\-top\fP [flags] .fi .sp .SH DESCRIPTION .sp \fBcephfs\-top\fP provides top(1) like functionality for Ceph Filesystem. Various client metrics are displayed and updated in realtime. .sp Ceph Metadata Servers periodically send client metrics to Ceph Manager. \fBStats\fP plugin in Ceph Manager provides an interface to fetch these metrics. .SH OPTIONS .INDENT 0.0 .TP .B \-\-cluster Cluster: Ceph cluster to connect. Defaults to \fBceph\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-id Id: Client used to connect to Ceph cluster. Defaults to \fBfstop\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-selftest Perform a selftest. This mode performs a sanity check of \fBstats\fP module. .UNINDENT .INDENT 0.0 .TP .B \-\-conffile [CONFFILE] Path to cluster configuration file .UNINDENT .INDENT 0.0 .TP .B \-d [DELAY], \-\-delay [DELAY] Refresh interval in seconds (default: 1) .UNINDENT .INDENT 0.0 .TP .B \-\-dump Dump the metrics to stdout .UNINDENT .INDENT 0.0 .TP .B \-\-dumpfs Dump the metrics of the given filesystem to stdout .UNINDENT .SH DESCRIPTIONS OF FIELDS .INDENT 0.0 .TP .B chit cap hit rate .UNINDENT .INDENT 0.0 .TP .B dlease dentry lease rate .UNINDENT .INDENT 0.0 .TP .B ofiles number of opened files .UNINDENT .INDENT 0.0 .TP .B oicaps number of pinned caps .UNINDENT .INDENT 0.0 .TP .B oinodes number of opened inodes .UNINDENT .INDENT 0.0 .TP .B rtio total size of read IOs .UNINDENT .INDENT 0.0 .TP .B wtio total size of write IOs .UNINDENT .INDENT 0.0 .TP .B raio average size of read IOs .UNINDENT .INDENT 0.0 .TP .B waio average size of write IOs .UNINDENT .INDENT 0.0 .TP .B rsp speed of read IOs compared with the last refresh .UNINDENT .INDENT 0.0 .TP .B wsp speed of write IOs compared with the last refresh .UNINDENT .INDENT 0.0 .TP .B rlatavg average read latency .UNINDENT .INDENT 0.0 .TP .B rlatsd standard deviation (variance) for read latency .UNINDENT .INDENT 0.0 .TP .B wlatavg average write latency .UNINDENT .INDENT 0.0 .TP .B wlatsd standard deviation (variance) for write latency .UNINDENT .INDENT 0.0 .TP .B mlatavg average metadata latency .UNINDENT .INDENT 0.0 .TP .B mlatsd standard deviation (variance) for metadata latency .UNINDENT .SH AVAILABILITY .sp \fBcephfs\-top\fP is part of Ceph, a massively scalable, open\-source, distributed storage system. Please refer to the Ceph documentation at \% for more information. .SH SEE ALSO .sp ceph \%<>(8), ceph\-mds \%<>(8) .SH Copyright 2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0) .\" End of generated man page.