+.. -*- coding: utf-8-with-signature -*-
+
================
Tahoe Statistics
================
this group counts inbound storage-server operations. They are not provided
by client-only nodes which have been configured to not run a storage server
(with [storage]enabled=false in tahoe.cfg)
-
+
allocate, write, close, abort
these are for immutable file uploads. 'allocate' is incremented when a
client asks if it can upload a share to the server. 'write' is
999 out of the last 1000 operations were faster than the
given number, and is the same threshold used by Amazon's
internal SLA, according to the Dynamo paper).
+ Percentiles are only reported in the case of a sufficient
+ number of observations for unambiguous interpretation. For
+ example, the 99.9th percentile is (at the level of thousandths
+ precision) 9 thousandths greater than the 99th
+ percentile for sample sizes greater than or equal to 1000,
+ thus the 99.9th percentile is only reported for samples of 1000
+ or more observations.
+
**counters.uploader.files_uploaded**
active_uploads
how many files are currently being uploaded. 0 when idle.
-
+
incoming_count
how many cache files are present in the incoming/ directory,
which holds ciphertext files that are still being fetched
the desired portnumber into a file named "portnum" (i.e. $BASEDIR/portnum),
and the next time the gatherer is started, it will start listening on the
given port. The portnum file is actually a "strports specification string",
-as described in `docs/configuration.rst <configuration.rst>`_.
+as described in configuration.rst_.
Once running, the stats gatherer will create a standard python "pickle" file
in $BASEDIR/stats.pickle . Once a minute, the gatherer will pull stats
total-disk-available number for the entire grid (however, the "disk watcher"
daemon, in misc/operations_helpers/spacetime/, is better suited for this specific task).
+.. _configuration.rst: configuration.rst
+
Using Munin To Graph Stats Values
=================================
graphs of various things over multiple time scales (last hour, last month,
last year).
-.. _Munin: http://munin-monitoring.org/
-
Most of the plugins are designed to pull stats from a single Tahoe node, and
are configured with the e.g. http://localhost:3456/statistics?t=json URL. The
"tahoe_stats" plugin is designed to read from the pickle file created by the
Please see the docstrings at the beginning of each plugin for details, and
the "tahoe-conf" file for notes about configuration and installing these
plugins into a Munin environment.
+
+.. _Munin: http://munin-monitoring.org/