Welcome to the SNMAgent project page

Every environment needs good system maintenance, and the key is to have excellent tools for system monitoring, notification and trend analysis. In the open source marked the two tools I've found closest to the "excellent" mark is Nagios and Munin. Together day give all you need for the linux/unix servers. However win32 support is not natively supported by any of them. SNMAgent is an attempt to fill this gap.

About this document

This project is in the state of internal testing, and so this document is indented for developers of SNMAgent and selected test personnel at Linpro (Developers of Munin). Others may find the information useful.

Support

We cannot give any kind of support for the SNMAgent at this time. System spec and scope of the project will change drastically. Please do not put the SNMAgent in any kind of production environment.

Credits

Nagios is a stand-alone enterprise-class monitoring solution. Nagios does not recognize SNMAgent as valid Nagios project. Se www.nagios.org.
Munin is a project driven by Linpro to give information of system performance/trends in graphs through a web interface. Se munin.projects.linpro.no.
NSClient is a win32 NT service for Nagios. NSClient is recommended in the Nagios FAQ as a Nagios Add-on for Windows. The NSClient source code is used in full for the SNMAgent project. The source is modified to compile with Delphi 2006, and support for Munin is built on top of the already working Nagios implementation. Se http://nsclient.ready2run.nl.

Project status

Overview

Project is in the state of internal testing and proof-of-concept. Nagios part of SNMAgent is working, there is not yet found any problems with the source modifications from the NSClient. Munin part of SNMAgent is able to talk to the Munin server and give system status. Some "Munin plugins" are supported by hard coded integration in the service. Some plugins can be configured to some extent; some are only in proof-of-concept stage and only working on developer machine or identical hardware.

Plugins

SNMAgent reports to have df, cpu, eth0, memio and memcommit plugins when invoked with the list command.

df

Support config or fetch command.
SNMAgent will list and give % usage of all system drives if they are marked as dtFixed or dtRAM, network, floppy, usb, dvd etc is filtered out.

Output from config command can be overwritten by placing a df.cfg file in etc\. User will then be fully responsible for compatibility with config and fetch output.

Sample df.cfg file:

graph_title File system usage (in %)
graph_args --upper-limit 100 -l 0
graph_vlabel %
graph_category disk
graph_info This graph shows disk usage on the machine.
disk_c.label c: (system)
disk_c.info c:
disk_c.warning 70
disk_c.critical 80
disk_d.label d: (media)
disk_d.info d:
disk_d.warning 70
disk_d.critical 80
disk_f.label f: (junk)
disk_f.info f:
disk_f.warning 70
disk_f.critical 80

cpu

Support config or fetch command.
SNMAgent will sample average cpu usage last 5 minutes and give percentage of total cpu usage for all cores last 5 minutes when invoked with fetch cpu
Plugins needs etc\cpu.cfg for output of config cpu.

eth0

Proof of concept support for config and fetch command.
Lakes support for enumerating network hardware.
SNMAgent will output current in/out data of Network Interface(NVIDIA nForce Networking Controller - Packet Scheduler Miniport) pr sec.
Plugins needs etc\eth0.cfg for output of config eth0.

memoio

Support config or fetch command.
Reports current memory pages/sec.
Plugins needs etc\memoio.cfg for output of config memio.

memcommit

Support config or fetch command.
Reports current commit limit, commit bytes and page file size.
Plugins needs etc\memcommit.cfg for output of config memcommit.

Installation

SNMAgent needs to be installed in a directory compatible for an NT Service. If running the service as system user this normally rules out mapped network drives etc. Also make sure the user is able to read the directory.
SNMAgent service creates parameters in HKLM\SOFTWARE\SNMAgent. The service needs to read this registry key. password and port is for the Nagios implementation of SNMAgent only.
The 3th parameter, "Path", is used for the Munin implementation of SNMAgent and must be present before starting the service. Currently the value is used to locate the etc\ folder. Value should not include a trailing slash.

Sample registry data:
```
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\SNMAgent]

[HKEY_LOCAL_MACHINE\SOFTWARE\SNMAgent\Params]
"port"=dword:000004e0
"password"="None"
"Path"="D:\\Apps"
```

note: The installer should take care of the above for you.

NT Service can be installed by running "snma.exe /install". If Inno Setup installer is used, you should find a shortcut for this on your Start Menu.
After installation the service can be started by running "net start snmagent", using windows gui or rebooting the computer.

Debugging

While debugging, please note that some information is logged to the Windows Events Log, under Application

Download

Please read above information to understand what you are downloading, no support will be given. Project it not ready for production.

Setup file (2006-06-05, v.01)
Individual project files, and source not yet ready for direct download. Source is given as a lisence requirement.