mfscsstatsdump(8)

💅 NAME 💅

mfscsstatsdump — bestie, this is the little tool that dumps usage data out of a chunkserver stats file, and it can hand it to you as csv or as png. your choice, you're the main character ✨

---

🎀 SYNOPSIS 🎀

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

---

🦋 DESCRIPTION 🦋

okay so mfscsstatsdump dumps usage data straight out of a chunkserver stats file. it's literally the same data sets that get used to make the GUI charts, no cap. output can be either text format (csv) or graphical format (png). and because of that, the -p, -x and -y options are mutually exclusive with the -h, -H and -d options — pick a lane bestie, you can't do both 💀

your MooseFS chunkserver saves that stats file in the DATA_PATH directory — see mfschunkserver.cfg(5) for the deets.

📊 OUTPUT 📊

Text output — a text (csv) file where the first column is a timestamp (or a date, if the -d option was specified 🌸), and the following columns are whatever you asked for with the -f options, formatted according to the options in play (none, -s, and -h or -H).

Graphical output — one png file with a chart gets created for every field you specify with -f, following the naming scheme you declared with -p. size can be adjusted with -x and -y, obviously 💅

---

✨ OPTIONS ✨

• -f — field names separated by , (go look at the FIELDS section, it's right there); at least one field is mandatory, okay? and if you use an asterisk (*) then all fields get dumped 👑
• -i — name of the 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 (the field name gets 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 it's not, it gets 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 it's the sum of scpu and ucpu, in png it 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 it's the sum of csrepin and csservin, in png it shows both in different colors)
• bwout — Data bandwidth out (in csv it's the sum of csrepout and csservout, in png it 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 it's the sum of hdrbytesr and databytesr, in png it shows both in different colors)
• hddwrite — HDD write (in csv it's the sum of hdrbytesw and databytesw, in png it shows both in different colors)
• hddopsr — HDD low level read (in csv it's the sum of hdrllopr and datallopr, in png it shows both in different colors)
• hddopsw — HDD low level write (in csv it's the sum of hdrllopw and datallopw, in png it 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 it's the same as memoryvirt, in png it shows both memoryrss and memoryvirt using two colors)
• movels — Low speed move ops
• movehs — High speed move ops
• move — Low speed + high speed move ops (in png it shows movels and movehas using two colors)
• change — Chunk changes in metadata (sum of version + duplicate + truncate + duptrunc + split)
• split — Split ops
• usedspace — Used HDD space in bytes (mark for removal excluded)
• totalspace — Total HDD space in bytes (mark for removal excluded)
• space — Total HDD space (in csv it's the same as totalspace, in png it shows both usedspace and totalspace using two colors)
• chunkcount — Number of stored chunks (mark for removal excluded)
• tdusedspace — Used HDD space in bytes on disks marked for removal
• tdtotalspace — Total HDD space in bytes on disks marked for removal
• tdchunkcount — Number of chunks stored on disks marked for removal
• copychunks — Number of chunks stored in copy format (all disks)
• ec4chunks — Number of chunk parts stored in EC4 format (all disks)
• ec8chunks — Number of chunk parts stored in EC8 format (all disks)
• chunks — Sum of copychunks + ec4chunks + ec8chunks (in png it shows all three in different colors)
• hddok — Number of valid folders (hard drives)
• hddmfr — Number of folders (hard drives) that are marked for removal
• hdddmg — Number of folders (hard drives) that are marked as damaged
• hddcnt — Number of folders (hard drives) regardless of status, aka sum of hddok + hddmfr + hdddmg (in png it shows all three in different colors)
• udiff — Difference in usage percent between the most and least used disk

---

🐛 REPORTING BUGS 🐛

found a bug? don't gatekeep, report it to <bugs@moosefs.com>. 🫶

---

👑 COPYRIGHT 👑

Copyright (C) 2026 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 this program; if not, see <https://www.gnu.org/licenses/>.

---

🌸 SEE ALSO 🌸

mfschunkserver(8), mfsstatsdump(8)

---

okay bestie that's the whole thing, you ate it up 💖 this was MooseFS 4.59.2-1, dated May 2026 — periodt ✨👑🦋