linux/Documentation/cgroups
Divyesh Shah 812df48d12 blkio: Add more debug-only per-cgroup stats
1) group_wait_time - This is the amount of time the cgroup had to wait to get a
  timeslice for one of its queues from when it became busy, i.e., went from 0
  to 1 request queued. This is different from the io_wait_time which is the
  cumulative total of the amount of time spent by each IO in that cgroup waiting
  in the scheduler queue. This stat is a great way to find out any jobs in the
  fleet that are being starved or waiting for longer than what is expected (due
  to an IO controller bug or any other issue).
2) empty_time - This is the amount of time a cgroup spends w/o any pending
   requests. This stat is useful when a job does not seem to be able to use its
   assigned disk share by helping check if that is happening due to an IO
   controller bug or because the job is not submitting enough IOs.
3) idle_time - This is the amount of time spent by the IO scheduler idling
   for a given cgroup in anticipation of a better request than the exising ones
   from other queues/cgroups.

All these stats are recorded using start and stop events. When reading these
stats, we do not add the delta between the current time and the last start time
if we're between the start and stop events. We avoid doing this to make sure
that these numbers are always monotonically increasing when read. Since we're
using sched_clock() which may use the tsc as its source, it may induce some
inconsistency (due to tsc resync across cpus) if we included the current delta.

Signed-off-by: Divyesh Shah<dpshah@google.com>
Signed-off-by: Jens Axboe <jens.axboe@oracle.com>
2010-04-09 08:36:08 +02:00
..
00-INDEX trivial: fix where cgroup documentation is not correctly referred to 2009-03-30 15:22:02 +02:00
blkio-controller.txt blkio: Add more debug-only per-cgroup stats 2010-04-09 08:36:08 +02:00
cgroup_event_listener.c cgroups: add simple listener of cgroup events to documentation 2010-03-12 15:52:37 -08:00
cgroups.txt cgroup: implement eventfd-based generic API for notifications 2010-03-12 15:52:37 -08:00
cpuacct.txt cpuacct: add per-cgroup utime/stime statistics 2009-04-01 16:49:38 +02:00
cpusets.txt doc: cpuset: Update the cpuset flag file 2010-02-24 11:06:39 +01:00
devices.txt trivial: cgroups: documentation typo and spelling corrections 2009-03-30 15:21:58 +02:00
freezer-subsystem.txt freezer_cg: disable writing freezer.state of root cgroup 2008-11-12 17:17:16 -08:00
memcg_test.txt memcg: fix typos in memcg_test.txt 2010-03-12 15:52:38 -08:00
memory.txt memcg: fix typo in memcg documentation 2010-03-24 16:31:20 -07:00
resource_counter.txt res_counter: update documentation 2009-04-13 15:04:30 -07:00