Munin Node for Windows AKA munin-node-win32, is a Windows client for the Munin monitoring system.
It is written in C++ with most plugins built into the executable. This is different from the standard munin-node client, which only uses external plugins written as shell and Perl scripts.
- -install Install as a system service.
- -uninstall Removes the installed service.
- -quiet Close the console window, running in the background.
- -run Run as a normal program, rather than a service.
The configuration file munin-node.ini uses the standard INI file format.
The main section is the Plugins section which defines which plugins are enabled and which are disabled. Use 1 to enable and 0 to disable. Most plugins handle failing to load gracefully, however some may have a bug (if so please report :).
You can disable plugins you don't want, to save on memory and cpu usage.
CPU (cpu):
- Reports the current user cpu usage
Disk (df):
- Reports disk drive space usage
- Configuration in DiskPlugin section.
HD (hdd):
- Reports HardDrive temperature
Memory (memory):
- Reports memory usage
Process (processes):
- Reports process and thread count
Network (network):
- Reports network bytes send and received
MBM (mbm, mbm_volt, mbm_fan, mbm_cpu):
- Reports sensor data from Motherboard Monitor
SpeedFan (speedfan):
- Reports sensor data from SpeedFan xAP broadcasts
- Configuration in SpeedFanPlugin section. You have to change the BroadcastIP and UID settings to match SpeedFan (Configuration->xAP)
Performance Counter:
Reports performance counter values, very extenable to monitor any counter
An instance of this plugin is created for every section starting with PerfCounterPlugin in the Configuration. For example there is a PerfCounterPlugin_uptime section in the stock configuration file. This defines a plugin with a name of uptime.
An example section is listed below
; The Object and Counter settings are used to access the Performance Counter ; For uptime this would result in \System\System Up Time Object=System Counter=System Up Time ; The Graph settings are reported to munin GraphTitle=Uptime GraphCategory=system GraphDraw=AREA GraphArgs=--base 1000 -l 0 ; The DropTotal setting will drop the last instance from the counter list, ; which is often _Total ; Has no effect on single instance counters (Uptime) DropTotal=0 ; The CounterFormat setting controls what format the counter value is read in as ; a double, int, or large (int64). ; The plugin always outputs doubles, so this shouldn't have that much effect CounterFormat=large ; The CounterMultiply setting sets a value the counter value is multiplied by, ; use it to adjust the scale ; 1.1574074074074073e-005 is the result of(1 / 86400.0), ; the uptime counter reports seconds and we want to report days. ; So we want to divide the counter value by the number of seconds in a day, 86400. CounterMultiply=1.1574074074074073e-005External Plugin:
A plugin that supports external plugins in the style of munin-node.
Configuration in [ExternalPlugin] section. Just add an entry with the path to the program to run, It doesn't matter what the name of the name=value pair is.
The output of the external program should be similar to the following,
Note: add quotes (") around the value if it has spaces!
>disk_free.py name drive_free >disk_free.py drive_free_c.value 40.3635149113 . >disk_free.py config graph_title Filesystem free (in %) graph_category disk graph_info This graph shows the amount of free space on each disk. graph_args --upper-limit 100 -l 0 graph_vlabel % drive_free_c.label C: .
See ChangeLog
Using MS Visual C++ 2008 Express Edition
Bump version in munin-node.rc and installermunin-node-win32.nsi
Open munin-node.sln
Select Release and win32 build options
Then Build / Rebuild solution
That creates the binReleasemunin-node.exe file
Get the NSIS (Nullsoft Scriptable Install System) (2.46)
Compile installermunin-node-win32.nsi with NSIS