tahoe-lafs/trac-2024-07-25
2
0
Issues 1.1k Wiki Activity

[Imported from Trac: page Munin_local_plugins_README, version 1]

freestorm 2010-10-02 14:43:39 +00:00
parent 8d381d8f3e
commit e4d54f85eb
1 changed files with 70 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

70
Munin_local_plugins_README.md Normal file

@ -0,0 +1,70 @@
(Draft)<br>
It's the README file for munin local plugins<br>
Please see ticket #966
================================
# Tahoe-LAFS local plugins
1. Overview
2. Plugins details
3. Obselete plugins
4. Plugins testing
## Overview
> Those plugins are used with Tahoe-LAFS that not use a stats-gateherer.
> Some plugins use json url and some other need local access to storage directory.
> For plugins configuration please read each plugins and tahoe-conf
## Plugins details
> tahoe_files: Shows the number of files hosted by this node's [StorageServer](StorageServer).
> tahoe_diskfelt: Shows of how much free space is left on all disks across the grid.
> tahoe_diskusage: Shows the estimated disk usage per unit time, totalled 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 severs nodes
> tahoe_estimate_files: Shows the estimated number of files and directories present in the grid
## Obsolete plugins
> Those munin plugins are deeply obsolete, because they depended upon the DB that managed customer accounts at allmydata.com.
> to use this script, you will need some source of 'tahoe deep-size' results for all rootcaps that reference data in your grid.
> This tool was written for the allmydata.com environment, which maintained such a value.
> 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
## Plugins testing
> To test plugin you can run: munin-run 'plugin file'
> For example:
# munin-run tahoe_stats_storage_disk_used
RM1X_gfsd.value 28093239296
[..]
> To display graph configuration add 'config' at the end of command line:
#munin-run tahoe_stats_storage_disk_used config
graph_title Tahoe-LAFS Storage Server Disk Used
graph_vlabel bytes
graph_category Tahoe-LAFS Stats-Gatherer_storage_server
graph_info This graph shows disk usage for Tahoe
graph_args --base 1024
RM1X_gfsd.label RM1X_gfsd
RM1X_gfsd.draw LINE1
[..]