Install Now
mfscli - CGI in TXT mode
Contents
Chunkserver Chart Data Columns
ucpu User cpu usage
scpu System cpu usage
masterin Data received from master
masterout Data sent to master
csrepin Data received by replicator
csrepout Data sent by replicator
csservin Data received by csserv
csservout Data sent by csserv
hdrbytesr Bytes read (headers)
hdrbytesw Bytes written (headers)
hdrllopr Low level reads (headers)
hdrllopw Low level writes (headers)
databytesr Bytes read (data)
databytesw Bytes written (data)
datallopr Low level reads (data)
datallopw Low level writes (data)
hlopr High level reads
hlopw High level writes
rtime Read time
wtime Write time
repl Replicate chunk ops
create Create chunk ops
delete Delete chunk ops
version Set version ops
duplicate Duplicate ops
truncate Truncate ops
duptrunc Duplicate+truncate ops
test Test chunk ops
load Server load
memoryrss Resident memory usage
memoryvirt Virtual memory usage
cpu Total cpu usage (scpu + ucpu)
Commands
-CRC/ip/port
remove selected chunkserver from list of active chunkservers
-CBW/ip/port
send selected chunkserver back to work state (from grace state)
-CM1/ip/port
switch selected chunkserver to maintenance mode
-CM0/ip/port
switch selected chunkserver to standard mode (from maintenance mode)
-CRS/sessionid
remove selected session
Copyright
Copyright (C) 2023 Jakub Kruszona-Zawadzki, Saglabs SA
This file is part of MooseFS.
MooseFS is free software; you can redistribute it and/or modify it under the terms of the GNU General
Public License as published by the Free Software Foundation, version 2 (only).
MooseFS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
License for more details.
You should have received a copy of the GNU General Public License along with MooseFS; if not, write to
the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA or visit
http://www.gnu.org/licenses/gpl-2.0.htmlDescription
mfscli is a commandline counterpart to MooseFS's CGI interface. All the information available in CGI
(except for graphs) can be obtained via CLI using different "monitoring options"
Examples
mfscli-SIC-2
shows table with chunk state matrix (number of chunks for each combination of valid copies and
goal set by user) using extended terminal colors (256-colors)
mfscli-SCS-f1
shows table with all chunkservers using unicode thick frames
mfscli-SMS-p-s','
shows current sessions (mounts) using plain text format and coma as a separator
mfscli-SOF-i123
shows files open by processes using session (mount) with id 123
mfscli-SMC-a10-bcpu,memoryrss,delete,replicate
shows master cpu usage, amount of resident memory used by master, number of chunk deletions and
number of chunk replications during last ten minutes
mfscli-SCC-c15-d192.168.1.10:9422:cpu,192.168.1.11:9422:cpu
shows cpu usage of chunkservers located on machines with IP 192.168.1.10 and 192.168.1.11 during
last fifteen minutes
mfscli-SCC-d$(mfscli-SCS-p-s','|grep'^chunk'|awk-F',''BEGIN{s=""}{printf"%s%s:%s:mem",s,$2,$3;s=","}')
shows resident memory usage of all connected chunkservers
Master Chart Data Columns
ucpu User cpu usage
scpu System cpu usage
delete Number of chunk deletions
replicate Number of chunk replications
statfs Number of statfs operations
getattr Number of getattr operations
setattr Number of setattr operations
lookup Number of lookup operations
mkdir Number of mkdir operations
rmdir Number of rmdir operations
symlink Number of symlink operations
readlink Number of readlink operations
mknod Number of mknod operations
unlink Number of unlink operations
rename Number of rename operations
link Number of link operations
readdir Number of readdir operations
open Number of open operations
read Number of read operations
write Number of write operations
memoryrss Resident memory usage
prcvd Received packets
psent Sent packets
brcvd Received bytes
bsent Sent bytes
memoryvirt Virtual memory usage
cpu Total cpu usage (scpu + ucpu)
Monitoring Options
-SIN show full master info
-SIM show only masters states
-SLI show only licence info
-SIG show only general master (leader) info
-SMU show only master memory usage
-SIC show only chunks info (goal/copies matrices)
-SIL show only loop info (with messages)
-SMF show only missing chunks/files (report from last full chunk loop)
-SCS show connected chunk servers
-SMB show connected metadata backup servers
-SHD show hdd data
-SEX show exports
-SMS show active mounts
-SRS show resources (storage classes,open files,acquired locks)
-SSC show storage classes info
-SOF show only open files
-SAL show only acquired locks
-SMO show operation counters
-SQU show quota info
-SMC show master charts data
-SCC show chunkserver charts data
Name
mfscli - CGI in TXT mode
Options
-h print help message
-p force plain text format on tty devices
-n do not resolve ip addresses (default when output device is not tty)
-sseparator
field separator to use in plain text format on tty devices (forces -p)
-2 force 256-color terminal color codes
-8 force 8-color terminal color codes
-Hmaster_host
master address (default: mfsmaster)
-Pmaster_port
master client port (default: 9421)
-f0..3
set frame charset to be displayed as table frames in ttymode;
0 simple ascii frames '+','-','|' (default)
1 thick unicode frames
2 thin unicode frames
3 double unicode frames (dos style)
-oorder_id
sort data by column specified by 'order id' (depends on data set)
-r reverse sort order
-mmode_id
show data specified by 'mode id' (depends on data set)
-iid sessionid for -SOF or inode for -SAL-acount
how many chart entries should be shown for master
-bchart_data_columns
define chart columns for master; prefix with '+' for raw data, prefix with 'ip:[port:]' for server
choice
-ccount
how many chart entries should be shown for chunkserver
-dchart_data_columns
define chart columns for chunkserver; prefix with '+' for raw data, prefix with 'ip:[port:]' for
server choice
Reporting Bugs
Report bugs to <bugs@moosefs.com>.
See Also
mfsmaster(8) MooseFS 3.0.117-1 February 2023 mfscli(1)
Synopsis
mfscli [-pn28] [-Hmaster_host] [-Pmaster_port] [-f0..3]
-S(IN|IM|LI|IG|MU|IC|IL|MF|CS|MB|HD|EX|MS|RS|SC|OF|AL|MO|QU|MC|CC) [-sseparator] [-oorder_id [-r]] [-mmode_id] [-iid] [-acount] [-bchart_data_columns] [-ccount] [-dchart_data_columns]
mfscli [-pn28] [-Hmaster_host] [-Pmaster_port] [-f0..3]
-C(RC/ip/port|BW/ip/port|M[01]/ip/port|RS/sessionid)
mfscli-h
PNG Icons
