acpi-monitor for Xymon (and Hobbit)acpi-monitor for Xymon
(and Hobbit too of course) collects various environmental data from your system (probably a laptop computer) with the help of acpitool. The collected data is graphed in RRDs with the help of Xymon's excellent NCV-module to provide trending/history.
Using acpitool instead of lm_sensors has the advantage of fewer dependencies on configuration files and an almost general availability (except very old hardware) even in default installations of a Linux system.
Only a limited subset of the metrics available via lm_sensors (e.g. no voltages) is available via ACPI. The big advantage of this is the ease in setting up acpi-monitor.
Currently collected, reported and graphed environmental metrics are:
- cpu: frequency and scaling governor
- battery: remaining capacity, capacity loss
- fan: status and speed (only one fan supported currently)
- temperatures: thermal zones (supports multiple thermal-sensors)
Especially the reporting (and more important: the trend graphs) of the battery capacity loss aids the replacement planning of laptop batteries.
The reporting of laptop battery details (model number, serial number) might help in case of product recalls to identify affected batteries quickly.
$ ./acpi-monitor -h
Copyright (c) 2009, 2010 Thomas Eckert, http://www.it-eckert.de/
A Xymon-extension for monitoring various metrics collected with acpitool.
usage: acpi-monitor [-h] | [-d] [-m mod-list] [-c] [-g governor] [-f max_fan]
-d debug-mode: print to stdout only, send nothing to server
-m mod-list space-separated list of modules to execute,
defaults to all="cpu battery fan thermal".
-c report color "clear" and ouput for "<not available>" metrics,
by default these statuses are _not_ supressed
-g governor cpu: frequency-governor that should be active,
defaults to "ondemand".
(Note: to check for _no_ scaling-governor use "n/a")
-f max_fan fan: workaround for unrealistic high fan-speeds,
defaults to "5000".
-h show this help-message
Installation instructions and graphing definitions are included in the tarball.
Copying and distribution of this package (acpi-monitor
), with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This package is offered as-is, without any warranty.
list of recent CHANGES
v0.5.1, 2010-11-14: acpi-monitor-0.5.1.tgz
v0.5.0, 2010-05-30: acpi-monitor-0.5.0.tgz