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)

MooseFS 3.0.117-1                                 February 2023                                  mfsstatsdump(8)