# munin-node-win32

**Repository Path**: mirrors_pmezard/munin-node-win32

## Basic Information

- **Project Name**: munin-node-win32
- **Description**: Munin Node for Windows
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

============================
Munin Node for Windows
============================

Introduction
------------
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.

Command Line Usage
------------------

  * -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.

Configuration File
------------------

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.

Plugins
-------

  * 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-005

  * External 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:
        .

Version History
---------------
See ChangeLog


Building a release
------------------

Using MS Visual C++ 2008 Express Edition

Bump version in `munin-node.rc` and `installer\munin-node-win32.nsi`

Open `munin-node.sln`

Select `Release` and `win32` build options

Then `Build` / `Rebuild solution`

That creates the `bin\Release\munin-node.exe` file

Get the `NSIS (Nullsoft Scriptable Install System)` (2.46)

Compile `installer\munin-node-win32.nsi` with NSIS