rrd2graph installation/configuration

Workflow

The following image displays RRD2GRAPH workflow.   Download Workflow Image

edit rrd2graph.cgi and change following variables

cp rrd2graph.cgi to your cgi-bin directory

• cp rrd2graph.cgi /srv/www/vhosts/www.example.com/cgi-bin
• chmod 755 /srv/www/vhosts/www.example.com/cgi-bin/rrd2graph.cgi

Edit n2rrd.conf and change the following values appropriately

Create graph templates

• create graph template "/etc/n2rrd/templates/graph/mem.t" for "Physical memory"

• create graph template "/etc/n2rrd/templates/graph/icmp.t" for "icmp"

  an Example output:

Edit nagios configuration file serviceextinfo.cfg

• check_icmp

• Physical memory

  (3.x users)_above mentioned notes_url and action_url are part of host and service definition attributes, which basically means you don't have to maintain another configuration file.

Reload Nagios

• Now you would see icons near service description, click on it to see the graph

if DYN_RRA_CREATE is enabled

• dynamically crated RRA templates are kept under "*/templates/rra/dyn"
• dynamically created GRAPH templates are kept under "*/template/graph/dyn"

Enable or Disable Summary All link in graphs

Use config option in n2rrd.conf GRAPH_SUMMARY_ALL_LINK = 0/1

Enable or Diable DS Summary All links in graph

Use config option in n2rrd.conf DS_SUMMARY_ALL_LINK = 0/1

Create rounded corners with CSS and RRD graph template

apart from rrd2graph.css, you need to make changes to

Sample RRD graph template entry (icmp.t)

/usr/share/nagios/stylesheets/*.css entries

also depends on web frontend you are using

Other hints

• In Nagios 3.x you can disable EPN through configuration enable_embedded_perl=<0/1>

TIPS

1. starting 1.4.0, if you eable option DYN_RRD_CREATE, then you can avoid creating RRA/GRAPH templates and once you see all performance data are created, then you can decide if you like to create custome RRA/GRAPH templates.

2. I use two different generic templates for services, this way you can avoid maintaining seperate file for notes_url.

Known problems/issues

• check n2rrd.pl and rrd2graph.cgi if they complain
  • perl -cw PATH/n2rrd.pl
  • perl -cw PATH/rrd2graph.cgi

• check for file permissions
  • n2rdd.plruns with nagios user permissions:
    • can read/write RRA templates directory (normally under /etc/n2rrd/templates/rra)
    • can read status.log
    • can write to n2rrd.log
  • rrd2graph.cgiruns with webserver user permissions:
    • check that it can write to CACHE_DIR
    • can read status.log
    • can write to n2rrd.log
    • can read/write template/graph directory (normally under /etc/n2rrd/templates/graph)

• In case you are not seeing Nagios environment variables, then could be that nagios is compiled with EPN (Embeded Perl)
  • Diable EPN see Nagios docs for details on EPN
  • In nagios 3.x a comment # nagios: -epn in your script should disable EPN.

• n2rdd.pl/rrd2graph.cgi leaves deleted service files, which needs to be removed manually

  • alternatively you can add a cronjobto automatically remove unused rra files and cached images

comments to

monitoring @ diglinks.com