External dstat plugins
======================

The core functionality of dstat is self-contained inside the dstat script,
but it is possible to add your own dstat plugins. Currently the following
external plugins exist:

	dstat_app		- most expensive process
	dstat_battery		- battery in percentage (needs ACPI)
	dstat_clock		- human-readable clock
	dstat_cpufreq		- CPU frequency in percentage (needs ACPI)
	dstat_dbus		- dbus connections (needs python-dbus)
	dstat_freespace		- disk usage on per filesystems
	dstat_gpfs		- GPFS read/write I/O (needs mmpmon)
	dstat_gpfsop		- GPFS filesystem operations (needs mmpmon)
	dstat_nfs3		- NFS v3 client operations
	dstat_nfs3op		- Extended NFS v3 client operations
	dstat_nfsd3		- NFS v3 server operations
	dstat_nfsd3op		- Extended NFS v3 server operations
	dstat_postfix		- postfix queue size (needs postfix)
	dstat_rpc		- RPC client calls
	dstat_rpcd		- RPC server calls
	dstat_sendmail		- sendmail queue size (needs sendmail)
	dstat_thermal		- system temperature sensors
	dstat_utmp		- utmp connections (needs python-utmp)
	dstat_wifi		- wireless link quality and signal to noise ratio

You can enable any of these stats by using the -M options:

----
dstat -a -M dbus,utmp
----

Currently I foresee that all stats that depend on something else than
just the kernel or the stock python modules are implemented as external
plugins. Also experimental plugins or plugins that are expensive should
be external.

Future possible external plugins:

	dstat_amavisd
	dstat_apache
	dstat_bind
	dstat_cifs
	dstat_dhcpd
	dstat_dnsmasq
	dstat_gfs
	dstat_qla2300
	dstat_samba (needs a python tdb implementation ?)
	dstat_squid


NOTE: Please send me improvements to this document.