wiki:Munin_local_plugins_README

Tahoe-LAFS Local Plugins

  1. Overview
  2. Current Plugins
  3. Obsolete Plugins
  4. 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
Last modified at 2010-10-18T19:42:37Z Last modified on 2010-10-18T19:42:37Z