NAME

       mfscsstatsdump - dump usage data from chunkserver stats file in csv or png format

SYNOPSIS

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

DESCRIPTION

       mfscsstatsdump dumps usage data from chunkserver 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 chunkserver saves the stats file in the DATA_PATH directory - see mfschunkserver.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/csstats.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)

       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

       bwin          Data bandwidth in (in csv sum of csrepin and csservin,  in  png  shows  both  in  different
                     colors)

       bwout         Data  bandwidth  out  (in csv sum of csrepout and csservout, in png shows both in different
                     colors)

       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)

       hddread       HDD read (in csv sum of hdrbytesr and databytesr, in png shows both in different colors)

       hddwrite      HDD write (in csv sum of hdrbytesw and databytesw, in png shows both in different colors)

       hddopsr       HDD low level read (in csv sum of hdrllopr and datallopr, in png shows  both  in  different
                     colors)

       hddopsw       HDD  low  level write (in csv sum of hdrllopw and datallopw, in png shows both in different
                     colors)

       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      Duptrunc (duplicate+truncate) ops

       test          Test chunk ops

       load          Server load

       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)

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

       mfschunkserver(8), mfsstatsdump(8)

MooseFS 3.0.117-1                                 February 2023                                mfscsstatsdump(8)