MOGSTATS(1)

NAME
mogstats -- Utility for calculating slow stats directly against a MogileFS DB

SYNOPSIS
    $ mogstats --db_dsn="DBI:mysql:mfs:host=mfshost" --db_user="mfs" \
               --db_pass="mfs" --verbose --stats="devices,files"
    $ mogstats --stats="all"
    $ mogstats [all options in ~/.mogilefs.conf]

DESCRIPTION
Utility for inspecting queues and running general statistics against a MogileFS database. Some of these stats can take a very long time to run against a large instance, so the utility can be pointed at a read slave or special account.

OPTIONS

--db_dsn=<DBI_dsn>
    The DSN to use for connecting to the MogileFS database server.

--db_user=<username>
    A database user for connecting to the database.

--db_pass=<password>
    An optional password for the database user.

--config=<file>
    An explicit config file to use. By default /etc/mogilefs/mogilefs.conf and ~/.mogilefs.conf are checked.

--verbose
    Print some extra text during processing. Mostly notes about what stats are starting or finishing.

--stats=<stats>
    A list of which statistics to calculate. Notes on some of them are listed below, see --help for full list. A value of "all" fetches all possible stats.

--help
    List usage info and supported statistics.

AVAILABLE STATISTICS
Contains notes on which stats may be fast or slow.

devices
    Lists count of files and current database status per-device. Can be very slow.

fids
    Lists the current highest file id. Should be fast.

files
    Gives a breakdown of where files are by domain and class. Displays the size of all stored files pre-replication, as well as post-replication size. The latter being closer to the actual storage amount. Can be very slow.

domains
    Shows a simple count of where files are by domain and class. Faster than using "files" but displays less information.

replication
    Displays a breakdown of devcount per domain/class combo. Shows number of files in domain "foo" with class "bar" that have a current devcount of 0, 1, 2, 3, etc. Useful for spotting broken files (devcount 0), replication lag, or over replication bugs. Can be very slow.

replication-queue
    Quick breakdown of how many fids are due for replication. Fids listed as "manual" need manual intervention before they can be replicated, and could be broken. Will be fast unless there are many files in queue.

delete-queue
    Similar to replication-queue.

general-queue
    Displays a breakdown of what's in the general queue. This includes FSCK, Rebalance, and other temporary queueing systems MogileFS has. Should be fast unless you have configured MogileFS to queue many fids at once.

AUTHOR
Dormando <dormando@rydia.net>

BUGS
None known.

LICENSE
Licensed for use and redistribution under the same terms as Perl itself.