Nagios Conference 2006 | Automatisierung von Performancecharts mit dem NagiosGrapher

NETWAYS GmbH  Deutschherrnstr. 47a  90429 Nürnberg  Tel: 0911/92885-0  info@netways.de
http://www.netways.de
NagiosGrapher
Installation, Konfiguration und Fehlersuche
Gerd Müller
NETWAYS GmbH

Agenda
 Einleitung
 Historie, Features
 Installation
 Konfiguration
 Basis
 Regex
 Servicegraph, Multigraph
 Hooks
 Definition
 am Beispiel
 Fehlersuche
 Typische Fehlerquellen
 Logging, Debuggen
 Weiterentwicklung
 Geplante Features
 Kontakt, Bugs,
 Updates

Einleitung

Charts mit Nagios
 APAN (Advanced Performance Addon for Nagios)
 + RRD Backend
 + Graphen in Echtzeit
 + Direkte Integration in das Nagios Webfrontend
 - Aufwändige Konfiguration
 - Patchen von Nagios notwendig
 CACTI
 + RRD Backend
 + sehr flexibel
 - Aufwändige Konfiguration
 - keine direkte Integration in das Nagios Webfrontend
 PerfParse
 + Sehr flexibel
 - abhängig von PerformanceData
 - Mysql Backend
 - keine direkte Integration in das Nagios Webfrontend

Wichtigsten Features des NagiosGraphers
 Sehr einfache Installation und Konfiguration
 Enfache Installation
 Kein Patchen von Nagios notwendig
 Definition pro Graph nicht pro Service
 Einfaches Handling im Webfrontend
 Graphen in Echtzeit
 Nahtlose Integration in das Nagios Webfrontend
 unkompliziertes Webfrontend
 Integriertes RRD Backend
 Konfiguration der RRDs abhängig von Nagios
 Sehr schlankes Backend
 Automatisches Zusammenfassen der Werte
 Umfangreiche statistische und graphische Funktionen
 Leicht erweiterbar
 Integration von eigenen Änderungen über Hooks

Integration im Nagios Webfrontend

Einfaches Webinterface

Installation

Installation
 Download über www.NagiosExchange.org
 Entpacken in beliebiges Verzeichnis
 Das Template System
 Lösen von CPAN Abhängigkeiten
 Skript gesteuerte Installation
 Konfiguration von Nagios

Download
Entpacken
nagiosdemo:/usr/local/src# tar -xjvf NagiosGrapher-1.6-rc1.tar.bz2
NagiosGrapher-1.6-rc1/
NagiosGrapher-1.6-rc1/nagios_grapher.in
NagiosGrapher-1.6-rc1/config.layout
NagiosGrapher-1.6-rc1/Makefile.in
NagiosGrapher-1.6-rc1/collect2.pl
....

Das Layout System
<Layout default>
  prefix:               /usr/local/nagios
  nagios_config:        ${prefix}/etc/nagios.cfg
  nagios_config_cgi:    ${prefix}/etc/cgi.cfg
  nagios_images:        ${prefix}/share/images
  nagios_images_logos:  ${prefix}/share/images/logos
  nagios_folder_cgi:    ${prefix}/sbin
  perl_inc:             /etc/perl
  nagios_contribution:  ${prefix}/contrib
  ng_config:            ${prefix}/etc
  ng_config_sub:        ${ng_config}/ngraph.d
  ng_daemon:            ${prefix}/var/nagios_grapher
  ng_srvext_file:       ${prefix}/etc/serviceext.cfg
  ng_srvext_dir:        ${prefix}/etc/serviceext
  ng_interface_pipe:    ${prefix}/var/rw/ngraph.pipe
  ng_logfile:           ${prefix}/var/ngraph.log
  ng_rrd:               ${prefix}/var/rrd
</Layout>

NagiosGrapher ./configure
nagiosdemo:/usr/local/src/NagiosGrapher1.6rc1# ./configure withlayout=default
checking for a BSDcompatible install... /usr/bin/install c
checking for gawk... no
checking for mawk... mawk
checking for perl... /usr/bin/perl
checking for choosen layout... default
checking if user wwwdata exists... found
checking if group wwwdata exists... found
configure: creating ./config.status
config.status: creating Makefile
config.status: creating NagiosGrapher.pm
config.status: creating nagios_grapher
config.status: creating cfg/ngraph.ncfg

Überprüfung der Abhängigkeiten von CPAN Modulen
nagiosdemo:/usr/local/src/NagiosGrapher-1.6-rc1# make testdeps
/usr/bin/perl ./tools/testdeps.pl
Checking Data::Dumper ... found
Checking File::Copy ... found
Checking File::Basename ... found
Checking Carp ... found
Checking POSIX ... found
Checking Time::HiRes ... found
Checking Time::Local ... found
Checking Storable ... found
Checking GD ... not installed!
Checking Image::Magick ... not installed!
Checking RRDs ... not installed!
Checking CGI ... found
Checking CGI::Carp ... found
Checking IO::Handle ... found
Checking URI::Escape ... found
make: *** [testdeps] Fehler 1

Lösen der Abhängigkeiten von CPAN Modulen
nagiosdemo:/usr/local/src/NagiosGrapher-1.6-rc1# make fixdeps
/usr/bin/perl ./tools/testdeps.pl fix
Checking Data::Dumper ... found
Checking File::Copy ... found
Checking File::Basename ... found
Checking Carp ... found
Checking POSIX ... found
Checking Time::HiRes ... found
Checking Time::Local ... found
Checking Storable ... found
Checking GD... not installed. I'll do this for you!
CPAN: LWP::UserAgent loaded ok
Fetching with LWP:
  ftp://cpan.noris.de/pub/CPAN/authors/01mailrc.txt.gz
Going to read /root/.cpan/sources/authors/01mailrc.txt.gz
Fetching with LWP:
  ftp://cpan.noris.de/pub/CPAN/modules/02packages.details.txt.gz
Going to read /root/.cpan/sources/modules/02packages.details.txt.gz
  Database was generated on Mon, 18 Sep 2006 02:32:50 GMT

Skript gesteuerte Installation
nagiosdemo:/usr/local/src/NagiosGrapher-1.6-rc1# make install
mkdir p //usr/local/nagios/etc/serviceext
chown R nagios //usr/local/nagios/etc/serviceext
mkdir p //usr/local/nagios/var/rrd
chown R nagios //usr/local/nagios/var/rrd
mkdir p //usr/local/nagios/etc
mkdir p //usr/local/nagios/etc/ngraph.d
cp cfg/ngraph.ncfg //usr/local/nagios/etc
cp cfg/nmgraph.ncfg //usr/local/nagios/etc/ngraph.d
cp r cfg/templates/extra //usr/local/nagios/etc/ngraph.d
cp r cfg/templates/standard //usr/local/nagios/etc/ngraph.d
chown R nagios //usr/local/nagios/etc/*.ncfg
chgrp R nagios //usr/local/nagios/etc/*.ncfg
mkdir p //usr/local/nagios/sbin
cp *.cgi //usr/local/nagios/sbin
....

Weitere notwendige Schritte
 nagios.cfg
 cfg_dir=/usr/local/nagios/etc/serviceext ergänzen
 process_performance_data=1
 service_perfdata_command=process-service-perfdata
 command definiton
 define command{
command_name process-service-perfdata
command_line /usr/local/nagios/contrib/udpecho 127.0.0.1
'$HOSTNAME$t$SERVICEDESC$t$SERVICEOUTPUT$t$SERVICEPERFDATA$n' 5667
}
 Neustart Nagios
 NagiosGrapher init-Skript in Runlevel eintragen und starten

Konfiguration

Basiskonfiguration NagiosGrapher (ngraph.ncfg)
define config {
        ...
        # normal_check_interval
        step                     300
        # VALUE or AUTO
        heartbeat                auto
        ...
        serviceext_type          MULTIPLE
    ...
        icon_image_tag          ' dot.png' border="0"></a><A TARGET="_blank"
HREF="graphs.cgi?###URL###"><img src='###IMAGESRC###' '
       ...
        log_file                 /usr/local/nagios/var/ngraph.log
        log_level                511
        ...
        icon_image_static          no
   ...
        rrd_color*
   fe_use_browser*
   ...
   use_authentication         yes
   ...
}
cfg_dir=/usr/local/nagios/etc/ngraph.d

Perl Regex
 Pattern
 d Ziffer
 D keine Ziffer
 w ein Wort (Buchstaben und Ziffern)
 W kein Wort
 s Whitespace
 S kein Whitespace
 . ein beliebiges Zeichen
 . Punkt
 Wiederholungen
 + mindestens einmal
 ? 0 oder einmal
 * 0 oder mehrmals
 Weitere Wiederholungen
 {n} n Wiederholungen des vorausgehenden Ausdrucks
 {n,m} mindestens n aber nicht mehr als m Wiederholungen des vorausgehenden
Ausdrucks
 {n,} mindestens n Wiederholungen des vorausgehenden Ausdrucks

Definition Servicegraph (einfaches Beispiel)
Graph Definition:
define ngraph{
        service_name             swcpu
        graph_log_regex        (d+)
        graph_value               CPU
        graph_units               %
        graph_legend            CPU usage
        rrd_plottype        AREA
        rrd_color                 00A348
        page                      CPU
        }
Plugin Output:
5min cpu OK - 14 %

Servicegraph (einfaches Beispiel)

Servicegraph mit Berechnung (CDEFs)
define ngraph{
service_name       lxmailq
graph_perf_regex   mailq=(d+)
graph_value        mailq
graph_units        mails
graph_legend size of mailq
    rrd_plottype      AREA
    rrd_color         6699FF
}
define ngraph{
    service_name   lxmailq
    type           CDEF
    graph_value    cdef_mailq
    graph_calc     mailq
    rrd_plottype   LINE1
    rrd_color      000000
}
Plugin PerfData:
mailq=368

Servicegraph mit Berechnung

Servicegraph mit Berechnung (CDEFs)
define ngraph{
service_name       transfer
graph_perf_regex   inbytes=(d+)
graph_value        inbytes
graph_units        bytes
graph_legend incoming bytes
hide yes
}
define ngraph{
    service_name   inbytes
    type           CDEF
    graph_value    cdef_inbits
    graph_calc     inbytes,8,*
    rrd_plottype      AREA
    rrd_color         6699FF
}
Plugin PerfData:
inbytes=1548

Weitere mögliche Elemente bei Servicegraphen
 CDEF
Berechnete Werte
 VDEF
„Extrem“ Werte (Max,Min, Avg, Last, ...)
 GPRINT
Kommentare inkl. „Extrem Wert“
 TICK
vertikale Linie
 HRULE
horizontale Linien
 VRULE
vertikale Linien
 COMMENT
Kommentare

 TICK
 VRULE
 VDEF/HRULE
 GPRINT
 COMMENT

 VDEF
define {
     graph_calc   temperature,AVERAGE
     graph_legend   avg temp
     graph_value   avg_temp
     rrd_color   FF0000
     rrd_plottype   LINE1
     service_name   temp
     type   VDEF
}

 GPRINT
define {
     print_description
     print_eol   left
     print_format   %2.2lf C
     print_function   AVERAGE
     print_source   temperature
     service_name   temp
     type   GPRINT
}

 TICK
define {
     graph_calc   temperature
     graph_legend
     rrd_color    000000
  service_name   temp
     tick_fraction   0.1
     type   TICK
}

 VRULE
define {
     vrule_value [Zeitstempel]
     rrd_color    FF0000
  service_name   temp
     type   VRULE
}
 HRULE
define {
     Hrule_value Wert
     rrd_color    FF0000
  service_name   temp
     type   VRULE
}

 COMMENT
define {
     print_description
     print_eol   justify
     service_name   temp
     type   COMMENT
  }

  define {
     print_description  measured by TempTrax E4
     print_eol   justify
     service_name   temp
     type   COMMENT
  }

Definition Multigraph
define nmgraph{
        host_name               stflbc
        service_name            mg lxapacherequests
        hosts                   ^stfapp
        services                lxapacherequests
        graph_type              line1
}

Multigraph

Hooks

Definition NagiosGrapher Hooks
Mit NagiosGrapher Hooks kann der NagiosGrapher
individuell angepasst werden ohne, dass
der Source gepatcht werden muss
bei Updates darauf geachtet werden muss

Typische Anwendungen für NagiosGrapher Hooks
 Vor dem Updaten des RRD Files
 Speicherung der Werte in einer Datenbank
 Verändern der Werte
 Vor dem Erstellen des Serviceext Eintrags
 Veränderung des Logos
 Ergänzung um weitere Logos
 Unterdrücken der Erstellung
 ...

Konfiguration NagiosGrapher Hook
 nagios.cfg
log_level 511
# All hooks before an srvext entry is created
hooks_serviceext NagiosGrapher::Hooks::ServExt

Grundgerüst NagiosGrapher Hook
package NagiosGrapher::Hooks::ServExt;
use NagiosGrapher::Hooks::Generic;
sub init {
#...
}
sub prepare {
#...
}
sub commit {
#...
}
sub cleanup {
#...
}

NagiosGrapher Hook am Beispiel (1)

package NagiosGrapher::Hooks::ServExt;
use NagiosGrapher::Hooks::Generic;
use vars qw (
@ISA
);
@ISA = ('NagiosGrapher::Hooks::Generic');
sub init {
$self = shift;
$self->SetTypes ('before_serviceext');
return $self->SUPER::init(@_);
}

sub prepare {
my $self = shift;
use Data::Dumper;
return 1;
}

sub commit {
my $self = shift;
my $values = $self->Values;
if ($self->Service =~ m/eventdbs*(.*)/i) {
my $regex = $1;
$regex =~ s/ /+/g;
${$self->{Values}->{"icon_image"}}.=
'border="0"></a><A TARGET="_blank"'.
' HREF="/nagios/eventdb/index.php?host[]='.
$self->Host.
'&regexp='.$regex.'">'.
'<img src='/nagios/images/logos/syslog.png' ';
}
return 1;
}

sub cleanup {
my $self = shift;
return 1;
}
1;

Fehlersuche

Typische Fehlerquellen
 Generelle Fehler
 Fehler: NagiosGrapher bekommt keinerlei Werte
 PerformanceData nicht aktiviert
 Command nicht vorhanden
 Fehler: RRDs werden nicht angelegt
 Alte Version der RRDTools
 Fehler bei der Servicedefinition
 Fehler: Wert wird nicht oder nicht richtig erkannt bzw. kein Graph wird angezeigt
 Klammern nicht escaped in der Regex
 Pattern einstellig nicht mehrstellig - „+“ fehlt
 Vorzeichen fehlt
 graph value nicht eindeutig je Serivce
 Regex nicht PluginOutput sondern PerfData oder umgekehrt
 Servicename trifft auf verschiedene Graph Definitionen zu
 Fehler: NagiosGrapher Logo erscheint nicht im Webfrontend von Nagios
 serviceext Verzeichnis nicht innerhalb der cfg_dirs von Nagios
 Kein Reload von Nagios nach dem Erstellen der Serviceext

Logging
 Einstellung in ngraph.ncfg
log_file /usr/local/nagios/var/ngraph.log
log_level 511
 Loglevel
 1 erkannte Services und deren Werte
 2 nicht erkannte Werte
 4 Programm Status
 8 Serviceext
 16 RRD Status
 32 Pipe Input
 64 Regex
 128 Config
 256 Hooks

Debuggen
 ngraph.log
PIPE: nethqvpn2rz netping PING OK Packet loss = 0%, RTA = 95.90 ms
REGEX: 2 blocks for 'netping' found.
REGEX: graph_value=Loss
REGEX: output=plugin.
REGEX: regex=m/loss = (d+)/i
REGEX: perfdata=ping ok packet loss = 0%, rta = 95.90 ms
REGEX: match=0
REGEX: graph_value=RTA
REGEX: output=plugin.
REGEX: regex=m/RTA = (d+.+d+) ms/i
REGEX: perfdata=ping ok packet loss = 0%, rta = 95.90 ms
REGEX: match=95.90
VALUES: [nethqvpn2rz][netping]: RTA=95.90 Loss=0
RRD: rrdtool update /var...rrd template=RTA:Loss N:95.9 0:0

Weiterentwicklung

Geplante Features
 Stable Release
endlich Featurefreeze
Verbesserter Installer mit noch
mehr Layouts
Template Datenbank
Hook Beispiele
 NagiosGrapher V. 2
NDO => SQL Trigger

User helfen User

Kontakt zu uns

Bugs

Updates
 In Zukunft werden Updates
 besser getestet
 kleinere Schritte
 per Skript installierbar
 Veröffentlichung über
 NagiosExchange
 SourceForge

weitere Fragen?

Herzlichen Dank!

Nagios Conference 2006 | Automatisierung von Performancecharts mit dem NagiosGrapher

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Ähnlich wie Nagios Conference 2006 | Automatisierung von Performancecharts mit dem NagiosGrapher

Ähnlich wie Nagios Conference 2006 | Automatisierung von Performancecharts mit dem NagiosGrapher (20)

Nagios Conference 2006 | Automatisierung von Performancecharts mit dem NagiosGrapher