1CEPHFS-TOP(8)                        Ceph                        CEPHFS-TOP(8)
2
3
4

NAME

6       cephfs-top - Ceph Filesystem Top Utility
7

SYNOPSIS

9       cephfs-top [flags]
10
11

DESCRIPTION

13       cephfs-top  provides  top(1)  like  functionality  for Ceph Filesystem.
14       Various client metrics are displayed and updated in realtime.
15
16       Ceph Metadata Servers periodically send client metrics to Ceph Manager.
17       Stats  plugin in Ceph Manager provides an interface to fetch these met‐
18       rics.
19

OPTIONS

21       --cluster
22              Cluster: Ceph cluster to connect. Defaults to ceph.
23
24       --id   Id: Client used to connect to Ceph cluster. Defaults to fstop.
25
26       --selftest
27              Perform a selftest. This mode performs a sanity check  of  stats
28              module.
29
30       --conffile [CONFFILE]
31              Path to cluster configuration file
32
33       -d [DELAY], --delay [DELAY]
34              Refresh interval in seconds (default: 1)
35
36       --dump Dump the metrics to stdout
37
38       --dumpfs <fs_name>
39              Dump the metrics of the given filesystem to stdout
40

DESCRIPTIONS OF FIELDS

42       chit   cap hit rate
43
44       dlease dentry lease rate
45
46       ofiles number of opened files
47
48       oicaps number of pinned caps
49
50       oinodes
51              number of opened inodes
52
53       rtio   total size of read IOs
54
55       wtio   total size of write IOs
56
57       raio   average size of read IOs
58
59       waio   average size of write IOs
60
61       rsp    speed of read IOs compared with the last refresh
62
63       wsp    speed of write IOs compared with the last refresh
64
65       rlatavg
66              average read latency
67
68       rlatsd standard deviation (variance) for read latency
69
70       wlatavg
71              average write latency
72
73       wlatsd standard deviation (variance) for write latency
74
75       mlatavg
76              average metadata latency
77
78       mlatsd standard deviation (variance) for metadata latency
79

AVAILABILITY

81       cephfs-top is part of Ceph, a massively scalable, open-source, distrib‐
82       uted  storage  system.  Please  refer  to  the  Ceph  documentation  at
83       http://ceph.com/ for more information.
84

SEE ALSO

86       ceph(8), ceph-mds(8)
87

89       2010-2023,  Inktank Storage, Inc. and contributors. Licensed under Cre‐
90       ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
91
92
93
94
95dev                              Nov 02, 2023                    CEPHFS-TOP(8)
Impressum