| Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Nächste ÜberarbeitungBeide Seiten der Revision |
| wiki:programme:nagios:definitionen [2011/06/12 10:49] – wiki:programme:nagios:konfiguration umbenannt in wiki:programme:nagios:definitionen wikiadmin | wiki:programme:nagios:definitionen [2012/10/08 14:31] – Externe Bearbeitung 127.0.0.1 |
|---|
| | ~~BARCODE~class=barcode_right~size=S~~ |
| | |
| ====== Grundsätliches ====== | ====== Grundsätliches ====== |
| Grundsätzlich ist das Funktionsprinzip in etwa so: | Grundsätzlich ist das Funktionsprinzip in etwa so: |
| |
| ======Definitionen====== | ======Definitionen====== |
| | **__Objekttypen__** |
| | \\ |
| | \\ |
| [[#host|Host-Definitionen]]\\ | [[#host|Host-Definitionen]]\\ |
| [[#hostgroup|Hostgruppen-Definitionen]]\\ | [[#hostgroup|Hostgruppen-Definitionen]]\\ |
| [[#service|Service-Definitionen]]\\ // | [[#service|Service-Definitionen]]\\ |
| // | [[#servicegroup|Servicegruppen-Definitionen]]\\ |
| | [[#contact|Kontakt-Definitionen]]\\ |
| | [[#contactgroup|Kontaktgruppen-Definitionen]]\\ |
| | [[#timeperiod|Zeitfenster-Definitionen]]\\ |
| | [[#command|Befehlsdefinitionen]]\\ |
| | [[#servicedependency|Service-Abhängigkeitsdefinitionen]]\\ |
| | [[#serviceescalation|Service-Eskalationsdefinitionen]]\\ |
| | [[#hostdependency|Host-Abhängigkeitsdefinitionen]]\\ |
| | [[#hostescalation|Host-Eskalationsdefinitionen]]\\ |
| | [[#hostextinfo|erweiterte Host-Informationsdefinitionen]]\\ |
| | [[#serviceextinfo|erweiterte Service-Informationsdefinitionen]]\\ |
| | \\ |
| | \\ |
| =====host===== | =====host===== |
| Host-Definition | Host-Definition |
| |**action_url**:|Diese Direktive wird benutzt, um einen optionalen URL anzugeben, der benutzt werden kann, um weitere Aktionen für diese Servicegruppe zu ermöglichen. Wenn Sie einen URL angeben, werden Sie einen roten "Klecks" in den CGIs sehen (wenn Sie Servicegruppen-Informationen betrachten). Jeder gültige URL kann benutzt werden. Wenn Sie relative Pfade benutzen, wird der Basis-Pfad der gleiche sein, der benutzt wird, um auf die CGIs zuzugreifen (d.h. ///cgi-bin/nagios///).| | |**action_url**:|Diese Direktive wird benutzt, um einen optionalen URL anzugeben, der benutzt werden kann, um weitere Aktionen für diese Servicegruppe zu ermöglichen. Wenn Sie einen URL angeben, werden Sie einen roten "Klecks" in den CGIs sehen (wenn Sie Servicegruppen-Informationen betrachten). Jeder gültige URL kann benutzt werden. Wenn Sie relative Pfade benutzen, wird der Basis-Pfad der gleiche sein, der benutzt wird, um auf die CGIs zuzugreifen (d.h. ///cgi-bin/nagios///).| |
| \\ | \\ |
| | =====contact===== |
| | 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. |
| | \\ |
| | |define contact{|| |
| | |__contact_name__|__//contact_name//__| |
| | |alias|//alias//| |
| | |contactgroups|//contactgroup_names//| |
| | |__host_notifications_enabled__|__[0/1]__| |
| | |__service_notifications_enabled__|__[0/1]__| |
| | |__host_notification_period__|__//timeperiod_name//__| |
| | |__service_notification_period__|__//timeperiod_name//__| |
| | |__host_notification_options__|__[d,u,r,f,s,n]__| |
| | |__service_notification_options__|__[w,u,c,r,f,s,n]__| |
| | |__host_notification_commands__|__//command_name//__| |
| | |__service_notification_commands__|__//command_name//__| |
| | |email|//email_address//| |
| | |pager|//pager_number or pager_email_gateway//| |
| | |address//x//|//additional_contact_address//| |
| | |can_submit_commands|[0/1]| |
| | |retain_status_information|[0/1]| |
| | |retain_nonstatus_information|[0/1]| |
| | |}|| |
| | Beispieldefinition:\\ |
| | \\ <code>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 |
| | } |
| | </code> Beschreibung der Direktiven:\\ |
| | |**contact_name**:|Diese Direktive wird benutzt, um einen Kurznamen zu definieren, der den Kontakt identifiziert. Er wird in [[#contactgroup|Kontaktgruppen]]-Definitionen benutzt. Bei korrekter Anwendung wird das $CONTACTNAME$-[[macros|Makro]] diesen Wert enthalten.| |
| | |**alias**:|Diese Direktive wird benutzt, um einen längeren Namen oder eine Beschreibung zu definieren, der/die den Kontakt identifiziert. Bei korrekter Anwendung wird das $CONTACTALIAS$-[[macros|Makro]] diesen Alias/diese Beschreibung enthalten. Falls nicht angegeben, wird der //contact_name// als Alias verwendet.| |
| | |**contactgroups**:|Diese Direktive wird benutzt, um den/die //Kurznamen// der [[#contactgroup|Kontaktgruppe(n)]] anzugeben, zu dem/denen der Kontakt gehört. Mehrere Kontaktgruppen werden durch Kommata von einander getrennt. Diese Direktive kann als Alternative (oder zusätzlich) zur //members//-Direktive in den [[#contactgroup|contactgroup]]-Definitionen genutzt werden.| |
| | |**host_notifications_enabled**:|Diese Direktive wird benutzt, um festzulegen, ob der Kontakt Benachrichtigungen über Host-Probleme und Erholungen bekommt.\\ Werte: 0 = keine Benachrichtigungen versenden, 1 = Benachrichtigungen versenden| |
| | |**service_notifications_enabled**:|Diese Direktive wird benutzt, um festzulegen, ob der Kontakt Benachrichtigungen über Service-Probleme und Erholungen bekommt.\\ Werte: 0 = keine Benachrichtigungen versenden, 1 = Benachrichtigungen versenden| |
| | |**host_notification_period**:|Diese Direktive wird benutzt, um den Kurznamen des [[#timeperiod|Zeitfensters]] anzugeben, in dem der Kontakt über Host-Probleme oder Erholungen informiert wird. Sie können dies als "Bereitschafts"-Zeiten dieses Kontakts für Host-Benachrichtigungen ansehen. Lesen Sie die Dokumentation zu [[timeperiods|Zeitfenstern]], um mehr Informationen darüber zu erhalten, wie diese funktionieren und welche potenziellen Probleme durch unsachgemäßen Gebrauch entstehen können.| |
| | |**service_notification_period**:|Diese Direktive wird benutzt, um den Kurznamen des [[#timeperiod|Zeitfensters]] anzugeben, in dem der Kontakt über Service-Probleme oder Erholungen informiert wird. Sie können dies als "Bereitschafts"-Zeiten dieses Kontakts für Service-Benachrichtigungen ansehen. Lesen Sie die Dokumentation zu [[timeperiods|Zeitfenstern]], um mehr Informationen darüber zu erhalten, wie diese funktionieren und welche potenziellen Probleme durch unsachgemäßen Gebrauch entstehen können.| |
| | |**host_notification_commands**:|Diese Direktive wird benutzt, um //Kurznamen// von [[#command|Befehlen]] anzugeben, die zur Benachrichtigung von Kontakten über //Host//-Probleme oder Erholungen benutzt werden. Mehrere Benachrichtigungsbefehle sollten durch Kommata von einander getrennt werden. Alle Benachrichtigungsbefehle werden ausgeführt, wenn der Kontakt informiert werden muss. Die maximale Zeit, die der Benachrichtigungsbefehl laufen darf, wird durch die [[configmain#notification_timeout|notification_timeout]]-Option kontrolliert.| |
| | |**host_notification_options**:|Diese Direktive wird benutzt, um die Host-Zustände festzulegen, bei denen Benachrichtigungen an den Kontakt versandt werden. Gültige Optionen sind eine Kombination von einem oder mehreren folgender Werte: **d** = Benachrichtigungen bei einem DOWN-Zustand versenden, **u** = Benachrichtigungen bei einem UNREACHABLE-Zustand versenden, **r** = Benachrichtigungen bei Erholungen (UP-Zustand) versenden, **f** = Benachrichtigungen versenden, wenn der Host mit [[flapping|Flattern]] anfängt bzw. aufhört und **s** = Benachrichtigungen versenden, wenn eine [[downtime|geplante Ausfallzeit]] anfängt oder aufhört. Wenn Sie **n** (none) als Option angeben, werden keine Host-Benachrichtigungen versandt.| |
| | |**service_notification_options**:|Diese Direktive wird benutzt, um die Service-Zustände festzulegen, bei denen Benachrichtigungen an den Kontakt versandt werden. Gültige Optionen sind eine Kombination von einem oder mehreren folgender Werte: **w** = Benachrichtigungen bei einem WARNING-Zustand versenden, **u** = Benachrichtigungen bei einem UNKNOWN-Zustand versenden, **r** = Benachrichtigungen bei Erholungen (OK-Zustand) versenden, **f** = Benachrichtigungen versenden, wenn der Service mit [[flapping|Flattern]] anfängt bzw. aufhört und **s** = Benachrichtigungen versenden, wenn eine [[downtime|geplante Ausfallzeit]] anfängt oder aufhört. Wenn Sie **n** (none) als Option angeben, werden keine Service-Benachrichtigungen versandt.| |
| | |**service_notification_commands**:|Diese Direktive wird benutzt, um //Kurznamen// von [[#command|Befehlen]] anzugeben, die zur Benachrichtigung von Kontakten über //Service//-Probleme oder Erholungen benutzt werden. Mehrere Benachrichtigungsbefehle sollten durch Kommata von einander getrennt werden. Alle Benachrichtigungsbefehle werden ausgeführt, wenn der Kontakt informiert werden muss. Die maximale Zeit, die der Benachrichtigungsbefehl laufen darf, wird durch die [[configmain#notification_timeout|notification_timeout]]-Option kontrolliert. | |
| | |**email**:|Diese Direktive wird benutzt, um ein e-Mail-Adresse für den Kontakt zu definieren. Abhängig von Ihren Benachrichtigungsbefehlen kann sie benutzt werden, um eine Alarm-Mail an den Kontakt zu versenden. Bei korrekter Anwendung wird das $CONTACTEMAIL$-[[macros|Makro]] diesen Wert enthalten.| |
| | |**pager**:|Diese Direktive wird benutzt, um eine Pager-Nummer für den Kontakt zu definieren. Sie kann auch eine e-Mail-Adresse eines Pager-Gateways (z.B. pagejoe@pagenet.com) sein. Abhängig von Ihren Benachrichtigungsbefehlen kann sie benutzt werden, um eine Alarm-Page an den Kontakt zu versenden. Bei korrekter Anwendung wird das $CONTACTPAGER$-[[macros|Makro]] diesen Wert enthalten.| |
| | |**address//x//**:|Adress-Direktiven werden benutzt, um zusätzliche "Adressen" für den Kontakt zu definieren. Diese Adressen können alles sein - Mobiltelefonnummern, Instant-Messaging-Adressen usw. Abhängig von Ihren Benachrichtigungsbefehlen kann sie benutzt werden, um einen Alarm an den Kontakt zu versenden. Bis zu sechs Adressen können mit Hilfe dieser Direktiven definiert werden (//address1// bis //address6//). Das $CONTACTADDRESS//x//$-[[macros|Makro]] wird diesen Wert enthalten.| |
| | |**can_submit_commands**:|Diese Direktive wird benutzt, um festzulegen, ob dieser Kontakt über die CGIs [[extcommands|externe Befehle]] an Nagios erteilen kann. Werte: 0 = dem Kontakt die Erteilung von Befehlen verweigern, 1 = dem Kontakt die Erteilung von Befehlen erlauben.| |
| | |**retain_status_information**:|Diese Direktive wird benutzt, um festzulegen, ob zustandsbezogene Informationen zu diesem Kontakt über Programmneustarts hinweg aufbewahrt wird. Das ist nur sinnvoll, wenn Sie Statusaufbewahrung über die [[configmain#retain_state_information|retain_state_information]]-Direktive aktiviert haben.\\ Werte: 0 = Aufbewahrung von Statusinformationen deaktivieren, 1 = Aufbewahrung von Statusinformationen aktivieren.| |
| | |**retain_nonstatus_information**:|Diese Direktive wird benutzt, um festzulegen, ob nicht-zustandsbezogene Informationen zu diesem Kontakt über Programmneustarts hinweg aufbewahrt wird. Das ist nur sinnvoll, wenn Sie Statusaufbewahrung über die [[configmain#retain_state_information|retain_state_information]]-Direktive aktiviert haben.\\ Werte: 0 = Aufbewahrung von nicht-Statusinformationen deaktivieren, 1 = Aufbewahrung von nicht-Statusinformationen aktivieren.| |
| | \\ |
| | =====contactgroup===== |
| | Kontaktgruppen-Definition |
| | \\ Beschreibung:\\ |
| | \\ |
| | Eine Kontaktgruppen-Definition wird benutzt, um einen oder mehrere [[#contact|Kontakte]] zu gruppieren, um Alarm-/Erholungs-[[notifications|Benachrichtigungen]] zu versenden. |
| | \\ |
| | Format der Definition:\\ |
| | \\ |
| | Anmerkung: die __unterstrichenen__ Direktiven werden benötigt, die anderen sind optional. |
| | \\ |
| | |define contactgroup{|| |
| | |__contactgroup_name__|__//contactgroup_name//__| |
| | |__alias__|__//alias//__| |
| | |__members__|__//contacts//__| |
| | |contactgroup_members|//contactgroups//| |
| | |}|| |
| | Beispieldefinition:\\ |
| | \\ <code>define contactgroup{ |
| | contactgroup_name novell-admins |
| | alias Novell Administrators |
| | members jdoe,rtobert,tzach |
| | } |
| | </code> Beschreibung der Direktiven:\\ |
| | |**contactgroup_name**:|Diese Direktive wird benutzt, um einen Kurznamen zu definieren, der die Kontaktgruppe identifiziert.| |
| | |**alias**:|Diese Direktive wird benutzt, um einen längeren Namen oder eine Beschreibung zu definieren, der die Kontaktgruppe identifiziert.| |
| | |**members**:|Dies ist eine Liste von //Kurznamen// der [[#contact|Kontakte]], die in dieser Gruppe enthalten sein sollen. Mehrere Kontaktnamen sollten jeweils durch Komma von einander getrennt werden. Diese Direktive kann als Alternative (oder als Zusatz) zu der //contactgroups//-Direktive in den [[#contact|Kontakt-Definitionen]] verwendet werden.| |
| | |**contactgroup_members**:|Diese optionale Direktive kann genutzt werden, um Kontakte aus anderen "sub"-Kontaktgruppen in diese Kontaktgruppe aufzunehmen. Geben Sie eine komma-separierte Liste von Kurznamen anderer Kontaktgruppen an, deren Mitglieder in diese Gruppe aufgenommen werden sollen.| |
| | \\ |
| | =====timeperiod===== |
| | 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. |
| | \\ |
| | |define timeperiod{|| |
| | |__timeperiod_name__|__//timeperiod_name//__| |
| | |__alias__|__//alias//__| |
| | |[weekday]|//timeranges//| |
| | |[exception]|//timeranges//| |
| | |exclude|[//timeperiod1,timeperiod2,...,timeperiodn//]| |
| | |}|| |
| | Beispiel-Definitionen:\\ |
| | \\ <code>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 |
| | } |
| | </code> 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 [[timeperiods|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.| |
| | \\ |
| | =====command===== |
| | 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 [[macros|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 [[macros|hier]]. Die verschiedenen Argumente einer Befehls-Definition sehen Sie nachfolgend. |
| | \\ |
| | Format der Definition:\\ |
| | \\ |
| | Anmerkung: die __unterstrichenen__ Direktiven werden benötigt, die anderen sind optional. |
| | \\ |
| | |define command{|| |
| | |__command_name__|__//command_name//__| |
| | |__command_line__|__//command_line//__| |
| | |}|| |
| | Beispieldefinition:\\ |
| | \\ <code>define command{ |
| | command_name check_pop |
| | command_line /usr/local/nagios/libexec/check_pop -H $HOSTADDRESS$ |
| | } |
| | </code> Beschreibung der Direktiven:\\ |
| | |**command_name**:|Diese Direktive ist der Kurzname, der zur Identifizierung des Befehls benutzt wird. Er wird u.a. in [[#contact|Kontakt]]-, [[#host|Host]]- und [[#service|Service]]-Definitionen (in notification-, check-, und event handler-Direktiven) verwendet.| |
| | |**command_line**:|Diese Direktive wird benutzt, um zu definieren, was wirklich durch Nagios ausgeführt wird, wenn der Befehl für Service- oder Host-Prüfungen, Benachrichtigungen oder [[eventhandlers|Eventhandler]] benutzt wird. Vor der Ausführung der Kommandozeile werden alle gültigen [[macros|Makros]] durch die entsprechenden Werte ersetzt. Lesen Sie die Dokumentation, um festzustellen, welche verschiedenen Makros Sie benutzen können. Beachten Sie, dass die Kommandozeile //nicht// von Anführungszeichen eingeschlossen wird. Achten Sie auch darauf, dass Sie bei der Übergabe eines Dollarzeichens ($) ein weiteres Dollarzeichen zur Maskierung benutzen müssen (aus bar$foo muss bar$$foo werden).\\ **ANMERKUNG**: Sie dürfen kein **Semikolon** (;) in der //command_line//-Direktive einsetzen, weil alles danach als Kommentar angesehen wird. Sie können diese Begrenzung umgehen, indem Sie eines der [[macros#user|**$USER$**]]-Makros in Ihrem [[configmain#resource_file|resource file]] mit einem Semikolon füllen und dann in der //command_line//-Direktive auf das entsprechende $USER$-Makro verweisen.\\ Wenn Sie während der Laufzeit Parameter an Befehle übergeben wollen, können Sie die [[macros#arg|**$ARGn$**-Makros]] in der //command_line//-Direktive der Befehlsdefinition benutzen und in den Objektdefinitions-Direktiven (Host-Prüfbefehl, Service-Eventhandler, usw.), die auf den Befehl verweisen, einzelne Argumente durch Ausrufezeichen (!) vom Befehlsnamen (und von einander) trennen. Mehr Informationen, wie Argumente in Befehlsdefinitionen während der Laufzeit verarbeitet werden, finden Sie in der Dokumentation zu [[macros|Makros]].| |
| | \\ |
| | =====servicedependency===== |
| | 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 [[dependencies|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. |
| | \\ |
| | |define servicedependency{|| |
| | |__dependent_host_name__|__//host_name//__| |
| | |dependent_hostgroup_name|//hostgroup_name//| |
| | |__dependent_service_description__|__//service_description//__| |
| | |__host_name__|__//host_name//__| |
| | |hostgroup_name|//hostgroup_name//| |
| | |__service_description__|__//service_description//__| |
| | |inherits_parent|[0/1]| |
| | |execution_failure_criteria|[o,w,u,c,p,n]| |
| | |notification_failure_criteria|[o,w,u,c,p,n]| |
| | |dependency_period|timeperiod_name| |
| | |}|| |
| | Beispieldefinition:\\ |
| | \\ <code>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 |
| | } |
| | </code> Beschreibung der Direktiven:\\ |
| | |**dependent_host_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// des/der [[#host|Hosts]] anzugeben, auf dem der //abhängige// Service "läuft" oder mit dem er verbunden ist. Mehrere Hosts werden durch Kommata von einander getrennt. Bleibt die Direktive leer, so kann dadurch eine [[objecttricks#same_host_dependency|"same host"-Abhängigkeit]] erstellt werden.| |
| | |**dependent_hostgroup_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// der [[#hostgroup|Hostgruppe(n)]] anzugeben, auf der/denen der //abhängige// Service "läuft" oder mit dem er verbunden ist. Mehrere Hostgruppen werden durch Kommata von einander getrennt. Die dependent_hostgroup-Direktive kann statt der (oder zusätzlich zur) dependent_host-Direktive benutzt werden.| |
| | |**dependent_service_description**:|Diese Direktive wird benutzt, um die //Beschreibung// des //abhängigen// [[#service|Service]] anzugeben.| |
| | |**host_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// des/der [[#host|Hosts]] anzugeben, auf dem/denen der Service "läuft" oder mit dem/denen er verbunden ist, von dem "es" //abhängt// (auch als Master-Service bezeichnet). Mehrere Hosts werden durch Kommata von einander getrennt.| |
| | |**hostgroup_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// der [[#host|Hostgruppe(n)]] anzugeben, auf der/denen der Service "läuft" oder mit der/denen er verbunden ist, von dem "es" //abhängt// (auch als Master-Service bezeichnet). Mehrere Hostgruppen werden durch Kommata von einander getrennt. Der hostgroup_name kann statt oder zusätzlich zur host_name-Direktive benutzt werden.| |
| | |**service_description**:|Diese Direktive wird benutzt, um die //Beschreibung// des [[#service|Service]] anzugeben, von dem "es" //abhängt// (auch als Master-Service bezeichnet).| |
| | |**inherits_parent**:|Diese Direktive gibt an, ob die abhängige Definition Abhängigkeiten von dem Service erbt, von dem sie //abhängt// (auch als Master-Service bezeichnet). In anderen Worten, wenn der Master-Service von anderen Services abhängt und eine der Abhängigkeiten fehlschlägt, dann wird auch diese Abhängigkeit fehlschlagen.| |
| | |**execution_failure_criteria**:|Diese Direktive wird benutzt, um die Kriterien festzulegen, wann der abhängige Service //nicht// aktiv geprüft werden soll. Wenn der Master-Service in einem der Zustände ist, die wir angeben, wird der //abhängige// Service nicht aktiv geprüft. Gültige Optionen sind eine Kombination von einem oder mehreren folgender Werte (mehrere Werte werden durch Kommata von einander getrennt): **o** = fehlschlagen bei einem OK-Zustand, **w** = fehlschlagen bei einem WARNING-Zustand, **u** = fehlschlagen bei einem UNKNOWN-Zustand, **c** = fehlschlagen bei einem CRITICAL-Zustand und **p** = fehlschlagen bei einem PENDING-Zustand (d.h. der Service wurde bisher noch nie geprüft). Wenn Sie **n** (none) als Option angeben, wird die Ausführungsabhängigkeit nie fehlschlagen und die Prüfungen des abhängigenService werden immer erfolgen (falls andere Bedingungen das erlauben). Beispiel: wenn Sie **o,c,u** in diesem Feld angeben, dann wird der //abhängige// Service nicht aktiv geprüft, wenn der //Master//-Service sich in einem OK-, CRITICAL- oder UNKNOWN-Zustand befindet.| |
| | |**notification_failure_criteria**:|Diese Direktive wird benutzt, um die Kriterien festzulegen, wann //keine// Benachrichtigungen für den abhängigen Service versandt werden sollen. Wenn der Master-Service in einem der Fehler-Zustände ist, die wir angeben, werden keine Benachrichtigungen für den //abhängigen// Service an die Kontakte versandt. Gültige Optionen sind eine Kombination von einem oder mehreren folgender Werte: **o** = fehlschlagen bei einem OK-Zustand, **w** = fehlschlagen bei einem WARNING-Zustand, **u** = fehlschlagen bei einem UNKNOWN-Zustand, **c** = fehlschlagen bei einem CRITICAL-Zustand und **p** = fehlschlagen bei einem PENDING-Zustand (d.h. der Service wurde bisher noch nie geprüft). Wenn Sie **n** (none) als Option angeben, wird die Benachrichtigungsabhängigkeit nie fehlschlagen und die Benachrichtungen für den abhängigen Service werden immer erfolgen. Beispiel: wenn Sie **w** in diesem Feld angeben, dann werden die Benachrichtigungen für den //abhängigen// Service nicht versandt, wenn der //Master//-Service sich in einem WARNING-Zustand befindet.| |
| | |**dependency_period**:|Diese Direktive wird benutzt, um den Kurznamen eines [[#timeperiod|Zeitfensters]] anzugeben, in welchem diese Abhängigkeit gültig ist. Wenn diese Direktive nicht angegeben wird, ist die Abhängigkeit zu allen Zeiten gültig.| |
| | \\ |
| | =====serviceescalation===== |
| | 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 [[escalations|hier]]. |
| | \\ |
| | Format der Definition:\\ |
| | \\ |
| | Anmerkung: die __unterstrichenen__ Direktiven werden benötigt, die anderen sind optional. |
| | \\ |
| | |define serviceescalation{|| |
| | |__host_name__|__//host_name//__| |
| | |hostgroup_name|//hostgroup_name//| |
| | |__service_description__|__//service_description//__| |
| | |__contacts__|__//contacts//__| |
| | |__contact_groups__|__//contactgroup_name//__| |
| | |__first_notification__|__#__| |
| | |__last_notification__|__#__| |
| | |__notification_interval__|__#__| |
| | |escalation_period|timeperiod_name| |
| | |escalation_options|[w,u,c,r]| |
| | |}|| |
| | Beispieldefinition:\\ |
| | \\ <code>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 |
| | } |
| | </code> Beschreibung der Direktiven:\\ |
| | |**host_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// des/der [[#host|Hosts]] anzugeben, für den die [[#service|Service]]-Eskalation gilt oder mit dem/denen er verbunden ist.| |
| | |**hostgroup_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// der [[#host|Hostgruppen]] anzugeben, für den die [[#service|Service]]-Eskalation gilt oder mit der/denen er verbunden ist. Mehrere Hostgruppen werden durch Kommata von einander getrennt. Der hostgroup_name kann statt oder zusätzlich zur host_name-Direktive benutzt werden.| |
| | |**service_description**:|Diese Direktive wird benutzt, um die //Beschreibung// des [[#service|Service]] zu identifizieren, auf den die Eskalation zutreffen soll.| |
| | |**first_notification**:|Diese Direktive ist eine Zahl, die die //erste// Benachrichtigung angibt, für die diese Eskalation gilt. Wenn Sie beispielsweise den Wert auf 3 setzen, dann wird diese Eskalation nur dann benutzt, wenn der Service lang genug in einem nicht-OK-Zustand ist, damit eine dritte Benachrichtigung versandt wird.| |
| | |**last_notification**:|Diese Direktive ist eine Zahl, die die //letzte// Benachrichtigung angibt, für die diese Eskalation gilt. Wenn Sie beispielsweise den Wert auf 5 setzen, dann wird diese Eskalation nicht benutzt, wenn mehr als fünf Benachrichtigungen für den Service versandt werden. Wenn der Wert auf Null gesetzt wird, wird dieser Eskalationseintrag immer benutzt (unabhängig davon, wie viele Benachrichtigungen versandt werden.)| |
| | |**contacts**:|Dies ist eine Liste von //Kurznamen// der [[#contact|Kontakte]], die informiert werden sollen, wenn es Probleme (oder Erholungen) für diesen Service gibt. Mehrere Kontakte werden durch Kommata von einander getrennt. Das ist nützlich, wenn Sie Benachrichtigungen nur an ein paar Leute verschicken wollen und keine [[#contactgroup|Kontaktgruppen]] definieren wollen. Sie müssen mindestens einen Kontakt oder eine Kontaktgruppe in jeder Serviceeskalations-Definition angeben.| |
| | |**contact_groups**:|Dies ist eine Liste von //Kurznamen// der [[#contact|Kontaktgruppen]], die informiert werden sollen, wenn die Service-Benachrichtigung eskaliert. Mehrere Kontaktgruppen werden durch Kommata von einander getrennt. Sie müssen mindestens einen Kontakt oder eine Kontaktgruppe in jeder Serviceeskalations-Definition angeben.| |
| | |**notification_interval**:|Diese Direktive wird benutzt, um das Intervall festzulegen, in dem Benachrichtigungen versandt werden, wenn diese Eskalation gültig ist. Wenn Sie einen Wert von 0 für dieses Intervall angeben, wird Nagios die erste Benachrichtigung versenden, wenn diese Eskalation gültig wird, dann aber verhindern, dass weitere Benachrichtigungen versandt werden. Benachrichtigungen werden wieder versandt, bis sich der Host erholt. Dies ist nützlich, wenn Sie nach einer bestimmten Zeit keine weiteren Benachrichtigungen versenden wollen. Anmerkung: Wenn mehrere Eskalationseinträge eines Hosts für ein oder mehr Benachrichtigungsbereiche überlappen, wird das kürzeste Benachrichtigungsintervall aller Eskalationseinträge benutzt.| |
| | |**escalation_period**:|Diese Direktive wird benutzt, um den Kurznamen des [[#timeperiod|Zeitfensters]] anzugeben, in dem diese Eskalation gültig ist. Wenn diese Direktive nicht angegeben wird, ist diese Eskalation zu allen Zeiten gültig.| |
| | die __unterstrichenen__ Direktiven werden benötigt, die anderen sind optional. |
| | \\ |
| | \\ |
| | =====hostdependency===== |
| | 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 [[dependencies|hier]]. |
| | \\ |
| | Format der Definition:\\ |
| | |
| | |define hostdependency{|| |
| | |__dependent_host_name__|__//host_name//__| |
| | |dependent_hostgroup_name|//hostgroup_name//| |
| | |__host_name__|__//host_name//__| |
| | |hostgroup_name|//hostgroup_name//| |
| | |inherits_parent|[0/1]| |
| | |execution_failure_criteria|[o,d,u,p,n]| |
| | |notification_failure_criteria|[o,d,u,p,n]| |
| | |dependency_period|timeperiod_name| |
| | |}|| |
| | Beispieldefinition:\\ |
| | \\ <code>define hostdependency{ |
| | host_name WWW1 |
| | dependent_host_name DBASE1 |
| | notification_failure_criteria d,u |
| | } |
| | </code> Beschreibung der Direktiven:\\ |
| | |**dependent_host_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// des/der //abhängigen// [[#host|Hosts]] zu identifizieren. Mehrere Hosts werden durch Kommata von einander getrennt.| |
| | |**dependent_hostgroup_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// der //abhängigen// [[#host|Hostgruppe(n)]] zu identifizieren. Mehrere Hostgruppen werden durch Kommata von einander getrennt. Der dependent_hostgroup_name kann statt oder zusätzlich zur dependent_host_name-Direktive benutzt werden.| |
| | |**host_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// des/der [[#host|Hosts]] anzugeben, von dem "es" //abhängt// (auch als Master-Host bezeichnet). Mehrere Hosts werden durch Kommata von einander getrennt.| |
| | |**hostgroup_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// der [[#host|Hostgruppe(n)]] anzugeben, von dem "es" //abhängt// (auch als Master-Host bezeichnet). Mehrere Hostgruppen werden durch Kommata von einander getrennt. Der hostgroup_name kann statt oder zusätzlich zur host_name-Direktive benutzt werden.| |
| | |**inherits_parent**:|Diese Direktive gibt an, ob die abhängige Definition Abhängigkeiten von dem Host erbt, von dem sie //abhängt// (auch als Master-Host bezeichnet). In anderen Worten, wenn der Master-Host von anderen Hosts abhängt und eine der Abhängigkeiten fehlschlägt, dann wird auch diese Abhängigkeit fehlschlagen.| |
| | |**execution_failure_criteria**:|Diese Direktive wird benutzt, um die Kriterien festzulegen, wann der abhängige Host //nicht// aktiv geprüft werden soll. Wenn der Master-Host in einem der Zustände ist, die wir angeben, wird der //abhängige// Host nicht aktiv geprüft. Gültige Optionen sind eine Kombination von einem oder mehreren folgender Werte (mehrere Werte werden durch Kommata von einander getrennt): **o** = fehlschlagen bei einem UP-Zustand, **u** = fehlschlagen bei einem UNREACHABLE-Zustand und **p** = fehlschlagen bei einem PENDING-Zustand (d.h. der Host wurde bisher noch nie geprüft). Wenn Sie **n** (none) als Option angeben, wird die Ausführungsabhängigkeit nie fehlschlagen und die Prüfungen des abhängigen Host werden immer erfolgen (falls andere Bedingungen das erlauben). Beispiel: wenn Sie **u,d** in diesem Feld angeben, dann wird der //abhängige// Host nicht aktiv geprüft, wenn der //Master//-Service sich in einem UNREACHABLE- oder DOWN-Zustand befindet.| |
| | |**notification_failure_criteria**:|Diese Direktive wird benutzt, um die Kriterien festzulegen, wann //keine// Benachrichtigungen für den abhängigen Host versandt werden sollen. Wenn der Master-Host in einem der Fehler-Zustände ist, die wir angeben, werden keine Benachrichtigungen für den //abhängigen// Host an die Kontakte versandt. Gültige Optionen sind eine Kombination von einem oder mehreren folgender Werte: **o** = fehlschlagen bei einem UP-Zustand, **d** = fehlschlagen bei einem DOWN-Zustand, **u** = fehlschlagen bei einem UNREACHABLE-Zustand, und **p** = fehlschlagen bei einem PENDING-Zustand (d.h. der Host wurde bisher noch nie geprüft).Wenn Sie **n** (none) als Option angeben, wird die Benachrichtigungsabhängigkeit nie fehlschlagen und die Benachrichtungen für den abhängigen Host werden immer erfolgen. Beispiel: wenn Sie **d** in diesem Feld angeben, dann werden die Benachrichtigungen für den //abhängigen// Host nicht versandt, wenn der //Master//-Host sich in einem DOWN-Zustand befindet.| |
| | |**dependency_period**:|Diese Direktive wird benutzt, um den Kurznamen eines [[#timeperiod|Zeitfensters]] anzugeben, in welchem diese Abhängigkeit gültig ist. Wenn diese Direktive nicht angegeben wird, ist die Abhängigkeit zu allen Zeiten gültig.| |
| | \\ |
| | =====hostescalation===== |
| | 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 [[escalations|hier]]. |
| | \\ |
| | Format der Definition:\\ |
| | \\ |
| | Anmerkung: die __unterstrichenen__ Direktiven werden benötigt, die anderen sind optional. |
| | \\ |
| | |define hostescalation{|| |
| | |__host_name__|__//host_name//__| |
| | |hostgroup_name|//hostgroup_name//| |
| | |__contacts__|__//contacts//__| |
| | |__contact_groups__|__//contactgroup_name//__| |
| | |__first_notification__|__#__| |
| | |__last_notification__|__#__| |
| | |__notification_interval__|__#__| |
| | |escalation_period|timeperiod_name| |
| | |escalation_options|[d,u,r]| |
| | |}|| |
| | Beispieldefinition:\\ |
| | \\ <code>define hostescalation{ |
| | host_name router-34 |
| | first_notification 5 |
| | last_notification 8 |
| | notification_interval 60 |
| | contact_groups all-router-admins |
| | } |
| | </code> Beschreibung der Direktiven:\\ |
| | |**host_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// des/der [[#host|Hosts]] anzugeben, für den die Eskalation gilt.| |
| | |**hostgroup_name**:|Diese Direktive wird benutzt, um den/die //Kurznamen// der [[#host|Hostgruppen]] anzugeben, für den die Eskalation gilt. Mehrere Hostgruppen werden durch Kommata von einander getrennt. Wenn diese Direktive benutzt wird, trifft die Eskalation auf alle Hosts zu, die Mitglied der angegebenen Hostgruppe(n) sind.| |
| | |**first_notification**:|Diese Direktive ist eine Zahl, die die //erste// Benachrichtigung angibt, für die diese Eskalation gilt. Wenn Sie beispielsweise den Wert auf 3 setzen, dann wird diese Eskalation nur dann benutzt, wenn der Host lang genug "down" oder unerreichbar ist, damit eine dritte Benachrichtigung versandt wird.| |
| | |**last_notification**:|Diese Direktive ist eine Zahl, die die //letzte// Benachrichtigung angibt, für die diese Eskalation gilt. Wenn Sie beispielsweise den Wert auf 5 setzen, dann wird diese Eskalation nicht benutzt, wenn mehr als fünf Benachrichtigungen für den Host versandt werden. Wenn der Wert auf Null gesetzt wird, wird dieser Eskalationseintrag immer benutzt (unabhängig davon, wie viele Benachrichtigungen versandt werden.)| |
| | |**contacts**:|Dies ist eine Liste von //Kurznamen// der [[#contact|Kontakte]], die informiert werden sollen, wenn es Probleme (oder Erholungen) für diesen Host gibt. Mehrere Kontakte werden durch Kommata von einander getrennt. Das ist nützlich, wenn Sie Benachrichtigungen nur an ein paar Leute verschicken wollen und keine [[#contactgroup|Kontaktgruppen]] definieren wollen. Sie müssen mindestens einen Kontakt oder eine Kontaktgruppe in jeder Hosteskalations-Definition angeben.| |
| | |**contact_groups**:|Dies ist eine Liste von //Kurznamen// der [[#contact|Kontaktgruppen]], die informiert werden sollen, wenn die Host-Benachrichtigung eskaliert. Mehrere Kontaktgruppen werden durch Kommata von einander getrennt. Sie müssen mindestens einen Kontakt oder eine Kontaktgruppe in jeder Hosteskalations-Definition angeben.| |
| | |**notification_interval**:|Diese Direktive wird benutzt, um das Intervall festzulegen, in dem Benachrichtigungen versandt werden, wenn diese Eskalation gültig ist. Wenn Sie einen Wert von 0 für dieses Intervall angeben, wird Nagios die erste Benachrichtigung versenden, wenn diese Eskalation gültig wird, dann aber verhindern, dass weitere Benachrichtigungen versandt werden. Benachrichtigungen werden wieder versandt, bis sich der Host erholt. Dies ist nützlich, wenn Sie nach einer bestimmten Zeit keine weiteren Benachrichtigungen versenden wollen. Anmerkung: Wenn mehrere Eskalationseinträge eines Hosts für ein oder mehr Benachrichtungsbereiche überlappen, wird das kürzeste Benachrichtigungsintervall aller Eskalationseinträge benutzt.| |
| | |**escalation_period**:|Diese Direktive wird benutzt, um den Kurznamen des [[#timeperiod|Zeitfensters]] anzugeben, in dem diese Eskalation gültig ist. Wenn diese Direktive nicht angegeben wird, ist diese Eskalation zu allen Zeiten gültig.| |
| | |**escalation_options**:|Diese Direktive wird benutzt, um die Kriterien festzulegen, wann diese Host-Eskalation benutzt wird. Diese Eskalation wird nur benutzt, wenn der Host in einem der Zustände ist, die in dieser Direktive angeben werden. Wenn diese Direktive nicht in einer Host-Eskalation angegeben wird, ist die Eskalation für alle Host-Zustände gültig. Gültige Optionen sind eine Kombination von einem oder mehreren folgender Werte: **r** = eskalieren bei einem UP-(Erholungs)-Zustand, **d** = eskalieren bei einem DOWN-Zustand und **u** = eskalieren bei einem UNREACHABLE-Zustand. Beispiel: wenn Sie **d** in diesem Feld angeben, dann wird die Eskalation nur benutzt, wenn sich der Host in einem DOWN-Zustand befindet.| |
| | \\ |
| | =====hostextinfo===== |
| | erweiterte Hostinformations-Definition |
| | \\ Beschreibung:\\ |
| | \\ |
| | Einträge für erweiterte Hostinformationen sind grundsätzlich dazu gedacht, die Ausgaben der [[cgis#status_cgi|status]]-, |
| | [[cgis#statusmap_cgi|statusmap]]-, [[cgis#statuswrl_cgi|statuswrl]]- und [[cgis#extinfo_cgi|extinfo]]-CGIs schöner aussehen zu lassen. Sie haben keinen Einfluss auf die Überwachung und sind vollständig optional.\\ |
| | \\ |
| | <note tip>__Hinweis:__ |
| |
| | Ab Nagios 3.x sind alle Direktiven der erweiterten Hostinformations-Definition auch in den [[#host|Host-Definitionen]] verfügbar. Dadurch können Sie entscheiden, die nachstehenden Direktiven in Ihren Host-Definitionen zu benutzen, wenn es Ihre Konfigurationen vereinfacht. Separate erweiterte Hostinformations-Definitionen werden weiterhin unterstützt, um Rückwärtskompatibilität zu gewährleisten.</note> |
| | \\ |
| | 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. |
| | \\ |
| | |define hostextinfo{|| |
| | |__host_name__|__//host_name//__| |
| | |notes|//note_string//| |
| | |notes_url|//url//| |
| | |action_url|//url//| |
| | |icon_image|//image_file//| |
| | |icon_image_alt|//alt_string//| |
| | |vrml_image|//image_file//| |
| | |statusmap_image|//image_file//| |
| | |2d_coords|//x_coord,y_coord//| |
| | |3d_coords|//x_coord,y_coord,z_coord//| |
| | |}|| |
| | Beispieldefinition:\\ |
| | \\ <code>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 |
| | } |
| | </code> Variablenbeschreibungen:\\ |
| | |**host_name**:|Diese Variable wird benutzt, um den/die //Kurznamen// des/der [[#host|Hosts]] zu identifizieren, mit dem/denen diese Daten verbunden sind.| |
| | |**notes**:|Diese Direktive wird benutzt, um eine optionale Zeichenkette mit Anmerkungen zu definieren, die den Host betreffen. Wenn Sie hier eine Anmerkung angeben, werden Sie diese im [[cgis#extinfo_cgi|extended Information]]-CGI sehen (wenn Sie Informationen zu dem bestimmten Host ansehen).| |
| | |**notes_url**:|Diese Variable wird benutzt, um einen optionalen URL zu definieren, der mehr Informationen zu diesem Host bereitstellt. Wenn Sie einen URL angeben, werden Sie im [[cgis#extinfo_cgi|extended information]]-CGI einen Link namens "Extra Host Notes" sehen (wenn Sie Informationen zu dem bestimmten Host ansehen). Jeder gültige URL kann benutzt werden. Wenn Sie relative Pfade benutzen, wird der Basis-Pfad der gleiche sein, der benutzt wird, um auf die CGIs zuzugreifen (d.h. ///cgi-bin/nagios///). Dies kann sehr nützlich sein, wenn Sie detaillierte Informationen zu diesem Host, Notfallkontaktmethoden usw. für anderes Support-Personal zur Verfügung stellen wollen.| |
| | |**action_url**:|Diese Variable wird benutzt, um einen optionalen URL zu definieren, der mehr Aktionen für diesen Host bereitstellt. Wenn Sie einen URL angeben, werden Sie im [[cgis#extinfo_cgi|extended information]]-CGI einen Link namens "Extra Host Notes" sehen (wenn Sie Informationen zu dem bestimmten Host ansehen). Jeder gültige URL kann benutzt werden. Wenn Sie relative Pfade benutzen, wird der Basis-Pfad der gleiche sein, der benutzt wird, um auf die CGIs zuzugreifen (d.h. ///cgi-bin/nagios///). Dies kann sehr nützlich sein, wenn Sie detaillierte Informationen zu diesem Host, Notfallkontaktmethoden usw. für anderes Support-Personal zur Verfügung stellen wollen.| |
| | |**icon_image**:|Diese Variable wird benutzt, um den Namen eines GIF-, PNG- oder JPG-Images anzugeben, das mit diesem Host verbunden werden soll. Dieses Bild wird in den [[cgis#status_cgi|status]]- und [[cgis#extinfo_cgi|extended information]]-CGIs angezeigt. Das Bild wird am besten aussehen, wenn es 40x40 Pixel groß ist. Bilder für Hosts werden im **logos/**-Unterverzeichnis Ihres HTML-Images-Verzeichnis gesucht (d.h. ///usr/local/nagios/share/images/logos//).| |
| | |**icon_image_alt**:|Diese Variable wird benutzt, um eine optionale Zeichenkette anzugeben, die für den ALT-Tag des Bildes benutzt wird, das durch das //<icon_image>//-Argument angegeben wurde. Das ALT-Tag wird in den [[cgis#status_cgi|status]]-, [[cgis#extinfo_cgi|extended information]]- und [[cgis#statusmap_cgi|statusmap]]-CGIs benutzt.| |
| | |**vrml_image**:|Diese Variable wird benutzt, um den Namen eines GIF-, PNG- oder JPG-Images anzugeben, das mit diesem Host verbunden werden soll. Dieses Bild wird als Textur-Map für den angegebenen Host in der [[cgis#statuswrl_cgi|statuswrl]]-CGI benutzt. Anders als das Bild, das Sie in der //<icon_image>//-Variable angeben, sollte dieses möglichst //keinerlei// Transparenz haben. Wenn es das tut, wird das Host-Objekt ein wenig komisch aussehen. Bilder für Hosts werden im **logos/**-Unterverzeichnis Ihres HTML-Images-Verzeichnis gesucht (d.h. ///usr/local/nagios/share/images/logos//).| |
| | |**statusmap_image**:|Diese Variable wird benutzt, um den Namen eines Bildes anzugeben, das mit diesem Host im [[cgis#statusmap_cgi|statusmap]]-CGI verbunden werden soll. Sie können ein JPG-, PNG- oder GIF-Bild angeben, aber ich würde zu einem Bild im GD2-Format raten, weil andere Bildformate zu hohen CPU-Belastungen führen können, wenn die Statusmap generiert wird. PNG-Bilder können mit Hilfe des **pngtogd2**-Utilitys (das in Thomas Boutell's [[http://www.boutell.com/gd/|gd library]] enthalten ist) ins GD2-Format umgewandelt werden. Die GD2-Bilder werden im //unkomprimierten// Format erstellt, um die CPU-Belastung zu minimieren, während das Statusmap-CGI das Netzwerkkartenbild erstellt. Das Bild wird am besten aussehen, wenn es 40x40 Pixel groß ist. Sie können diese Option leer lassen, wenn Sie das Statusmap-CGI nicht nutzen. Bilder für Hosts werden im **logos/**-Unterverzeichnis Ihres HTML-Images-Verzeichnis gesucht (d.h. ///usr/local/nagios/share/images/logos//).| |
| | |**2d_coords**:|Diese Variable wird benutzt, um Koordinaten anzugeben, wenn der Host im [[cgis#statusmap_cgi|statusmap]]-CGI gezeichnet wird. Koordinaten sollen in positiven Ganzzahlen angegeben werden, weil sie physischen Pixeln im generierten Bild entsprechen. Der Ursprung (0,0) für die Zeichnung ist die linke, obere Ecke des Bildes, das sich in die positive X-Richtung (nach rechts) und in die positive Y-Richtung (nach unten) erstreckt. Die Größe der Icons ist normalerweise etwa 40x40 Pixel (Text benötigt etwas mehr Platz). Die Koordinaten, die Sie angeben, beziehen sich auf die linke, obere Ecke des Icons. Anmerkung: Machen Sie sich keine Sorgen über die maximalen X- und Y-Koordinaten, die Sie benutzen können. Das CGI wird automatisch die maximale Größe des zu erstellenden Bildes aufgrund der größten X- und Y-Koordinaten festlegen, die Sie angegeben haben.| |
| | |**3d_coords**:|Diese Variable wird benutzt, um Koordinaten anzugeben, die beim Zeichnen des Hosts im [[cgis#statuswrl_cgi|statuswrl]]-CGI verwendet werden. Koordinaten können positive oder negative reelle Zahlen sein. Der Ursprung für die Zeichnung ist (0.0,0.0,0.0). Die Größe des Host-Kubus ist 0,5 Einheiten auf jeder Seite (Text benötigt etwas mehr Platz). Die Koordinaten, die Sie hier angeben, beziehen sich auf das Zentrum des Host-Kubus.| |
| | \\ |
| | =====serviceextinfo===== |
| | erweiterte Serviceinformations-Definition |
| | | |
| | \\ Beschreibung:\\ |
| | \\ |
| | Einträge für erweiterte Serviceinformationen sind grundsätzlich dazu gedacht, die Ausgaben der [[cgis#status_cgi|status]]- und [[cgis#extinfo_cgi|extinfo]]-CGIs schöner aussehen zu lassen. Sie haben keinen Einfluss auf die Überwachung und sind vollständig optional. |
| | \\ |
| | \\ |
| | <note tip>__Hinweis:__ |
| | |
| | Ab Nagios 3.x sind alle Direktiven der erweiterten Serviceinformations-Definition auch in den [[#service|Service-Definitionen]] verfügbar. Dadurch können Sie entscheiden, die nachstehenden Direktiven in Ihren Service-Definitionen zu benutzen, wenn es Ihre Konfigurationen vereinfacht. Separate erweiterte Serviceinformations-Definitionen werden weiterhin unterstützt, um Rückwärtskompatibilität zu gewährleisten.</note> |
| | \\ |
| | 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. |
| | \\ |
| | |define serviceextinfo{|| |
| | |__host_name__|__//host_name//__| |
| | |__service_description__|__//service_description//__| |
| | |notes|//note_string//| |
| | |notes_url|//url//| |
| | |action_url|//url//| |
| | |icon_image|//image_file//| |
| | |icon_image_alt|//alt_string//| |
| | |}|| |
| | Beispieldefinition:\\ |
| | \\ <code>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 |
| | } |
| | </code> Variablenbeschreibungen:\\ |
| | |**host_name**:|Diese Variable wird benutzt, um den/die //Kurznamen// des/der [[#host|Hosts]] zu identifizieren, mit dem/denen der Service verbunden sind.| |
| | |**service_description**:|Diese ist die Beschreibung des [[#service|Service]], mit dem/denen diese Daten verbunden sind.| |
| | |**notes**:|Diese Direktive wird benutzt, um eine optionale Zeichenkette mit Anmerkungen zu definieren, die den Service betreffen. Wenn Sie hier eine Anmerkung angeben, werden Sie diese im [[cgis#extinfo_cgi|extended Information]]-CGI sehen (wenn Sie Informationen zu dem bestimmten Service ansehen).| |
| | |**notes_url**:|Diese Variable wird benutzt, um einen optionalen URL zu definieren, der mehr Informationen zu diesem Service bereitstellt. Wenn Sie einen URL angeben, werden Sie im [[cgis#extinfo_cgi|extended information]]-CGI einen Link namens "Extra Service Notes" sehen (wenn Sie Informationen zu dem bestimmten Service ansehen). Jeder gültige URL kann benutzt werden. Wenn Sie relative Pfade benutzen, wird der Basis-Pfad der gleiche sein, der benutzt wird, um auf die CGIs zuzugreifen (d.h. ///cgi-bin/nagios///). Dies kann sehr nützlich sein, wenn Sie detaillierte Informationen zu diesem Host, Notfallkontaktmethoden usw. für anderes Support-Personal zur Verfügung stellen wollen.| |
| | |**action_url**:|Diese Variable wird benutzt, um einen optionalen URL zu definieren, der mehr Aktionen für diesen Service bereitstellt. Wenn Sie einen URL angeben, werden Sie im [[cgis#extinfo_cgi|extended information]]-CGI einen Link namens "Extra Service Notes" sehen (wenn Sie Informationen zu dem bestimmten Service ansehen). Jeder gültige URL kann benutzt werden. Wenn Sie relative Pfade benutzen, wird der Basis-Pfad der gleiche sein, der benutzt wird, um auf die CGIs zuzugreifen (d.h. ///cgi-bin/nagios///). Dies kann sehr nützlich sein, wenn Sie detaillierte Informationen zu diesem Host, Notfallkontaktmethoden usw. für anderes Support-Personal zur Verfügung stellen wollen.| |
| | |**icon_image**:|Diese Variable wird benutzt, um den Namen eines GIF-, PNG- oder JPG-Images anzugeben, das mit diesem Service verbunden werden soll. Dieses Bild wird in den [[cgis#status_cgi|status]]- und [[cgis#extinfo_cgi|extended information]]-CGIs angezeigt. Das Bild wird am besten aussehen, wenn es 40x40 Pixel groß ist. Bilder für Service werden im **logos/**-Unterverzeichnis Ihres HTML-Images-Verzeichnis gesucht (d.h. ///usr/local/nagios/share/images/logos//).| |
| | |**icon_image_alt**:|Diese Variable wird benutzt, um eine optionale Zeichenkette anzugeben, die für den ALT-Tag des Bildes benutzt wird, das durch das //<icon_image>//-Argument angegeben wurde. Das ALT-Tag wird in den [[cgis#status_cgi|status]]-, [[cgis#extinfo_cgi|extended information]]- und [[cgis#statusmap_cgi|statusmap]]-CGIs benutzt.| |