Grundsätzlich ist das Funktionsprinzip in etwa so:

Host → Gruppe → Service

Das soll heißen, dass man Hosts in Gruppen organisieren kann und diese Gruppen einem Service (Check) zuweisen kann. Man kann aber auch die Gruppe übergehen und den Hosts direkt Services zuweisen. Bei großen Installationen ist das aber nicht sehr empfehlenswert.

Objekttypen

Host-Definitionen
Hostgruppen-Definitionen
Service-Definitionen
Servicegruppen-Definitionen
Kontakt-Definitionen
Kontaktgruppen-Definitionen
Zeitfenster-Definitionen
Befehlsdefinitionen
Service-Abhängigkeitsdefinitionen
Service-Eskalationsdefinitionen
Host-Abhängigkeitsdefinitionen
Host-Eskalationsdefinitionen
erweiterte Host-Informationsdefinitionen
erweiterte Service-Informationsdefinitionen

Host-Definition

Beschreibung:

Eine Host-Definition wird benutzt, um einen Server, eine Workstation, ein Gerät usw. zu definieren, die sich in Ihrem Netzwerk befinden.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Beispieldefinition:

define host{
	host_name			bogus-router
	alias				Bogus Router #1
	address				192.168.1.254
	parents				server-backbone
	check_command			check-host-alive
	check_interval			5
	retry_interval			1
	max_check_attempts		5
	check_period			24x7
	process_perf_data		0
	retain_nonstatus_information	0
	contact_groups			router-admins
	notification_interval		30
	notification_period		24x7
	notification_options		d,u,r
	}

Beschreibung der Direktiven:

Hostgruppen-Definition

Beschreibung:

Eine Hostgruppen-Definition wird benutzt, um einen oder mehrere Hosts zu gruppieren, um die Konfiguration mit Objekt-Tricks zu vereinfachen oder für Anzeigezwecke in den CGIs.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Beispieldefinition:

define hostgroup{
	hostgroup_name		novell-servers
	alias			Novell Servers
	members			netware1,netware2,netware3,netware4
	}

Beschreibung der Direktiven:

Service-Definition
Beschreibung:

Eine Service-Definition wird benutzt, um einen „Service“ zu identifizieren, der auf einem Host läuft. Der Begriff „Service“ wird sehr locker benutzt. Es kann sich um einen realen Service auf einem Host handeln (POP, SMTP, HTTP, etc.) oder eine andere Art von Metrik, die mit dem Host verbunden ist (Antwort auf einen Ping, Anzahl der angemeldeten Benutzer, freier Plattenplatz usw.). Die verschiedenen Parameter einer Service-Definition sind nachfolgend dargestellt.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Beispieldefinition:

define service{
	host_name		linux-server
	service_description	check-disk-sda1
	check_command		check-disk!/dev/sda1
	max_check_attempts	5
	check_interval		5
	retry_interval		3
	check_period		24x7
	notification_interval	30
	notification_period	24x7
	notification_options	w,c,r
	contact_groups		linux-admins
	}

Beschreibung der Direktiven:

Servicegruppen-Definition
Beschreibung:

Eine Servicegruppen-Definition wird benutzt, um einen oder mehrere Services zu gruppieren, um die Konfiguration mit Objekt-Tricks zu vereinfachen oder für Anzeigezwecke in den CGIs.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Beispieldefinition:

define servicegroup{
	servicegroup_name	dbservices
	alias			Database Services
	members			ms1,SQL Server,ms1,SQL Server Agent,ms1,SQL DTC
	}

Beschreibung der Direktiven:

Kontakt-Definition

Beschreibung:

Eine Kontakt-Definition wird benutzt, um jemanden zu identifizieren, der im Falle eines Problems in Ihrem Netzwerk informiert werden soll. Die verschiedenen Parameter einer Kontakt-Definition werden nachfolgend beschrieben.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Beispieldefinition:

define contact{
	contact_name                    jdoe
	alias                           John Doe
	host_notifications_enabled	1
	service_notifications_enabled	1
	service_notification_period     24x7
	host_notification_period        24x7
	service_notification_options    w,u,c,r
	host_notification_options       d,u,r
	service_notification_commands   notify-by-email
	host_notification_commands      host-notify-by-email
	email				jdoe@localhost.localdomain
	pager				555-5555@pagergateway.localhost.localdomain
	address1			xxxxx.xyyy@icq.com
	address2			555-555-5555
	can_submit_commands		1
	}

Beschreibung der Direktiven:

Kontaktgruppen-Definition
Beschreibung:

Eine Kontaktgruppen-Definition wird benutzt, um einen oder mehrere Kontakte zu gruppieren, um Alarm-/Erholungs-Benachrichtigungen zu versenden.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Beispieldefinition:

define contactgroup{
	contactgroup_name	novell-admins
	alias			Novell Administrators
	members			jdoe,rtobert,tzach
	}

Beschreibung der Direktiven:

Zeitfenster-Definition
Beschreibung:

Ein Zeitfenster ist eine Liste von Zeiten an verschiedenen Tagen, die als „gültige“ Zeiten für Benachrichtigungen und Service-Prüfungen angesehen werden. Es besteht aus Zeitbereichen für jeden Tag der Woche. Verschiedene Ausnahmen zu den normalen wöchentlichen Zeiten werden unterstützt, u.a.: bestimmte Wochentage, bestimmte Tage eines Monats, Tage eines bestimmten Monats und Kalendertage.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Beispiel-Definitionen:

define timeperiod{
	timeperiod_name		nonworkhours
	alias			Non-Work Hours
	sunday			00:00-24:00			; jeder Sonntag jeder Woche
	monday			00:00-09:00,17:00-24:00		; jeder Montag jeder Woche
	tuesday			00:00-09:00,17:00-24:00		; jeder Dienstag jeder Woche
	wednesday		00:00-09:00,17:00-24:00		; jeder Mittwoch jeder Woche
	thursday		00:00-09:00,17:00-24:00		; jeder Donnerstag jeder Woche
	friday			00:00-09:00,17:00-24:00		; jeder Freitag jeder Woche
	saturday		00:00-24:00			; jeder Samstag jeder Woche
	}
define timeperiod{
	timeperiod_name		misc-single-days
	alias			Misc Single Days
	1999-01-28		00:00-24:00 		; 28. Januar 1999
	monday 3		00:00-24:00		; 3. Montag im Monat
	day 2			00:00-24:00		; 2. Tag im Monat
	february 10		00:00-24:00		; 10. Februar im Jahr
	february -1		00:00-24:00		; letzter Tag im Februar
	friday -2		00:00-24:00		; vorletzer Freitag im Monat
	thursday -1 november	00:00-24:00		; letzter Donnerstag im November
	}
	
define timeperiod{
	timeperiod_name		misc-date-ranges
	alias			Misc Date Ranges
	2007-01-01 - 2008-02-01		00:00-24:00		; 1. Januar 2007 bis zum 1. Februar 2008
	monday 3 - thursday 4		00:00-24:00		; 3. Montag bis 4. Donnerstag
	day 1 - 15			00:00-24:00		; 1. bis 15. Tag
	day 20 - -1			00:00-24:00		; 20. Tag bis Monatsende
	july 10 - 15			00:00-24:00		; 10. - 15. Juli
	april 10 - may 15		00:00-24:00		; 10. April bis zum 15. Mai
	tuesday 1 april - friday 2 may	00:00-24:00		; 1. Dienstag im April bis zum 2. Freitag im Mai
	}
define timeperiod{
	timeperiod_name		misc-skip-ranges
	alias			Misc Skip Ranges
	2007-01-01 - 2008-02-01 / 3		00:00-24:00	; jeder dritte Tag vom 1. Januar 2008 bis zum 1. Februar 2008
	2008-04-01 / 7				00:00-24:00	; jeder 7. Tag ab dem 1. April 2008 (ohne Endedatum)
	monday 3 - thursday 4 / 2		00:00-24:00	; jeder zweite Tag vom 3. Montag bis zum 4. Donnerstag des Monats
	day 1 - 15 / 5				00:00-24:00	; jeder 5. Tag vom 1. bis zum 15. Tag des Monats
	july 10 - 15 / 2			00:00-24:00	; jeder zweite Tag vom 10. Juli bis zum 15.Juli
	tuesday 1 april - friday 2 may / 6	00:00-24:00	; jeder sechste Tag vom 1. Dienstag im April bis zum 2. Freitag im Mai
	}

Beschreibung der Direktiven:

timeperiod_name:	Diese Direktive ist der Kurzname, der benutzt wird, um das Zeitfenster zu identifizieren.
alias:	Diese Direktive ist ein längerer Name oder eine Beschreibung zur Identifizierung des Zeitfensters.
[weekday]:	Die Wochentags-Direktiven („sunday“ bis „saturday“) sind komma-separierte Listen von Zeitbereichen, die „gültige“ Zeiten für einen bestimmten Tag der Woche sind. Beachten Sie, dass es sieben verschiedene Tage gibt, für die Sie Zeitbereiche angeben können („Sunday“ bis „Saturday“). Jeder Zeitbereich hat die Form HH:MM-HH:MM, wobei die Stunden in einem 24-Stunden-Format angegeben werden. Wenn Sie einen kompletten Tag aus dem Zeitfenster ausschließen wollen, dann geben Sie ihn einfach nicht an.
[exception]:	Sie können verschiedene Arten von Ausnahmen zum Standard-Wochentagsplan angeben. Ausnahmen können eine Reihe von verschiedenen Formen annehmen, u.a. einzelne Tage eines bestimmten oder jeden Monats, einzelne Wochentage eines Monats oder einzelner Kalenderdaten. Sie können auch einen Bereich von Tagen/Daten und sogar bestimmte Intervalle überspringen, um Funktionalitäten wie „alle drei Tage zwischen diesen Daten“ zu erreichen. Statt alle möglichen von Ausnahmen anzugeben, zeige ich Ihnen anhand der o.g. Beispieldefinitionen, was möglich ist. Wochentage und verschiedene Arten von Ausnahmen haben alle verschiedene Vorrangebenen, so dass es wichtig ist zu verstehen, wie sie sich gegenseitig beeinflussen. Mehr Informationen dazu finden Sie in der Dokumentation zu Zeitfenstern.
exclude:	Diese Direktive wird benutzt, um die Kurznamen von anderen Zeitfenstern abzugeben, deren Zeitbereiche in diesem Zeitfenster ausgeschlossen werden sollen. Mehrere Zeitfensternamen sind durch Kommata von einander zu trennen.

Befehls-Definition
Beschreibung:

Eine Befehls-Definition ist genau das. Sie definiert einen Befehl. Befehle, die definiert werden können, umfassen u.a. Service-Prüfungen, Host-Benachrichtigungen und Host-Eventhandler. Befehls-Definitionen können Makros enthalten, aber Sie müssen sicherstellen, dass Sie nur solche Makros verwenden, die unter den gegebenen Umständen „gültig“ sind. Mehr Informationen dazu, welche Makros verfügbar und wann sie „gültig“ sind, finden Sie hier. Die verschiedenen Argumente einer Befehls-Definition sehen Sie nachfolgend.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Beispieldefinition:

define command{
	command_name	check_pop
	command_line	/usr/local/nagios/libexec/check_pop -H $HOSTADDRESS$	
	}

Beschreibung der Direktiven:

Service-Abhängigkeits-Definition

Beschreibung:

Service-Abhängigkeiten sind ein fortgeschrittenes Feature von Nagios, das es Ihnen erlaubt, Benachrichtungen und aktive Prüfungen von Services in Abhängigkeit vom Status eines oder mehrerer Services zu unterdrücken. Service-Abhängigkeiten sind optional und zielen hauptsächlich auf fortgeschrittene Benutzer mit komplizierten Überwachungsumgebungen. Mehr Informationen, wie Service-Abhängigkeiten arbeiten (lesen Sie dies!), finden Sie hier.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional. Trotz allem müssen Sie mindestens ein Kriterium angeben, damit die Definition von Nutzen ist.

Beispieldefinition:

define servicedependency{
	host_name			WWW1
	service_description		Apache Web Server
	dependent_host_name		WWW1
	dependent_service_description	Main Web Site
	execution_failure_criteria	n
	notification_failure_criteria	w,u,c
	}

Beschreibung der Direktiven:

Serviceeskalations-Definition

Beschreibung:

Serviceeskalationen sind komplett optional und werden benutzt, um Benachrichtigungen für einen bestimmten Service zu eskalieren. Mehr Informationen, wie Eskalationen arbeiten, finden Sie hier.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Beispieldefinition:

define serviceescalation{
	host_name		nt-3
	service_description	Processor Load
	first_notification	4
	last_notification	0
	notification_interval	30
	contact_groups		all-nt-admins,themanagers
	}

Beschreibung der Direktiven:

die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Host-Abhängigkeits-Definition
Beschreibung:

Host-Abhängigkeiten sind ein fortgeschrittenes Feature von Nagios, das es Ihnen erlaubt, Benachrichtungen von Hosts in Abhängigkeit vom Status eines oder mehrerer Hosts zu unterdrücken. Host-Abhängigkeiten sind optional und zielen hauptsächlich auf fortgeschrittene Benutzer mit komplizierten Überwachungsumgebungen. Mehr Informationen, wie Host-Abhängigkeiten arbeiten (lesen Sie dies!), finden Sie hier.
Format der Definition:

Beispieldefinition:

define hostdependency{
	host_name			WWW1
	dependent_host_name		DBASE1
	notification_failure_criteria	d,u
	}

Beschreibung der Direktiven:

Host-Eskalations-Definition
Beschreibung:

Host-Eskalationen sind komplett optional und werden benutzt, um Benachrichtigungen für einen bestimmten Host zu eskalieren. Mehr Informationen, wie Eskalationen arbeiten, finden Sie hier.
Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional.

Beispieldefinition:

define hostescalation{
	host_name		router-34
	first_notification	5
	last_notification	8
	notification_interval	60
	contact_groups		all-router-admins
	}

Beschreibung der Direktiven:

erweiterte Hostinformations-Definition
Beschreibung:

Einträge für erweiterte Hostinformationen sind grundsätzlich dazu gedacht, die Ausgaben der status-, statusmap-, statuswrl- und extinfo-CGIs schöner aussehen zu lassen. Sie haben keinen Einfluss auf die Überwachung und sind vollständig optional.

Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional. Trotz allem müssen Sie mindestens ein Kriterium angeben, damit die Definition von Nutzen ist.

Beispieldefinition:

define hostextinfo{
	host_name	netware1
	notes		This is the primary Netware file server
	notes_url	http://webserver.localhost.localdomain/hostinfo.pl?host=netware1
	icon_image	novell40.png 
	icon_image_alt	IntranetWare 4.11
	vrml_image	novell40.png
	statusmap_image	novell40.gd2
	2d_coords	100,250
	3d_coords	100.0,50.0,75.0
	}

Variablenbeschreibungen:

erweiterte Serviceinformations-Definition

Beschreibung:

Einträge für erweiterte Serviceinformationen sind grundsätzlich dazu gedacht, die Ausgaben der status- und extinfo-CGIs schöner aussehen zu lassen. Sie haben keinen Einfluss auf die Überwachung und sind vollständig optional.

Format der Definition:

Anmerkung: die unterstrichenen Direktiven werden benötigt, die anderen sind optional. Trotz allem müssen Sie mindestens ein Kriterium angeben, damit die Definition von Nutzen ist.

Beispieldefinition:

define serviceextinfo{
	host_name		linux2
	service_description	Log Anomalies
	notes			Security-related log anomalies on secondary Linux server
	notes_url		http://webserver.localhost.localdomain/serviceinfo.pl?host=linux2&service=Log+Anomalies
	icon_image		security.png 
	icon_image_alt		Security-Related Alerts
	}

Variablenbeschreibungen: