NagiosGrapher Installation, Konfiguration und Fehlersuche - netways

Einleitung Historie, FeaturesAgendahttp://www.netways.deInstallationKonfiguration Basis Regex Servicegraph, MultigraphHooks Definition am BeispielFehlersuche Typische Fehlerquellen Logging, DebuggenWeiterentwicklung Geplante Features Kontakt, Bugs, UpdatesNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deEinleitungNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deWichtigsten Features des NagiosGraphersSehr einfache Installation und Konfiguration Enfache Installation Kein Patchen von Nagios notwendig Definition pro Graph nicht pro ServiceEinfaches Handling im Webfrontend Graphen in Echtzeit Nahtlose Integration in das Nagios Webfrontend unkompliziertes WebfrontendIntegriertes RRD Backend Konfiguration der RRDs abhängig von Nagios Sehr schlankes Backend Automatisches Zusammenfassen der Werte Umfangreiche statistische und graphische FunktionenLeicht erweiterbar Integration von eigenen Änderungen über HooksNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deIntegration im Nagios WebfrontendNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deInstallationNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deInstallation Download über www.NagiosExchange.org Entpacken in beliebiges Verzeichnis Das Template System Lösen von CPAN Abhängigkeiten Skript gesteuerte Installation Konfiguration von NagiosNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deDownloadEntpackennagiosdemo:/usr/local/src# tar -xjvf NagiosGrapher-1.6-rc1.tar.bz2NagiosGrapher-1.6-rc1/NagiosGrapher-1.6-rc1/nagios_grapher.inNagiosGrapher-1.6-rc1/config.layoutNagiosGrapher-1.6-rc1/Makefile.inNagiosGrapher-1.6-rc1/collect2.pl....NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deDas Layout Systemprefix:/usr/local/nagiosnagios_config: ${prefix}/etc/nagios.cfgnagios_config_cgi: ${prefix}/etc/cgi.cfgnagios_images: ${prefix}/share/imagesnagios_images_logos: ${prefix}/share/images/logosnagios_folder_cgi: ${prefix}/sbinperl_inc:/etc/perlnagios_contribution: ${prefix}/contribng_config:${prefix}/etcng_config_sub: ${ng_config}/ngraph.dng_daemon:${prefix}/var/nagios_grapherng_srvext_file: ${prefix}/etc/serviceext.cfgng_srvext_dir: ${prefix}/etc/serviceextng_interface_pipe: ${prefix}/var/rw/ngraph.pipeng_logfile:${prefix}/var/ngraph.logng_rrd:${prefix}/var/rrdNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deNagiosGrapher ./configurenagiosdemo:/usr/local/src/NagiosGrapher­1.6­rc1# ./configure ­­with­layout=defaultchecking for a BSD­compatible install... /usr/bin/install ­cchecking for gawk... nochecking for mawk... mawkchecking for perl... /usr/bin/perlchecking for choosen layout... defaultchecking if user www­data exists... foundchecking if group www­data exists... foundconfigure: creating ./config.statusconfig.status: creating Makefileconfig.status: creating NagiosGrapher.pmconfig.status: creating nagios_grapherconfig.status: creating cfg/ngraph.ncfgNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deÜberprüfung der Abhängigkeiten von CPAN Modulennagiosdemo:/usr/local/src/NagiosGrapher-1.6-rc1# make testdeps/usr/bin/perl ./tools/testdeps.plChecking Data::Dumper ... foundChecking File::Copy ... foundChecking File::Basename ... foundChecking Carp ... foundChecking POSIX ... foundChecking Time::HiRes ... foundChecking Time::Local ... foundChecking Storable ... foundChecking GD ... not installed!Checking Image::Magick ... not installed!Checking RRDs ... not installed!Checking CGI ... foundChecking CGI::Carp ... foundChecking IO::Handle ... foundChecking URI::Escape ... foundmake: *** [testdeps] Fehler 1NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deLösen der Abhängigkeiten von CPAN Modulennagiosdemo:/usr/local/src/NagiosGrapher-1.6-rc1# make fixdeps/usr/bin/perl ./tools/testdeps.pl fixChecking Data::Dumper ... foundChecking File::Copy ... foundChecking File::Basename ... foundChecking Carp ... foundChecking POSIX ... foundChecking Time::HiRes ... foundChecking Time::Local ... foundChecking Storable ... foundChecking GD... not installed. I'll do this for you!CPAN: LWP::UserAgent loaded okFetching with LWP:ftp://cpan.noris.de/pub/CPAN/authors/01mailrc.txt.gzGoing to read /root/.cpan/sources/authors/01mailrc.txt.gzFetching with LWP:ftp://cpan.noris.de/pub/CPAN/modules/02packages.details.txt.gzGoing to read /root/.cpan/sources/modules/02packages.details.txt.gzDatabase was generated on Mon, 18 Sep 2006 02:32:50 GMTNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deSkript gesteuerte Installationnagiosdemo:/usr/local/src/NagiosGrapher-1.6-rc1# make installmkdir ­p //usr/local/nagios/etc/serviceextchown ­R nagios //usr/local/nagios/etc/serviceextmkdir ­p //usr/local/nagios/var/rrdchown ­R nagios //usr/local/nagios/var/rrdmkdir ­p //usr/local/nagios/etcmkdir ­p //usr/local/nagios/etc/ngraph.dcp cfg/ngraph.ncfg //usr/local/nagios/etccp cfg/nmgraph.ncfg //usr/local/nagios/etc/ngraph.dcp ­r cfg/templates/extra //usr/local/nagios/etc/ngraph.dcp ­r cfg/templates/standard //usr/local/nagios/etc/ngraph.dchown ­R nagios //usr/local/nagios/etc/*.ncfgchgrp ­R nagios //usr/local/nagios/etc/*.ncfgmkdir ­p //usr/local/nagios/sbincp *.cgi //usr/local/nagios/sbin....NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deWeitere notwendige Schrittenagios.cfg cfg_dir=/usr/local/nagios/etc/serviceext ergänzen process_performance_data=1 service_perfdata_command=process-service-perfdatacommand definiton define command{command_name process-service-perfdatacommand_line /usr/local/nagios/contrib/udpecho 127.0.0.1 \'$HOSTNAME$\t$SERVICEDESC$\t$SERVICEOUTPUT$\t$SERVICEPERFDATA$\n' 5667}Neustart NagiosNagiosGrapher init-Skript in Runlevel eintragen und startenNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deKonfigurationNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deBasiskonfiguration NagiosGrapher (ngraph.ncfg)define config {...# normal_check_intervalstep 300# VALUE or AUTOheartbeatauto...serviceext_typeMULTIPLE...icon_image_tag' dot.png' border="0">

http://www.netways.dePattern \d Ziffer \D keine Ziffer \w ein Wort (Buchstaben und Ziffern) \W kein Wort \s Whitespace \S kein Whitespace . ein beliebiges Zeichen \. PunktWiederholungen + mindestens einmal ? 0 oder einmal * 0 oder mehrmalsPerl RegexWeitere Wiederholungen {n} n Wiederholungen des vorausgehenden Ausdrucks {n,m} mindestens n aber nicht mehr als m Wiederholungen des vorausgehendenAusdrucks {n,} mindestens n Wiederholungen des vorausgehenden AusdrucksNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deDefinition Servicegraph (einfaches Beispiel)Plugin Output:5min cpu OK - 14 %Graph Definition:define ngraph{service_namesw­cpugraph_log_regex­ (\d+)graph_valueCPUgraph_units %graph_legendCPU usagerrd_plottypeAREArrd_color00A348pageCPU}NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deServicegraph (einfaches Beispiel)NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deServicegraph mit Berechnung (CDEFs)define ngraph{service_name lx­mailqgraph_perf_regex mailq=(\d+)graph_value mailqgraph_units mailsgraph_legend size of mailqrrd_plottype AREArrd_color6699FF}define ngraph{service_name lx­mailqtypeCDEFgraph_value cdef_mailqgraph_calcmailqrrd_plottype LINE1rrd_color 000000}Plugin PerfData:mailq=368NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deServicegraph mit BerechnungNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.dedefine ngraph{service_namegraph_perf_regexgraph_valuegraph_unitsgraph_legendhide}define ngraph{service_nametypegraph_valuegraph_calcrrd_plottyperrd_color}Servicegraph mit Berechnung (CDEFs)transferinbytes=(\d+)inbytesbytesincoming bytesyesinbytesCDEFcdef_inbitsinbytes,8,*AREA6699FFPlugin PerfData:inbytes=1548NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deWeitere mögliche Elemente bei ServicegraphenCDEFBerechnete WerteVDEF„Extrem“ Werte (Max,Min, Avg, Last, ...)GPRINTKommentare inkl. „Extrem Wert“TICKvertikale LinieHRULEhorizontale LinienVRULEvertikale LinienCOMMENTKommentareNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deWeitere mögliche Elemente bei ServicegraphenTICKVRULEVDEF/HRULEGPRINTCOMMENTNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deWeitere mögliche Elemente bei ServicegraphenVDEFdefine {graph_calcgraph_legendgraph_valuerrd_colorrrd_plottypeservice_nametype}temperature,AVERAGEavg tempavg_tempFF0000LINE1tempVDEFNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deWeitere mögliche Elemente bei ServicegraphenGPRINTdefine {print_descriptionprint_eolprint_formatprint_functionprint_sourceservice_nametype}left%2.2lf CAVERAGEtemperaturetempGPRINTNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deWeitere mögliche Elemente bei ServicegraphenTICKdefine {graph_calctemperaturegraph_legendrrd_color 000000service_name temptick_fraction 0.1typeTICK}NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deVRULEWeitere mögliche Elemente bei Servicegraphendefine {vrule_value [Zeitstempel]rrd_color FF0000service_name temptypeVRULE} HRULEdefine {Hrule_value Wertrrd_color FF0000service_name temptypeVRULE}NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deWeitere mögliche Elemente bei ServicegraphenCOMMENTdefine {print_descriptionprint_eolservice_nametype}justifytempCOMMENTdefine {print_description measured by TempTrax E4print_eoljustifyservice_name temptypeCOMMENT}NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deDefinition Multigraphdefine nmgraph{host_nameservice_namehostsservicesgraph_type}stf­lbcmg lx­apache­requests^stf­applx­apache­requestsline1NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deMultigraphNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deHooksNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deDefinition NagiosGrapher HooksMit NagiosGrapher Hooks kann der NagiosGrapherindividuell angepasst werden ohne, dassder Source gepatcht werden mussbei Updates darauf geachtet werden mussNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deTypische 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 ...NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deKonfiguration NagiosGrapher Hook nagios.cfglog_level 511# All hooks before an srvext entry is createdhooks_serviceextNagiosGrapher::Hooks::ServExtNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deGrundgerüst NagiosGrapher Hookpackage NagiosGrapher::Hooks::ServExt;use NagiosGrapher::Hooks::Generic;sub init {#...}sub prepare {#...}sub commit {#...}sub cleanup {#...}NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deNagiosGrapher Hook am Beispiel (1)NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deNagiosGrapher Hook am Beispiel (2)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(@_);NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deNagiosGrapher Hook am Beispiel (3)sub prepare {my $self = shift;use Data::Dumper;}return 1;NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deNagiosGrapher Hook am Beispiel (4)sub commit {my $self = shift;my $values = $self->Values;if ($self->Service =~ m/eventdb\s*(.*)/i) {my $regex = $1;$regex =~ s/ /\+/g;${$self->{Values}->{"icon_image"}}.='border="0">'.'

http://www.netways.deNagiosGrapher Hook am Beispiel (5)sub cleanup {my $self = shift;}return 1;1;NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deFehlersucheNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deTypische FehlerquellenGenerelle Fehler Fehler: NagiosGrapher bekommt keinerlei Werte PerformanceData nicht aktiviert Command nicht vorhanden Fehler: RRDs werden nicht angelegt Alte Version der RRDToolsFehler 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 ServiceextNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deLoggingEinstellung in ngraph.ncfgLoglevellog_file /usr/local/nagios/var/ngraph.loglog_level 511 1 2 4 8 16 32 64 128 256erkannte Services und deren Wertenicht erkannte WerteProgramm StatusServiceextRRD StatusPipe InputRegexConfigHooksNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deDebuggenngraph.logPIPE: nethq­vpn2rz net­ping PING OK ­ Packet loss = 0%, RTA = 95.90 msREGEX: 2 blocks for 'net­ping' found.REGEX: graph_value=LossREGEX: output=plugin.REGEX: regex=m/loss = (\d+)/iREGEX: perfdata=ping ok ­ packet loss = 0%, rta = 95.90 msREGEX: match=0REGEX: graph_value=RTAREGEX: output=plugin.REGEX: regex=m/RTA = (\d+\.+\d+) ms/iREGEX: perfdata=ping ok ­ packet loss = 0%, rta = 95.90 msREGEX: match=95.90VALUES: [nethq­vpn2rz][net­ping]: RTA=95.90 Loss=0RRD: rrdtool update /var...rrd ­­template=RTA:Loss N:95.9 0:0NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deWeiterentwicklungNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deGeplante Features Stable Releaseendlich FeaturefreezeVerbesserter Installer mit nochmehr LayoutsTemplate DatenbankHook Beispiele NagiosGrapher V. 2NDO => SQL TriggerNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deUser helfen UserNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deKontakt zu unsNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deBugsNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deUpdates In Zukunft werden Updates besser getestet kleinere Schritte per Skript installierbar Veröffentlichung über NagiosExchange SourceForgeNETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deweitere Fragen?NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de

http://www.netways.deHerzlichen Dank!NETWAYS GmbH Deutschherrnstr. 47a 90429 Nürnberg Tel: 0911/92885-0 info@netways.de