NAME¶

mfsstatsdump - dump usage data from master stats file in csv or png format

SYNOPSIS¶

mfsstatsdump -f fields [-i stats_file] [-r range] [-s separator] [-p png_filename [-x chart_width] [-y chart_height]] [-hHd]

DESCRIPTION¶

mfsstatsdump dumps usage data from master stats file. These are the same data sets that are used to make CGI charts. Output can be either in text format (csv) or in graphical format (png). That means -p, -x and -y options are mutually exclusive with -h, -H and -d options.

MooseFS master server saves the stats file in the DATA_PATH directory - see mfsmaster.cfg(5)

OPTIONS¶

-f

field names separated by ',' (see FIELDS section); at least one field is mandatory; if an asterisk (*) is used, all fields are dumped

-i

name of mfs binary stats file (default: default_data_path/stats.mfs)

-r

range type: 0 - short range (minute) 1 - medium range (6 minutes) 2 - long range (30 minutes) 3 - very long range (day)

-s

specify column separator (default: tabulator)

-p

optional PNG filename (field name will be added before .png; YYYY -> YYYY_FIELD.png, YYYY.png -> YYYY_FIELD.png)

-x

PNG chart width (default: 1600)

-y

PNG chart height (should be divisible by 20 - if not then it will be adjusted; default:320)

-h

"human-readable" numbers using base 2 prefixes (IEC 60027)

-H

"human-readable" numbers using base 10 prefixes (SI)

-d

show timestamps in YYYY-MM-DD HH:MM format

FIELDS¶

ucpu

User cpu usage

scpu

System cpu usage

cpu

Total cpu usage (in csv sum of scpu and ucpu, in png shows both in different colors)

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

prcvd

Received packets

psent

Sent packets

brcvd

Received bytes

bsent

Sent bytes

memoryrss

Resident memory usage

memoryvirt

Virtual memory usage

mem

Total memory usage (in csv is the same as memoryvirt, in png shows both memoryrss and memoryvirt using two colors)

usedspace

Used raw disk space

totalspace

Total raw disk space

space

Total raw disk space (in csv the same as totalspace, in png shows both usedspace and totalspace using two colors)

OUTPUT¶

Text output - text (csv) file where first column is a timestamp (or date if -d option was specified), the following column are what was specified with the -f options, formatted according to used options (none, -s and -h or -H)

Graphical output - one png file with a chart is created for every field specified with the -f option, according to the naming scheme declared with the -p option. Size may be adjusted with -x and -y options.

REPORTING BUGS¶

Report bugs to <bugs@moosefs.com>.

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.html

SEE ALSO¶

mfsmount(8), moosefs(7)