Tahoe-LAFS Local Plugins
- Overview
- Current Plugins
- Obsolete Plugins
- Testing
Overview
This is the README for munin local plugins for Tahoe-LAFS (see ticket #966).
These plugins are used with Tahoe-LAFS grids that do not use a stats-gatherer.
Some plugins use json url and others need local access to the storage directory (needs a new column in the table below).
For configuration information, please see each individual plugin.
Current Plugins
tahoe_files Shows the number of files hosted by this node's storage server tahoe_diskfelt Shows how much free space is left on all disks across the grid tahoe_diskusage Shows the estimated disk usage per unit time, totaled across all storage servers tahoe_diskused Shows the total amount of disk space used across the grid tahoe_disktotal Shows the total amount of disk space present in the grid, and how much of it is currently being used tahoe_doomsday Shows the estimated number of days left until storage space is exhausted tahoe_introstats Shows the number of hosts announcing and subscribing to various services tahoe_nodememory Shows the memory used by specific processes tahoe_helperstats_active Shows the number of files being actively processed by the helper tahoe_helperstats_fetched Shows the amount of data being fetched by the helper tahoe_server_latency_ Shows the latency statistic for a given operation and percentile from a set of storage servers tahoe_server_operations_ Shows operations-per-second from a set of storage servers tahoe_storagespace Shows the space consumed by server nodes tahoe_estimate_files Shows the estimated number of files and directories present in the grid
Obsolete Plugins
These munin plugins are obsolete because they were designed for the customer database at allmydata.com.
These plugins require a source of 'tahoe deep-size' results for all rootcaps that reference data in your grid. If you are managing a grid where you have this information, these scripts may still prove useful.
tahoe_overhead Shows the estimated amount of storage overhead (ratio of actual disk usage to ideal disk usage) tahoe_spacetime Shows the estimated number of days left until storage space is exhausted tahoe_rootdir_space Shows the amount of space consumed by all files reachable from a given directory
Testing
To test a plugin you can run: munin-run <plugin_file>
For example:
# munin-run tahoe_diskleft disk_left.value 670599436800
To display graph configuration add 'config' at the end of command line:
# munin-run tahoe_diskleft config graph_title Tahoe-LAFS Remaining Disk Space graph_vlabel bytes remaining graph_category Tahoe-LAFS graph_info This graph shows the total amount of disk space left available in the grid disk_left.label disk left disk_left.draw LINE1
