Revision as of 10:34, 22 October 2008

Concept

scheduler statistics visualization tool

This utility will process various scheduler related statistics (e.g. /proc/schedstat) such that the "busiest" stats (greatest delta) will bubble up to the top similar to the ubiquitous "top" utility. It can alternately be sorted by the stat's value, or by name. Stats can be inclusively or exclusively filtered based on reg-ex pattern matching.

Usage

Running

schedtop <options>

 -h [ --help    ]         produces help message
 -p [ --period  ] arg     refresh period (default=1s)
 -i [ --include ] arg     reg-ex inclusive filter (default=".*")
 -x [ --exclude ] arg     reg-ex exclusive filter (default="^$")
 -s [ --sort    ] arg     sort-by: n=name, v=value, d=delta (default='d')

Press Cntrl-C to exit the utility

Example

To filter out any stats with "sched_info" or "imbalance" in the name, use the exclude filter with an OR operator

schedtop -x 'sched_info|imbalance'

Kernel Configuration

You need to enable the scheduler statistics in your .config. This utility will only work with v14 of the stats (current as of this writing)

RPM Repositories

A variety of x86 platforms can be found available as RPMs in YUM repositories created by the OpenSUSE Build Service:

http://download.opensuse.org/repositories/home:/ghaskins

You can download the .rpm directly, or alternatively add the repository to your system to receive updates when new versions of schedtop are released automatically.

Direct links to a subset of the available builds:

Source Code

GIT Tree

   git clone git://git.kernel.org/pub/scm/linux/kernel/git/ghaskins/schedtop.git

Tarball

   ftp://ftp.novell.com/dev/ghaskins/schedtop.tar.gz

Browse the source

gitweb on git.kernel.org