12.2. Nagios

12.2.1. Installation

I beskrivelsen her er valgt at installere fra grundpakken og ikke bruge et pakkeformat der passer til en specifik distribution. Grundinstallationen er baseret på BSD's måde at placere filerne på, så det er en værre rodebunke at hitte rundt i, når man er vant til Linux. Herunder er vist en måde som filerne kan lægges ud på. Vigtigst er det at du kan finde konfigurationsfilerne i /etc/nagios, men de andre subdir er nu også rare at vide hvor ligger. Kør først en configure, efterfulgt af make og make fullinstall.

[tyge@hven ~]$ [ -z "`grep ^nagios: /etc/group`" ] && groupadd nagios
[tyge@hven ~]$ [ -z "`grep ^nagios: /etc/passwd`" ] && useradd -c "Nagios" -g nagios -d /var/www/nagios/html -s /bin/bash nagios
[tyge@hven ~]$ cd nagios-2.0
[tyge@hven nagios-2.0]$ ./configure \
        --sysconfdir=/etc/nagios \
        --bindir=/usr/bin \
        --libexecdir=/usr/libexec/nagios \
        --sbindir=/var/www/nagios/cgi-bin \
        --datadir=/var/www/nagios/html \
        --localstatedir=/var/nagios \
        --with-htmurl=/nagios \
        --with-cgiurl=/nagios/cgi-bin
[tyge@hven nagios-2.0]$ make all
[tyge@hven nagios-2.0]$ mkdir -p /var/www/nagios/html
[tyge@hven nagios-2.0]$ su -c "make fullinstall"

nagios-plugins er en særskilt programpakke der skal downloades. Den indeholder alle de check-programmer Nagios-dæmonen skal bruge, og uden nagios-plugins virker Nagios slet ikke. Hent programpakken (Afsnit 12.2.5) og installer pakken som angivet herunder:

[tyge@hven ~]$ cd nagios-plugins-1.4.3
[tyge@hven nagios-plugins-1.4.3]$ ./configure \
        --with-cgiurl=/var/www/nagios/cgi-bin
[tyge@hven nagios-plugins-1.4.3]$ make
[tyge@hven nagios-plugins-1.4.3]$ su -c "make install"

Med de mest basale programmer installeret, mangler der nu et færdigt opsat eksempel du kan bruge som udgangspunkt. Det er beskrevet i næste afsnit.

12.2.2. Konfiguration

Nu mangler der et færdigt opsat eksempel. Der følger en smule med nagios-pakken, men det er ikke helt nok til at komme i luften med. For at kunne bruge eksemplet der følger med Nagios, skal der rettes så mange ting at det mindst vil tage dig 6 timer at komme frem til mål. Hent defor den færdige pakke fra http://cvs.linuxbog.dk/admin/eksempler/etc-nagios.tar.gz og stil dig i roden af din disk og pak den ud. Filerne vil lægge sig i /etc/nagios. Filerne kan også hentes enkeltvis og browses på http://www.linuxbog.dk/admin/eksempler/etc/nagios/

Når filerne er pakket ud er det vigtigt at få sat password til brugeren nagios. Det er den bruger som skal kunne logge ind via web-siden. Du kan tilføje alle de brugere du har behov for. Det gøres med programmet htpasswd2 når det er Apache 2.0 du har installeret, ellers er det htpasswd. Gør som nedenstående eksempel:

[nagios@hven ~]$ cd /etc/nagios
[nagios@hven nagios]$ htpasswd2 htpasswd.users nagios
New password:
Re-type new password:
Updating password for user nagios

Når password til nagios-brugeren er sat kan Nagios-dæmonen startes, og den nye konfiguration til Apache webserveren kan loades.

[root@hven ~]# /etc/init.d/nagios start

Nu er Nagios dæmonen startet og indsamling af data er begyndt. Næste trin er så at kunne se de indsamlede data. Det forventes at du har Apache-webserveren installeret, og har nogenlunde styr på at administrerer den. Det nemmeste er hvis du vil tilgå Nagios via http://localhost/nagios for så kan du nøjes med at inkludere sample-config/httpd.conf der ligger i filstrukturen under source nagios-pakken. Bruger du Gentoo er det nemmest blot at kopiere filen ned i filnavnet /etc/apache2/modules.d/99_nagios.conf (eller brug et andet nummer der er lavere end 99). Ved andre Linux-distributioner er det nok nemmest at kopiere sample-config/httpd.conf til /etc/nagios/ og så gå ind i din httpd.conf der hører til Apache og i bunden skrive Include /etc/nagios/httpd.conf . Når den config-fil der hører til Nagios er blevet inkluderet, er det blot at få den loadet ind i Apache. Det gøre evt. med følgende kommando:

[root@hven ~]# /etc/init.d/apache reload

Nu kan du klikke dig ind på http://localhost/nagios/ og se status for den maskine som Nagios er installeret på. Klik på service detail. Måske er der nogle service-check der lige står til "Pending", men så vent lige et par minutter, så kommer status også for disse. Som udgangspunkt viser eksemplerne der hører til "Friheden til at vælge" status for localhost og cvs.sslug.dk . For at rette det, skal der rettes i konfigurationsfilerne der ligger i /etc/nagios/*.cfg . Da der skal rettes i flere filer, kan man jo være fræk at gøre det fra kommandolinjen. Hvis du fx vil rette localhost til hven.sslug.dk, og du vil rette ip-nummer fra 127.0.0.1 til 80.80.80.80, så kan det gøres med:

[nagios@hven ~]$ cd /etc/nagios
[nagios@hven nagios]$ grep localhost *.cfg   # her ser du hvilke filer det er
[nagios@hven nagios]$ perl -i -pe 's/localhost/hven.sslug.dk/g' *.cfg
[nagios@hven nagios]$ perl -i -pe 's/127.0.0.1/80.80.80.80/g' *.cfg

12.2.3. Ændre konfiguration

Inden du kaster dig over at tilrette konfigurationsfilerne manuelt med en editor, skal du vide at der er indtil flere forskellige tredjeparts systemer der er beregnet for konfiguration via en GUI. En del af dem er baseret på PHP og MySQL, og nedarver selvklart de relationer der i forvejen er imellem Nagios' konfigurationsfiler. Download tredjepartsprogrammerne fra Afsnit 12.2.5.

Som udgangspunkt er konfigurationen fordelt på flere filer ved at der er refereret til dem fra nagios.cfg . Nogle gange vil man finde det irreterende at skulle åbne flere filer for at lave en ændring, men så er muligheden at man kan samle det hele i en fil. Det der handler om host og service har man ofte fat i, så det kan være en fordel at have dem i samme fil. Den måde som filerne kommer som standard er følgende:

1. services.cfg indeholder alle de services der skal overvåges på alle maskiner. De services der overvåges i eksemplet her, er dem som de fleste vil forvente er startet.

2. hosts.cfg indeholder en liste over alle de maskiner der skal overvåges. Her i eksemplet er det kun localhost og cvs.sslug.dk der er sat op til at blive overvåget. Det er så meningen at du skal gå ind og lave en søg-og-erstat af de to hostnavne, og sætte dine egne navne ind.

3. hostgroups.cfg er listen på alle de grupper af maskiner du har. De fleste har nok så få maskiner at de kun har én gruppe, men det er nemt at lave en gruppe mere.

4. contacts.cfg er listen over de personer der skal have tilsendt en mail, når der er noget galt.

5. contactgroups.cfg indeholder listen af de grupper der skal have sendt en mail, når der er noget galt. Når en service fejler, så er det gruppen der sendes en mail til. Det gør det nemmere at administrerer mange brugere samtidigt.

6. servicegroups.cfg er ikke så vigtig at have med til at starte med. Den giver fx et godt overblik af alle webservere, men på alle maskiner.

7. checkcommands.cfg indeholder listen over alle de kommandoer man kan bruge til at checke med i Nagios.

8. nagios.cfg er hoved konfigurationsfilen. Det er typisk en man kun vil rette i under installation, eller hvis skal tilføje meget avancerede funktioner. Som udgangspunkt skal du nok ikke rette i denne.

De resterende konfigurationsfiler er til mere avanceret opsætning og er ikke beskrevet her.

En ting der er fælles for den måde konfigurationsfilerne er opbygget på i Nagios, er at man definere først en standardindstilling, som man så efterfølgende bruger som basis for de andre definitioner. Har man kun et ganske lille system, der kun overvåges af ganske få systemadministratore, så vil man nok kun definere en gruppe der får tilsendt mail når noget går galt. Her vil man så i filen /etc/nagios/services.cfg øverst definere en template/objektklasse der indeholder navnet på den gruppe der skal have en mail tilsendt. Det er "contact_groups" der får tilsendt mail. Det kunne se ud som nedenstående:

define service{
        name            generic-service # navn på definitionen
        register        0               # angiver at det kun er en default
        contact_groups  admins          # eksempel på noget der nedarves
        ... flere definitioner følger
        }

Der vil typisk være flere definitioner end vist herover. Det er blot beskrevet minimalt her, for at forklare princippet. Det man nu kan gøre med "generic-service" definitionen er at bruge den i alle de services man skal have defineret.

define service{
        use                     generic-service # nedarv fra definition
        host_name               foo.eksempel.dk # navn på host
        service_description     HTTP            # navn på service
        check_command           check_http      # kommando der tjekker service
        }

Ved et bruge ovenstående princip, kan man så i mange tilfælde definere en service med kun fire konfigurationslinjer. Får man brug for enkelte undtagelser, kan man så blot skrive det ind ved den service. Som eksempel kunne man forestille sig at webadministratorerne også skulle havee at vide hvis der er noget galt med HTTP. Ved så at indskrive contact_groups igen, overskrives den forgående definition. I Nagios skrives lister adskilt med komma.

define service{
        use                     generic-service # nedarv fra definition
        host_name               foo.eksempel.dk # navn på host
        service_description     HTTP            # navn på service
        check_command           check_http      # kommando der tjekker service
        contact_groups          admins,webmasters
        }

En ting der er god at huske efter man har lavet om på konfigurationen, er lige at køre et check om det man har lavet nu er rigtigt. Det gøres med kommandoen:

[tyge@hven ~]$ /usr/bin/nagios -v /etc/nagios/nagios.cfg

Herfter får man listet alle de fejl der måtte være og man kan gå igang med at rette dem.

Er der en check-kommando der driller, kan man altid prøve dem af fra kommandolinjen. En af de check-kommandoer der kan give underlige svar, er fx check_http_string. Den bruges til at undersøge om en hjemmeside indeholder en bestemt tekst. Det kunne være en tekst far en database, eller andet der indikere at mange af de services der skal fungere på en hjemmeside, er til stede. For at vide hvad programmet rigtigt hedder, må det findes i /etc/nagios/checkcommands.cfg og finde check_http_string. Her kan man se at programmet blot er check_http med en ekstra option. Definitionen ser således ud:

# 'check_http_string' command definition
define command{
    command_name    check_http_string
    command_line    $USER1$/check_http -H $ARG1$ -w $ARG2$ -c $ARG3$ -s "$ARG4$"
    }

Hjælp til brug af check-kommandoerne fås alle ved option '-h'. '-s' bruges til at undersøge om en bestemt tekst forekommer. Nogle hjemmesider checker for hvilket sprog brugeren foretrækker, og her vil check-kommandoen spørge som default sprog, hvilket typisk er engelsk. Hvis man checker hjemmesiden med en browser, står der måske "Velkommen", men med check_http vil der stå "Welcome". På skærmen kunne det se således ud:

[tyge@hven ~]$ cd /usr/libexec/nagios
[tyge@hven /usr/libexec/nagios]$ ./check_http -H www.eksempel.dk -w 5 -c 10 -s "Velkommen"
HTTP CRITICAL: string not found|time=  0.020
[tyge@hven /usr/libexec/nagios]$ ./check_http -H www.eksempel.dk -w 5 -c 10 -s "Welcome"
HTTP ok: HTTP/1.1 200 OK -   0.020 second response time |time=  0.020

define service{
        use                     generic-service
        host_name               localhost
        service_description     HTTP
        check_command           check_http
        }

define service{
        use                     generic-service
        host_name               * ; Alle hosts får en ping
        service_description     PING
        check_command           check_ping!100.0,20%!500.0,60%
        }

define host{
        use             generic-host
        host_name       localhost
        alias           Local Host
        address         127.0.0.1
        }

define hostextinfo{
        host_name       localhost
        notes           Den lokale vaert som Nagios er installeret paa
        notes_url       http://localhost/info.html
        icon_image      localhost.png # placeres i "/var/www/nagios/htdocs/share/images/logos"
        icon_image_alt  Lokal vaert
        }

define hostgroup{
        hostgroup_name  gruppenavn ; Vælg et kort unikt navn
        alias           Langt navn for gruppen
        members         localhost, cvs.sslug.dk ; Kommasepareret liste
        }

define contact{
        use             generic-contact ; Den definerede contact-template
        contact_name    nagios
        alias           Nagios Bruger
        email           nagios@localhost
        }

define contactgroup{
        contactgroup_name       admins
        alias                   Administrators
        members                 root, nagios
        }

[tyge@hven nagios]$ egrep "(host_name|service_description)" services.cfg

define servicegroup{
        servicegroup_name       HTTP
        alias                   HyperText Transport Protocol
        members                 localhost,HTTP, cvs.sslug.dk,HTTP
        }

[tyge@hven ~]$ cd /usr/libexec/nagios
[tyge@hven libexec]$ ./check_disk -w 50% -c 25% -p /
DISK WARNING - free space: / 134354 MB (48%);| /=147041MB;140697;211046;0;281395

define command{
        command_name    check_local_disk
        command_line    $USER1$/check_disk -w $ARG1$ -c $ARG2$ -p $ARG3$
        }

define  service{
        use                     generic-service
        host_name               localhost
        service_description     Disk / mount
        check_command           check_local_disk!50%!25%!/
        }

12.2.4. Manualen

Det er ikke mange steder i denne bog "Friheden til at vælge" hvor der er en beskrivelse af hvordan læser den engelsksprogede manual. Hvad angår Nagios, så er det påkrævet da den ikke er helt nem at finde rundt i. Der er desværre heller ikke noget stiksordsregister, hvilket kunne have hjulpet en del.

Links ændre sig hele tiden for den sidst gældende manual, men her er så alligevel et link til Nagios version 2.0 manual . Et emne, hvor det kunne være rart hvis det var nemt at finde, er der hvor der står noget om hvordan man definere services. Når der ikke lige er et stikordsregister, så er det lige sin sag at finde ud af at det er Table of Contents - > Configuring Nagios -> Object configuration file options -> Click here -> Service definitions man skal klikke på. Måske du bare skulle overvej at hente hele manualen hjem, så kan du altid bruge grep hvis der er noget du vil finde. Og nu du har hentet manualen hjem på egen harddisk, så kan du lige sætte fontene til noget lidt større så det er til at læse. 7 og 8 pt er lige lovlig småt når man bruger "serif". De to følgende kommandoer skulle klare de værste problemer.

[tyge@hven ~]$ wget -mk http://nagios.sourceforge.net/docs/2_0/
[tyge@hven ~]$ ls *.html | \
        xargs perl -i -pe 's/font-size: [1-9]pt/font-size: 10pt/g'

12.2.5. Links

• nagios.org er hjemmesiden for Nagios. Her downloades hovedprogrammet til indsamling af data og programmet til præsentation på web.

• nagiosplug.sourceforge.net er hjemmesiden for check-programmerne for Nagios. Uden check-programmerne kan Nagios intet, så man skal downloade en pakke nagios-plugins.*.tra.gz her fra.

• nagiosexchange.org indeholder alt muligt andet omkring Nagios. Der er forskellige programmer der gør det nemmere at sætte Nagios op, pakker med ikoner, og andre tillægsting til Nagios. Der findes flere pakker der handler om at gøre opsætning af Nagios nemmere, så det kan være interessant at kigge på den på et tidligt tidspunkt.