Download    Support    Documentation    Screenshots    Demo   
 
This is the homepage of Unnoc.

Latest release is 1.0.10.2    (released Aug 19 2007):

The homepage is coming along, although it is not done yet. I will add HTML documentation and add much more information very soon.

Help Wanted! Unnoc needs a documentation overhaul. The documentation is decent, however it needs to be organized and a FAQ needs to be added as well. If you think you can help out with this in any way, please drop me a line!

Unnoc is a NOC network monitoring application that is designed to integrate traffic graphs (RRDTool) with SNMP host checking, monitoring and graphing. It uses native SNMP to monitor servers, Wireless Access Points, UPS's, routers, firewalls, network switches--anything SNMP-enabled, and will send out pages and email alerts if something is wrong.

  Monitoring for Linux/UNIX and Microsoft® Servers/Workstations:
  Process monitoring
  CPU Load / Load Average
  Memory Usage
  Disk Usage
  Disk I/O Counters
  Network Interface traffic
 
  Completely integrated with RRD for all graphs
  Configurable Email alerts for all devices monitored
  Uptime monitor plugin, displays the mean/min/max time of all uptimes
  Throughput display for any device that can monitor SNMP interfaces
  Flexible and completely customizeable configuration
 
  Application specific plugins for:
  VMware Virtual Infrastructure 3 (ESX and VirtualCenter)
  Barracuda SPAM Firewalls
  Cisco Aironets
  Apple Airports
  APC Smart-UPSs (single and 3 phase units)
  Network Appliance Filers
  EM01 Websensor Environment Monitor
  OpenLDAP
  PostgreSQL
  MySQL

Screenshots of all of these features are below.

As of 1.0.6 MRTG is completely phased out and Unnoc is completely integrated with RRD.

Demo Site

Please see the demo available hosted here. Also, I've made available the index.php and unnoc.conf that are associated with the demo site

http://unnoc.org/demo

Demo index.php: index.php
Demo etc/unnoc.conf: unnoc.conf
Demo version: Unnoc 1.0.10.2

The demo is a snapshot of an actual Unnoc install.

New Plugins

OpenLDAP, PostgreSQL, MySQL

   

New to 1.0.8, three application specific plugins have been added, they are:

- OpenLDAP (tested against 2.1, 2.2 and 2.3)
- MySQL (tested against 4.x and 5.x)
- PostgreSQL (tested against 7.4.x, 8.x)

Monitoring and graphing is available for each of the plugins

VMware Virtual Infrastructure 3

Added in 1.0.7, VMware Virtual Infrastructure 3 has been added. This means you can graph ESX utilization as well as track all of your Virtual MAchines. It currently graphs the following:

Click here to see a working demo of this.

- ESX Memory Usage
- ESX CPU Usage
- ESX Network Bandwidth Usage
- ESX Disk Access Usage (read/write counters)
- ESX Console statistics (via SNMP)
- VM Memory Usage
- VM CPU Usage
- VM Network Bandwidth Usage
- VM Disk Access Usage (read/write counters)
- VM Power States (suspended/off/on)
- VirtualCenter Console statistics (via SNMP)

This plugin is one of the exceptions: it does not use SNMP. Instead, the VI Perl Toolkit was used, which uses the SDK provided by VMware:

http://sourceforge.net/projects/viperltoolkit/

Why not SNMP for VMware ESX / VI3?

VMware does actually provide a MIB available with ESX, and it does display much information about all of the VM's and the ESX server itself. There were a few problems with it, for one the information wasn't updated in real time (it seemed to be caching quite a bit of data), which presented its own problems. But the main issue at hand was that not all information was available through SNMP. Specifically, CPU usage and CPU Mhz wasnt available. They do provide a cpuUtil counter, however that is milliseconds used by each VM, and given that value you could calculate a percentage of Real CPU based on the amount of time passed in between each read. However this did not prove to be 100% accurate, and I would get very large spikes every now and then. CPU Mhz wasn't available either, so you can not tell how many cycles are available total. Another reason is the counters that were provided for disk I/O and ethernet were not always 100% accurate. They would often times just mimic each other. I'm not sure why it didn't work like it was supposed to, but it didn't.

So instead, the plugin was written with the VI Perl Toolkit. This is better for a few reasons, not only because it gives you access to the exact same information as the VI3 client or the MUI has, but more importantly it allows you to connect to a VirtualCenter server and read all of the information from there. VI3 is designed to be used with a VCMS server, so it only makes sense to connect to it for all information. If you do not use a VCMS server, it will still work just the same with an ESX standalone server.

Currently it is monitoring CPU Usage, Memory, Disk I/O, and Ethernet Traffic. In the future there will be Resource Pools as well.

Barracuda SPAM Firewall

Click here to see a working demo of the Barracuda Plugin.

The Barracuda SPAM Firewall plugin uses the stats.cgi available on the Barracuda. It also provides an SNMP interface, however it does not have any special MIBs; in fact, it only supports the External MIB's available to net-snmp, and there are only three of them. So instead it was implemented to read the XML available on stats.cgi. This information is the same information that you see on the Barracuda Admin page. It will graph all things available there.

Download

The tarball is below.

Latest release is 1.0.10.2 (released Aug 19 2007):

unnoc-1.0.10.2.tar.gz      d938499f098d45d72a1ccb83fa6fd740

Changelog: Changelog, Release Notes: WHATSNEW

VMware Appliance Download

As an alternate to the unnoc.org VM appliance, you can also download Timo Sugliani's Unnoc appliance from the following link:


The alternate VM appliance is running the SVN head as of 11/18/2007.

 

See the README.vmware-appliance document for configuration and installation instructions

If you are already using any version of VMware, then you can download the Unnoc VMware appliance to try it out to see if you like it. It is already installed and ready to go, just simply make a new VM as Linux 2.6 Other and start it up. The VMware VMDK is available for download below. Debian Etch is installed from Feb 01 2007, it currently has Apache 2.2, Mysql 5, PHP 4, and RRDTool 1.2.15 installed. VMware Tools are not installed.

Unnoc Version Installed 1.0.10.1
Linux Distro Installed Debian Etch (installed Feb 01 2007)
VM Type Linux 2.6.x Other
VM Disk Size 2.0GB
VM Memory 384MB
Apps installed Apache 2.2.x, Mysql 5.x, PHP 4.x, RRDTool 1.2.15
VMware Version Workstation 5.5.2
VMware Tools installed No
Root Password unnoc123
  
VMDK Download
unnoc-1.0.10.1.vmdk.bz2 94ce837b8b819c92c84cf2784836fdef
VMDK Size (compressed) 273MB
VMDK Size (uncompressed) 833MB
VMDK Release Date Jul 11 2007

VMDK Installation / Use

The VMDK was initially made with VMware Workstation 5.5.2, however it should work with any number of VMware products.

This is a VMDK file, meaning it is a VMware disk. To add it, you need to create a Custom VM using this disk as the root disk. For VMware Workstation, use the following set of instructions (may vary from version to version and platform to platform):

1. Add a "Custom" VM, choose "New - Workstation 5"
2. Use "Linux, Other 2.6.x Linux"
3. Go through Processor and Memory choices,
4. Choose SCSI, LSI Logic adapter
5. Use an existing virtual disk
6. choose "unnoc-1.0.10.1.vmdk"

Once that is complete, you can use your new Virtual Machine.

For ESX 3.0.x, you will need to clone the disk first (because it is not in the ESX format), do this by typing the following command (from the ESX console):

vmkfstools -i /path/to/unnoc-1.0.10.1.vmdk new-filename.vmdk

Support

For problems, questions, bugs and feature requests, please see the sourceforge project page or the mailing list:

Unnoc-support mailing list
Tracker sourceforge bug/feature request tracker

Documentation

Documentation - Here is a link to the documentation that is provided with the package. Hopefully by the next release all of the documentation will be in HTML on this site, for now it is all text files packaged with the release.

Screenshots

Screenshots of what the index page might look like:

   

I've currently written application specific plugins for the following devices:

  APC Smart-UPS (screenshot is 3 Phase) (screenshot)
  APC PDU (screenshot is 3 Phase) (screenshot)
  EM01 Environment Monitor Websensor (screenshot)
  Router / Firewall throughput display (screenshot)
  Cisco Aironet 1231 access point plugin (screenshot1 ) (screenshot2 )
  Apple Airport Extreme plugin (screenshot)
  Netapp FAS270 Filer (screenshot)
  Barracuda SPAM Firewall (screenshot)
  VMware Virtual Infrastructure 3 (VI3) (screenshot)

The latest plugin supports VMware's Virtual Infrastructure 3 (VI3). It supports both standalone ESX servers as well VirtualCenter VCMS servers. It will use RRDTool to graph the CPU and Memory usage of all of the Virtual Machines, as well as graph the Disk/CPU/Memory usage of each of the VMware servers themselves.

VMware Virtual Infrastructure 3 screenshots

Below are some screenshots from a few VI3 servers.

   

  VI3 Main Page (screenshot)
  VI3 Main Page (cont'd) (screenshot)
  ESX Server Page (screenshot)
  ESX CPU Usage on one ESX server screenshot1
  Virtual Machine page (screenshot)

Barracuda SPAM Firewall screenshots

Below are some screenshots from a Barracuda SPAM Firewall

 

Linux/UNIX/Windows Screenshots

Unnoc will also monitor disk usage, process and load averages of any server that is SNMP enabled and it will write that to a sql db, which can be retrieved via php calls, If anything is wrong with the server, then unnoc will send out alerts and pages (like if a process goes down, or a disk gets too full).

Server Screenshots:

       

Unnoc is now integrated with RRDTool and will graph each load average, each disk used and each process, and will display 4 graphs each: daily, weekly, monthly, and yearly (very similar to MRTG output). Graphs are basic and pretty primitive, but it's a step in the right direction.

  Load Average graph 1 screenshot (zoom daily graph: zoom)
  Load Average graph 2 screenshot (zoom monthly graph: zoom)
  Load Average graph 3 screenshot
  Load Average graph 4 screenshot
  Process monitored graph 1 screenshot
  Process monitored graph 2 screenshot (zoom daily graph: zoom)
  Disk Usage graph screenshot
  Disk Usage graph screenshot
  Microsoft Server graph 1 screenshot
  Microsoft Server graph 2 screenshot

All server graphs are integrated with RRDTool. Currently all network interfaces get monitored, memory usage, CPU percentage loads and TCP connections. Screenshots are below.

         

Other screenshots of interest.

  screenshot - Temperature Spike, this is what happens when the AC goes out over the weekend
  screenshot - AVR Boost Smart-UPS, our building seems to not give us enough juice from 10AM-10PM

It is similar to Nagios and Big Brother except it only requires SNMP to be run on the host, instead of some other binary. And the interface is completely configurable, the look and feel is all php, so it can be made to look like anything. I think it's quite a bit simpler than either of the other two projects, however the other two are quite a bit more mature in their development cycle.

Also many other projects are not using RRDTool, instead of RRD they are using MRTG or other graphers. RRDTool is the most flexible graphing utility and can do all sorts of customizeable features.

Unnoc is written in a combination of php and perl. It currently works for *NIX systems (tested on Linux only). It has not been tested on Windows yet, although I don't see why it wouldn't work. It is still in heavy active development as well, and I'm willing to fix any bugs that come up. And I love feature requestes as well, so if any of you have any ideas out there, please post them in the feature requests tracker on sourceforge or just shoot me an email.

Contributers

Developers needed! Here is the current TODO list for Unnoc.

if you would like to contribute in any way, please let me know. There's a lot of work to do to make it to where I want it to be, PHP/Perl developers are definitely needed.

Sourceforge page

Please see the Unnoc sourceforge project page for other information

https://sourceforge.net/projects/unnoc

 
© 2005-2007 Copyright Jason Schoonover jason_jks yahoo dot com. Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. VMware, VirtualCenter, ESX, VCMS are either registered trademarks or trademarks of VMware Inc. in the United States and/or other countries. This material is not sponsored by, electrosed by, or affiliated with Cisco Systems, Inc. Cisco, Cisco Systems, and the Cisco Systems logo are registered trademarks or trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries. Linux is a registered trademark of Linus Torvalds. UNIX is a registered trademark of The Open Group.