# NagiosBP-Backend

Das NagiosBP-Backend wird benutzt, NagVis direkt mit den Nagios Business Process-Addons zu verbinden, die verwendet werden, um aus den Nagios-Statusinformationen Geschäftsprozessaggregationen zu erstellen.

## Die NagiosBP-API

NagiosBP bietet einen Web-Service, der durch HTTP-Get-Anfragen aufgerufen wird und mit JSON-Objekten antwortet. Die Dokumentation dieser JSON-API finden Sie hier.

## Darstellung in NagVis

Dieses Backend ist besonders verglichen mit den anderen Backends, die Nagios-Statusinformationen 1:1 behandeln. Dieses Backend verarbeitet hauptsächlich Geschäftsprozesse, aber auch Nagios-Zustandsinformationen. Als Ergebnis dieser Tatsache muss das Backend eine Art von Übersetzung durchführen, um aus den Geschäftsprozessen Nagios-ähnliche Objekte zu erzeugen.

Während der Entwicklung dieses Backends stellte sich heraus, dass die Geschäftsprozesse auf Servicegruppen-Objekte abgebildet werden sollten. Daraus ergeben sich zwei Dinge:

- Jeder Geschäftsprozess resultiert in einer Servicegruppe
- Das Backend liefert nur Servicegruppen-Objekte (die anderen Objekte müssen mit den anderen Backends direkt von Nagios geholt werden)

Eine andere besondere Eigenschaft des NagiosBP-Backends besteht darin, dass NagVis nicht die Gesamt- (aggregierten) Zustände mit eigenen Algorithmen berechnen muss. Statt dessen setzt das NagiosBP-Backend die Zustände/Ausgaben der NagiosBP-Servicegruppen mit Hilfe der von NagiosBP gelieferten Zustandsinformationen.

Die Servicegroup-Verweise (Links-Klick auf Icon) werden automatisch durch das NagiosBP-Backend gesetzt, um auf die NagiosBP-GUI zu zeigen, außer wenn der `url`-Parameter der Servicegruppe konfiguriert ist, um auf eine andere Map zu zeigen (z.B. `[htmlbase]/index.php?mod=Map&act=view&show=bp-webshop-details`).

## Konfiguration

Sie können die folgenden Parameter benutzen, um das NagiosBP-Addon zu konfigurieren:

Wert | Default | Beschreibung
--- | --- | ---
base_url | http://localhost/nagios/cgi-bin/nagios-bp.cgi | Die vollständige URL zum `nagios-bp.cgi`-Script, das Teil von NagiosBP ist. Es bedient die AJAX-API, mit der sich das Backend verbindet. Diese URL muss von dem Host erreichbar sein, auf dem NagVis läuft.
auth_user |  | Optionaler Benutzer, der als Basic-Authentifizierungs-Benutzer benutzt werden soll, um auf die `base_url` zuzugreifen.
auth_pass |  | Optionales Passwort, das als Basic-Authentifizierungs-Passwort benutzt werden soll, um auf die `base_url` zuzugreifen.

Es gibt auch einige allgemeine Parameter. Sie finden sie in der Formatbeschreibung der Hauptkonfigurationsdatei.