Systemkatalog › Überwachungs-Appliances › MON: Appliance zur Anwendungsüberwachung

MON: Appliance zur Anwendungsüberwachung

Aktuelle Version: 3.0.3-1

Funktionsübersicht

MON ist eine Appliance zur Anwendungsüberwachung, die Leistungs- und Ressourcenverwendungsstatistiken (also Zähler) von anderen Appliances innerhalb einer Anwendung erfasst. Appliances melden ihre Zähler der MON-Appliance über das Terminal "mon".

MON stellt eine visuelle Schnittstelle bereit, bei der mithilfe eines Webbrowsers auf die Appliance-Zähler zugegriffen wird und in dem diese angezeigt werden. Über die visuelle Schnittstelle erstellt der Benutzer Ansichten mit einem oder mehreren Diagrammen. Jedes Diagramm zeigt einen oder mehrere Appliance-Zähler an. Der Zugriff auf die visuelle Schnittstelle erfolgt über:

• die CA 3Tera AppLogic-GUI
  • eine Schaltfläche "Überwachen" am unteren Rand der Registerkarte "Anwendungen" des Dashboards
  • ein Symbol "Überwachen" in der Symbolleiste des Anwendungs-Editors
• über ein Gateway (d. h. IN- oder INSSLR-Gateway), das mit dem am Web-Terminal von MON verbunden ist

Weitere Einzelheiten zum Zugreifen auf und Verwenden der visuellen Schnittstellen finden Sie im Referenzhandbuch zur Benutzeroberfläche.

MON unterstützt außerdem die Hintergrundüberwachung von Appliance-Zählern. Alle Zähler in einer einzelnen Ansicht, wie durch die Eigenschaft "alarm_view" definiert, werden von MON im Hintergrund überwacht. Wann einer dieser Zähler einen angegebenen Schwellenwert unter- oder überschreitet, sendet MON einen Alarm zur Grid-Steuerung in CA 3Tera AppLogic, die eine Meldung an das Dashboard schickt. MON überwacht die Appliance-Zähler im Hintergrund auch, wenn kein Browser für die visuelle Schnittstelle von MON geöffnet ist.

Begrenzung

Ressourcen

Terminals

Die Standardschnittstelle. Die Standardschnittstelle wird von der Appliance verwendet, um an CA 3Tera AppLogic zu berichten, dass sie erfolgreich gestartet wurde. Sie kann auch dazu dienen, über eine sichere Shell eine Anmeldung vom CA 3Tera AppLogic-Controller zur Appliance herzustellen, hauptsächlich für Diagnosen und Fehlerbehebung. Mithilfe der Standardschnittstelle kann die CA 3Tera AppLogic-GUI auf die visuelle Schnittstelle einer MON-Appliance zugreifen.

Benutzer-Volumes

Eigenschaften

Fehlermeldungen

Die folgenden Meldungen können entweder in der Appliance-Protokolldatei oder im Systemprotokoll der Grid-Steuerung angezeigt werden, wenn die Appliance nicht startet:

• Daten-Volume konnte nicht geladen werden

httpd wurde nicht gestartet

Zählergruppen und Zähler

Die folgenden Zählergruppen sind für alle Appliances definiert:

• CPU-Übersicht
• CPU n (nur bei mehr als einer CPU -- anderenfalls gibt diese Gruppe(n) nicht)
• Scheduler
• Speicherstatistik
• Dateisystem
• Schnittstellen-Name (eine Gruppe für jede Schnittstelle: Terminals oder Raw)
• Volume-Name (eine Gruppe pro Volume, einschließlich Klasse und Platzhalter)

Informationen zum Erstellen und Überwachen von benutzerdefinierten Zählern in einer Appliance finden Sie unter Erstellen benutzerdefinierter Zähler.

Typische Verwendung

Überwachen von Anwendungen über die CA 3Tera AppLogic-GUI

Das folgende Diagramm zeigt eine typische Verwendung von MON für eine einfache Anwendung. In dieser Anwendung können Sie nur über die CA 3Tera AppLogic-GUI auf die Überwachung zugreifen.

Verwendete Appliances:

• in - Eingabe-Gateway, Klasse IN
• srv - Webserver, Klasse WEB5
• db - Datenbankserver, Klasse MYSQL5
• mon - Überwachungs-Appliance, Klasse MON

Das Terminal "mon" aller Appliances ist mit dem Terminal "mon" von "mon" verbunden.

Überwachen der Anwendung sowohl über die CA 3Tera AppLogic-GUI als auch über eine IP-Adresse auf Port 80

Das folgende Diagramm zeigt, wie MON für den Zugriff auf die Anwendungsüberwachung über die CA 3Tera AppLogic-GUI oder über eine IP-Adresse verwendet werden kann.

Verwendete Appliances:

• usr - Eingabe-Gateway, Klasse IN
• admin - Eingabe-Gateway, Klasse IN
• srv - Webserver, Klasse WEB5
• db - Datenbankserver, Klasse MYSQL5
• mon - Überwachungs-Appliance, Klasse MON

Das Terminal "mon" aller Appliances ist mit dem Terminal "mon" von "mon" verbunden.

Das Terminal "out" von admin wird mit dem Terminal "web" von MON verbunden, damit Benutzer über die IP-Adresse, die durch die Eigenschaft ip_addr auf admin festgelegt ist, auf die Überwachung zugreifen können.

Überwachen der Anwendungen sowohl über die CA 3Tera AppLogic-GUI als auch über eine Anwendungs-IP-Adresse auf Port 8080

Das folgende Diagramm zeigt, wie MON für den Zugriff auf die Anwendungsüberwachung über die CA 3Tera AppLogic-GUI oder über eine IP-Adresse auf Port 8080 verwendet werden kann.

Verwendete Appliances:

• INSSLR - Eingabe-Gateway, Klasse INSSLR
• WEBx8 - Webserver-Assembly, Klasse WEBx8
• MYSQL - Datenbankserver, Klasse MYSQL5
• NAS - Speicher-Appliance, Klasse NAS
• PS8 - Port-Schalter, Klasse PS8
• mail - Mail-Server, Klasse MAIL
• NET - Eingabe-Gateway, Klasse NET
• mon - Überwachungs-Appliance, Klasse MON

Das Terminal "mon" aller Appliances ist mit dem Terminal "mon" von "mon" verbunden.

INSSLR ist so konfiguriert, dass HTTPS-Datenverkehr zu WEBx8 und der andere TCP-Datenverkehr zum Terminal "aux" weitergeleitet wird. PS8 ist so konfiguriert, dass der gesamte Datenverkehr auf Port 8080 über out8 zum Terminal "web" von mon geleitet wird. Dadurch können Benutzer die Anwendung über die Anwendungs-IP-Adresse überwachen, die durch die Eigenschaft ip_addr auf INSSLR auf Port 8080 festgelegt ist.

Hinweis: Die MAIL-Appliance wird nicht mit CA 3Tera AppLogic bereitgestellt.

Hintergrundüberwachung

Dieser Anwendungsfall beschreibt, wie Sie MON für die Hintergrundüberwachung der Appliance-Zähler verwenden und die Appliance so einstellen , dass Warnungen generiert werden, wenn ein Appliance-Zähler außerhalb des Bereichs liegt.

1. Legen Sie für die Eigenschaft "alarm_view" auf MON den Namen einer Ansicht fest, die die zu überwachenden Zähler enthält.
2. Starten Sie die Anwendung (neu).
3. Melden Sie sich bei der Anwendungsüberwachung an.
4. Klicken Sie auf die Schaltfläche "Neu", um eine neue Ansicht zu erstellen, und geben Sie ihr denselben Namen wie der Eigenschaft "alarm_view".
5. Klicken Sie auf die Schaltfläche zum Hinzufügen eines Diagramms, um ein neues Diagramm zu erstellen und es der Ansicht hinzuzufügen.
6. Wählen Sie einen Zähler aus, der überwacht werden soll, und fügen Sie ihn in das Diagramm ein.
7. Legen Sie den Alarmschwellenwert fest, indem Sie die beiden Felder neben "Alarm" ausfüllen.
   Um einen minimalen Schwellenwert festzulegen, geben Sie einen Wert ins linke Textfeld ein. Es gibt keinen minimalen Schwellenwert, wenn dieses Textfeld leer gelassen wird.
   Um einen maximalen Schwellenwert festzulegen, geben Sie einen Wert ins rechte Textfeld ein. Es gibt keinen maximalen Schwellenwert, wenn dieses Textfeld leer gelassen wird.
8. Wiederholen Sie die Schritte 5 bis 7, um weitere Appliance-Zähler zu überwachen.

Wenn ein Appliance-Zähler den angegebenen Schwellenwert unter- oder überschreitet, generiert MON eine Warnung bei der CA 3Tera AppLogic-Steuerung. Anschließend wird eine Meldung auf dem Dashboard protokolliert, die angibt, welcher Zähler von welcher Appliance außerhalb des Bereichs liegt. Für jede Appliance protokolliert die CA 3Tera AppLogic-Steuerung nur die letzte Warnmeldung auf dem Dashboard, allerdings wird in der Dashboard-Nachricht angegeben, ob für die Appliance mehrere Warnungen empfangen wurden. Alle Warnmeldungen werden auf /var/log/messages in der CA 3Tera AppLogic-Steuerung protokolliert.

Hinweis: MON überwacht die Appliance-Zähler im Hintergrund auch, wenn kein Browser für die Anwendungsüberwachung geöffnet ist.

So beenden Sie die Überwachung eines bestimmten Appliance-Zählers:

• Wenn der Zähler der einzige Zähler im Diagramm ist, löschen Sie das Diagramm.
• Wenn der Zähler sich in einem Diagramm mit mehreren Zählern befindet, entfernen Sie den Zähler aus dem Diagramm.

Um die Hintergrundmonitoring zu deaktivieren, führen Sie einen der folgenden Vorgänge aus:

• Benennen Sie die Ansicht in einen Namen um, der sich von der Eigenschaft "alarm_view" in MON unterscheidet.
• Löschen Sie alle Diagramme in der Ansicht.
• Löschen Sie die Ansicht.
• Halten Sie die MON-Appliance in der Anwendung an (z. B. comp stop myapp:main.mon).

Löschen Sie die Eigenschaft "alarm_view" in MON, und starten Sie die MON-Instanz neu (oder starten Sie die Anwendung neu).

Datenerfassungsschnittstelle

Seit Version 1.1.3 bietet die MON-Appliance eine dem REST-Dienst ähnliche Datenerfassungs-API. Sie exportiert Zählerkonfiguration und Werte im XML-, JSON- und UDL-Format. Weitere Informationen zur API finden Sie auf MonDataCollectionInterface.

Hinweise

Bekannte Beschränkungen

Um eine Anwendung über die CA 3Tera AppLogic-GUI überwachen zu können, muss der Name der MON-Appliance in der Anwendung "mon" lauten.

In der Appliance verwendete Open-Source- und Drittanbieter-Software

Appliance-Zähler

Liste standardmäßiger Appliance-Zähler

Übersicht

Dieses Dokument definiert die Liste aller standardmäßigen, von CCA exportierten Zähler. CCA ist der Zählererfassungsagent, der in allen CA 3Tera AppLogic-Appliances ausgeführt wird. Mit CCA können Sie Zähler bei der Überwachungs-Appliance melden, die von der MON-Appliance angezeigt wird. Die Verfügbarkeit dieser Zähler kann auf einigen der unterstützten Appliance-Plattformen eingeschränkt sein (wie in der Zählertabelle unten aufgeführt). Wenn das Appliance-Betriebssystem einen bestimmten Zähler unterstützt, muss er in der MON-GUI angezeigt werden, wenn das MON-Ausgabe-Terminal der Appliance an die MON-Appliance angeschlossen ist.

CPU-Übersicht

Dateisystem

Speicherstatistik

Scheduler

CPU#X

Volume X

Terminal X

Benutzerdefinierte Zähler

Übersicht

Jede Appliance, die den ccad-Daemon (ccad - counter collection agent) ausführt, lässt das Definieren von benutzerdefinierten Zählern und die Erfassung durch Hilfsprogramme von Drittanbietern zu. Diese Fähigkeit wird Erweiterungsschnittstelle genannt und bietet Appliance-Erstellern die Möglichkeit, appliance-spezifische Zählerdaten über die standardmäßige MON-Benutzeroberfläche zu überwachen.

Erstellen benutzerdefinierter Zähler

Um benutzerdefinierte Zähler zu überwachen, müssen Sie der ccad-Konfiguration Zählerdefinitionen hinzufügen und die tatsächlichen Zählerwerten an ccad weiterleiten.

Hinzufügen von Zählerdefinitionen

Die benutzerdefinierten Zähler müssen in der optionalen Konfigurationsdatei /etc/ccad.conf (in UDL-Format) definiert werden. Wenn Sie an der Konfiguration Änderungen vornehmen, muss der ccad-Daemon neu gestartet werden, damit die Änderungen wirksam werden.

Hier sehen Sie eine einfache Beispielkonfiguration:

counters Apache
   {
   pace = 1000
   pipe = /tmp/cca
   counter Total_Accesses
      {
      name        = "Total hits"
      desc        = "Total number of hits"
      units       = "#"
      type        = "MAX"
      }
   counter Total_kBytes
      {
      name        = "Total bytes"
      desc        = "Total number of bytes"
      units       = "bytes"
      type        = "MAX"
      }
   counter BusyWorkers
      {
      name        = "Active requests"
      desc        = "Number of active requests"
      units       = "#"
      type        = "MAX"
      }
   counter IdleWorkers
      {
      name        = "Idle servers"
      desc        = "Number of idle servers"
      units       = "#"
      type        = "MAX"
      }
   }

In diesem Beispiel werden 4 Zähler definiert. Jede Zählerentität unterstützt die folgenden Attribute:

• name - visuell lesbarer Name des Zählers (standardmäßiger Name ist der Entitätsname)
• desc - visuelle lesbare Beschreibung des Zählers (standardmäßig leer)
• type - Typ des Zählers (SUM, AVG, MIN oder MAX, Standardwert: AVG)
• units - Einheiten, in denen die Zählerwerte interpretiert werden müssen (standardmäßig leer)
• range_lower - der niedrigste mögliche Wert dieses Zählers (kleinere Werte werden entfernt)
• range_upper - der höchste mögliche Wert dieses Zählers (größere Werte werden entfernt)
• alarm_below - der niedrigste Wert des Zählers, bei dem kein Alarm ausgelöst wird (kleinere Werte lösen Alarm aus)
• alarm_above - der höchste Wert des Zählers, bei dem kein Alarm ausgelöst wird (größere Werte lösen Alarm aus)

Der Name der Zählerentität auf Stammebene wird als Entitätsname verwendet, wenn die Zähler später in MON angezeigt werden. Zusätzlich sind für diese Entität die folgenden Attribute von Bedeutung:

• pace - Geschwindigkeit (in Millisekunden) der Erfassung des benutzerdefinierten Zählers (1000, sofern nicht angegeben)
• pipe - Pfad zur Named Pipe, die für die Erfassung verwendet wird (/tmp/cca, sofern nicht angegeben)

Zusätzlich zur oben beschriebenen Methode zur Zählerdefinition können die Zähler mit ccad.conf auch in Gruppen zusammengefügt werden. Dazu müssen sie eine Ebene tiefer in den Gruppenentitäten platziert werden, wie im folgenden Beispiel gezeigt:

counters Plants
   {
   pace = 2000
   pipe = /my-pipe
   counter tree: desc = "Any tree" , units = "#"
   group Fruits
      {
      desc = "Delicious Fruits!!!"
      counter pears : desc = "Number of pears"   , units = "pears"
      counter apples: desc = "Number of apples"  , units = "apples"
      }
   group Vegetables
      {
      counter potato: desc = "Number of potatoes", units = "potatoes"
      counter tomato: desc = "Number of tomatoes", units = "tomatoes"
      }
   }

Mit dieser Konfiguration würden 3 benutzerdefinierte Zählerentitäten in der MON-GUI erzeugt - Plants, Delicious Fruits!!! und Vegetables, wobei die 5 definierten Zähler unter diesen Entitäten verteilt würden. Gruppen unterstützen ein Beschreibungsattribut "desc" (wie Zählerentitäten), mit dem ein umfassenderer Gruppenname definiert werden kann im Gegensatz zum eingeschränkteren Gruppenentitätsnamen. Zählernamen sollten in der gesamten Konfigurationsdatei eindeutig sein; anderenfalls ist die Zählererfassung bei doppelten Zählernamen nicht möglich.

Eingeben von Zählerdaten

Wenn ccad mit den richtigen Zählerdefinitionen ausgeführt wird, müssen Sie die tatsächlichen Zählerwerte eingeben. Schreiben Sie die Zählerwerte dazu in die von ccad erstellte Named Pipe (vom Pipe-Attribut in /etc/ccad.conf, default /tmp/cca angegeben).
Sie können eines der folgenden Formate wählen:

Zähler = Wert (Name und Wert sind durch = getrennt)

Zähler : Wert (Name und Wert sind durch : getrennt)
Ein Zählersatz sollte durch Drucken eines Punkts (.) oder Seitenvorschubzeichens (\f) in der Named Pipe auf einer eigenen Zeile (in MON) geleert werden. Mit einem Zählererfassungsskript (in Bash) könnten Zählerwerte folgendermaßen an ccad weitergeleitet werden:

echo "Total_Accesses = 31" > /tmp/cca
echo "Total_kBytes = 22241" > /tmp/cca
echo "BusyWorkers = 6" > /tmp/cca
echo "IdleWorkers = 34" > /tmp/cca
echo "." > /tmp/cca

Dies sollte nach der in /etc/ccad.conf unter "pace" festgelegten Anzahl Millisekunden wiederholt werden.

Hier sehen Sie eine einfache Bash-Schleife, mit der die benötigten Daten erfasst und an ccad weitergeleitet werden. Es werden mehr Daten als benötigt eingegeben, das es schneller ist, alle erfassten Daten an ccad weiterzuleiten (die Zeilen, die keine Zählerwerte sind, werden ignoriert), als die Daten vor der Weiterleitung an ccad zu analysieren:

while true; do
   curl -s http://in/server-status?auto | sed "s/^Total\ /Total_/g" > /tmp/cca # this parses the data so it matches out counter definitions
   sleep 1 || exit 4        
   echo "." > /tmp/cca

done

Beispiele

Apache

Hinweis: Auf dem Server muss der "erweiterte Status" aktiviert sein.

#!/bin/bash

DEFAULT_PACE=1000
DEFAULT_PIPE=/tmp/cca
CCAD_CONF=/etc/ccad.conf
STATUS_URL='http://in/server-status?auto'
CURL=/usr/bin/curl
SED=/bin/sed
SLEEP=/bin/sleep
function get_value_from_config {
   CONF_VALUE=`grep -oE "$1[[:space:]]*=[[:space:]]*[^[:space:]]+" $CCAD_CONF |cut -d"=" -f 2|tr -d " "`
}
get_value_from_config "pace"
PACE=${CONF_VALUE:-$DEFAULT_PACE}
PACE=$(( $PACE / 1000 ))
get_value_from_config "pipe"
PIPE=${CONF_VALUE:-$DEFAULT_PIPE}
test -p $PIPE || exit 3
while true; do
   $CURL -s "$STATUS_URL" | $SED "s/^Total\ /Total_/g" > $PIPE
   sleep $PACE || exit 4
   echo "." > $PIPE
done

Mysql

#!/bin/bash

DEFAULT_PACE=1000
DEFAULT_PIPE=/tmp/cca
CCAD_CONF=/etc/ccad.conf
MYSQL='/usr/bin/mysql'
TR=/usr/bin/tr
SLEEP=/bin/sleep
function get_value_from_config {
   CONF_VALUE=`grep -oE "$1[[:space:]]*=[[:space:]]*[^[:space:]]+" $CCAD_CONF |cut -d"=" -f 2|tr -d " "`
}
get_value_from_config "pace"
PACE=${CONF_VALUE:-$DEFAULT_PACE}
PACE=$(( $PACE / 1000 ))
get_value_from_config "pipe"
PIPE=${CONF_VALUE:-$DEFAULT_PIPE}
test -p $PIPE || exit 3
while true; do
   $MYSQL -e 'show status'|$TR '[[:blank:]]' '=' > $PIPE
   $SLEEP $PACE || exit 4
   echo "." > $PIPE
done

Zählererfassungs- Webdienst-API

Überwachungs-API – Übersicht

Die MON-Appliance exportiert Zähler- und Konfigurationsdaten von über das AUX-Ausgabe-Terminal verbundenen Appliances. Dies geschieht über ein benutzerdefiniertes Protokoll auf REST-Basis über HTTP. Dieses Protokoll definiert 3 Typen von Ressourcen:

• Appliances
• Entitäten
• Zähler

Jeder dieser Typen ist im Kontext des vorangehenden Typs zu verstehen, d. h. Entitäten haben nur innerhalb von Appliances Bedeutung, und Zähler haben nur innerhalb einer bestimmten Entität Bedeutung. Die Datenerfassungs-API ermöglicht das Abrufen aller Zählerkonfigurationen und Werte, die MON bekannt sind.

MON exportiert angeforderte Datenkonfigurationen und Werte in einem der folgenden strukturierten Textformate:

• XML (primäres Format; wird verwendet, wenn kein bestimmtes Format über das "fmt"-Argument angefordert wird)
• UDL (für die innerbetriebliche Verwendung von CA 3Tera AppLogic)

JSON (für JavaScript-fähige Browserclients)

Überwachungs-API-Protokoll

Das Protokoll verwendet nur die HTTP-Methode GET, da es nur über Lesefunktionen verfügt. So kann jeder unterstützte Protokollanfragetyp über seine URI und die Ausgabestruktur definiert werden. Zeichen, die in der URI als Sonderzeichen gelten, sollten mit der standardmäßigen %-Kodierung maskiert werden. Die Ausgabe wird nach ihrem XML-Schema definiert (das primäre Ausgabeformat ist XML). Die Übersetzung in andere Ausgabeformate (UDL, JSON) wird durch die direkte Verwendung des Struktur- und Attributschemas des jeweiligen Ausgabeformats erreicht (zum Beispiel UDL-Entitäten vs. XML-Entitäten, UDL-Attribute vs. XML-Attribute, JSON-Objekte vs. XML-Entitäten, JSON-Objekteigenschaften vs. XML-Attribute).

Der Stammknoten aller Ausgaben enthält ein Zeitstempelattribut, das die Serverzeit zum Erstellungszeitpunkt der Antwort angibt.

Nachfolgend finden Sie eine Beschreibung aller unterstützten URLs (Aufrufe).

Zählerkonfigurationsaufrufe

/monapi/desc[?fmt=Default] 

Gibt eine Liste aller verfügbaren Appliances in einem bestimmten Ausgabeformat zurück (Default steht für eines der bekannten Ausgabeformate, zum Beispiel XML).

Ausgabe:

<response timestamp="1194967464">
   <appliance name="main.web" />
   <appliance name="main.in" />
</response>

Zählerwertaufrufe

/monapi/val/<Appliances>/<Entitäten>/<Zähler>[?fmt=Default] 

Gibt die Werte der angegebenen Zähler zurück. Wenn einer der Parameter (für Appliances, Entitäten oder Zähler) ausgelassen wird, wird ein Wildcard-Wert angenommen. So bedeutet beispielsweise /monapi/val/main.web "die Werte aller Zähler aller Entitäten der "main.web"-Appliance".

Ausgabe:

<response timestamp="1194967464">
   <appliance name="main.web">
      <entity name="Terminal in">
         <counter name="Sent bytes" value="23234" />
         <counter name="Received bytes" value="690432" />
      </entity>
   </appliance>
</response>