gmondump

gmondump [options] [file]

-d
    Do not fork to daemonize. Useful for debugging.

-D
    Set debugging level.

-m
    Match records from this host.

-M
    Match records for this metric.

-n
    Match records for this cluster name.

-N
    Filter on the hostname (same as -m).

-p
    gmond port number.

-r
    Match record using regular expression on the whole record.

-t
    Sample output every seconds.

-T
    Start dumping only records after given time.

-Z
    Stop dumping records after given time.

-x
    Show XML output.

-z
    Dump zero value metrics.

-w
    Write data to a file (useful for testing).

-h
    Display help message.

-V
    Display version information.

gmondump is a command-line tool used to extract and display data from Ganglia Metric Daemon (gmond) binary files. These files typically contain historical performance metrics collected by gmond, such as CPU utilization, memory usage, network traffic, and other system statistics.
The tool allows users to inspect the raw data collected by Ganglia. This is helpful for debugging, analyzing historical trends, and verifying data integrity. gmondump reads the specified gmond data file and prints the metrics in a human-readable format to standard output.
It helps administrators and developers verify that gmond is properly collecting and storing data and is crucial for understanding system behavior over time, performing capacity planning, and identifying potential performance bottlenecks. It offers a basic way to extract the metrics that have been recorded. By default, gmondump prints all data found in the file. You can limit what is displayed using command-line options. Note: this tool directly accesses the gmond data files, and thus its access can impact gmond's performance if it is using the files concurrently.

The command's direct file access could impact gmond performance.

Both -T and -Z accept time in these formats:
'now' for the current time.
'YYYYMMDDhhmmss' for a specific timestamp.
'secs' for a number of seconds since the epoch.
'-secs' or '+secs' for a relative number of seconds before or after now. Example: '-3600' for an hour ago.

gmondump is a utility that is part of the Ganglia Monitoring System. Ganglia's development began in the early 2000s to provide scalable distributed monitoring for high-performance computing systems such as clusters and grids. gmondump was created to facilitate the inspection of data captured by gmond, allowing administrators to understand system performance trends and debug any issues that arise. Its purpose is deeply tied to Ganglia's architecture and usage in large distributed systems.

gmond(8), gmetad(8)