Announces
09-May-2010 - Release of Debain build source contributed by Laurent Foucher
12-Apr-2010 - Shutdown Freebsd+Nagios+N2rrd demo4 Server
28-Feb-2010 - Release of YAL (Yet Another Look) 1.0 see Live Demo1
28-Feb-2010 - Release of n2rrd 1.4.1 see Live Demo1
above diagram shows the interaction of n2rrd and rrd2graph with Nagios
Table of Contents
Welcome to Nagios to RRD Project Home
Nagios to RRD = n2rrd, is a small perl script,
which analyzes perf-data string for one or more name=value pairs and creates/updates RRA (Round Robin Archives).
The archive can later be viewed by any RRD database graph front end e.g. rrd2graph, Cacti, Drraw, etc.
License
Example plugin output string and what n2rrd extracts
- check_http output (anything after '|'): time=0.294561s;;;0. size=46869B;;;0
- n2rrd understands nagios performance data format
- 'label'=value[UOM];[warn];[crit];[min];[max]
- n2rrd extracts: time: time=0. UOM=s max=0., size: size=46869 UOM=B max=0
- at least one pair like 'name=value' must exist.
Features
- template based RRA creation
- simple display tool "rrd2graph" for displaying rrd data generated by n2rrd
- template based GRAPH creation
- zoom in/out of graphs
- searching/grouping of graphs (e.g. screenshots of SysLoadGrouping or icmpGrouping)
- possibility to parse non standard performance data string with external perl script
and pass n2rrd conform string to n2rrd - possibility to relocate rra file
- possibility to rewrite DS names
- if more than one DS values stored, individual values can be viewed by rrd2graph.cgi
- mapping service name string to single word value
e.g. System load average to load - mod_perl support
- n2rrd.pl works with SpeedyCGI
- dynamic creation of RRA templates (e.g. dynamic template created for nagios plugin check_disk
- dynamic creation of RRA archives
- dynamic update of new values in RRA archives
- dynamic graph template creation (e.g. output of nagios plugin check_disk)
- new option to n2rdd/rrd2graph for storing RRA and cache images in groups
Frequently Asked Questions
Why Monitoring + graphs
- Monitoring performance of System, Network or Applications nowadays is a must for serious administrators.
- Additionally graphical representation of past and present performance data helps not only administrators to recognizing anomalies and trends, but also helps pinpoint bottlenecks or use the information as an aid in budget planning
- If you want to check how the system performed during your absence (Weekend, Holiday, etc). The best you can do is have a look at the graphs.
- more at FAQ
Support
- First try community support channels, it is free and n2rrd developers are also members of the list:
- Mailing list n2rrd-users @ diglinks.com: for all n2rdd users related installation/operational/functional questions
- Subscribe/Unsubscribe to list
- Mailing list n2rrd-devel @ diglinks.com: for all n2rrd code related question/problem/issues/solution/patches
- Subscribe/Unsubscribe to list
- Or directly to developers at diglinks monitoring @ diglinks.com
- Mailing list n2rrd-users @ diglinks.com: for all n2rdd users related installation/operational/functional questions
- if you are still interested in commercial support, please check Support
TODO
- if you like to contribute, please have a look at TodosList
Demo
- Live Demo1 a complete monitoring setup based on apache, nagios, n2rrd, rrd2graph (access as username: guest, password: guest)
- Live Demo2 the data is collected by n2rrd and displayed using Cacti
- Live Demo3 the data is collected by n2rrd and displayed using Drraw
Live Demo4 FreeBSD+Nagios+N2RRD live demo server
Requirement
- Working Nagios installation
NOTE: has been developed and tested on Nagios 3.x, 2.x, should work with minimal changes on Nagios 1.x as well - PERL - tested with 5.8.x (perl is normally installed on most unix systems by default)
- RRDTOOL - including perl packages
- PERL Module - starting n2rrd ver. 1.4.0 RRD::Simple used by n2rrd.pl for creating dynamic RRA
- Graph tool - rrd2graph.cgi included with n2rrd package, Cacti, Drraw or any other display tool
Starting Point
- YAL-1.0 -- Download untar it and follow InstallingYAL
- n2rrd-1.4.1
- n2rrd-1.4.1.tar.gz -- Download latest release untar it and follow InstallationGuide140
- OR nagios-n2rrd-1.4.1-1.src.rpm -- Download and follow Package-Installation-guide
- OR nagios-n2rrd-1.4.1-debian-src -- Download and follow Package-Installation-guide
- n2rrd-1.4.1.tar.gz -- Download latest release untar it and follow InstallationGuide140
- n2rrd-1.4.0.tar.gz -- Download latest Stable n2rrd untar it and follow InstallationGuide140
NOTE: Read CHANGELOG and UPGRADE files under source directory for further info
- Other older versions
- To get the source from repository type "svn co http://n2rrd.diglinks.com/repos/n2rrd/tags/VERSION",
I would suggest to use SVN, cause small fixes are done immediatly.
e.g. VERSION = 1.4.0 or 1.4.1
Other Links
- Nagios to cacti interface by Detrak, derived from N2RRD N2Cacti
- Other tools that too convert performance data to RRD PNP, NagiosGraph, Perfparse
If I missed any other, please let me know..
Comments to
monitoring @ diglinks.com

