Aufbau der GRMG-Antwort
Definition
Eine GRMG-Antwort ist ein XML-Dokument, das von einer GRMG-Anwendung an die GRMG-Infrastruktur gesendet wird. Es enthält die folgenden Daten:
· Information zum Szenario, in dem eine Überwachung mit GRMG stattfindet
· Informationen zur Komponente, die mit GRMG überwacht wird
· Meldung(en), die Informationen zur Verfügbarkeit der überwachten Komponenten enthalten
Die GRMG-Antwort wird mit Hilfe der GRMG-Java-Klassen bzw. durch die ABAP-Standardklassen durch die GRMG-Anwendung erzeugt (siehe Prinzip der Erstellung einer GRMG-Anwendung).
Verwendung
Nach der Durchführung aller Überwachungsfunktionen, die die GRMG-Anwendung nach Empfang der GRMG-Anfrage durchführen muss, erstellt die GRMG-Anwendung ein XML-Dokument, das die Ergebnisse dieser Tests zusammenfasst, und sendet diese GRMG-Antwort zurück an die GRMG-Infrastruktur. Die GRMG-Infrastruktur interpretiert diese Antwort und gibt sie in einem Monitorbaum des Alert-Monitors aus.
Struktur
Die GRMG-Antwort hat die folgende Struktur (in der GRMG-Antwort werden die Datentypen der einzelnen Tags in eckigen Klammern angegeben):
<?xml version="1.0" encoding="UTF-8"?>
<scenario>
<scenname> [CHAR(8)] </scenname>
<scenversion> [CHAR(3)] </scenversion>
<sceninst> [CHAR(3)] </sceninst>
<component>
<compname> [CHAR(8)] </compname>
<compversion> [CHAR(3)] </compversion>
<comphost> [CHAR(15)] </comphost>
<compinst> [CHAR(2)] </compinst>
<messages>
<message>
<messalert> [CHAR(8)] </messalert>
<messseverity> [CHAR(3)] </messseverity>
<messarea> [CHAR(20)] </messarea>
<messnumber> [CHAR(3)] </messnumber>
<messparam1> [CHAR(120)] </messparam1>
<messparam2> [CHAR(120)] </messparam2>
<messparam3> [CHAR(120)] </messparam3>
<messparam4> [CHAR(120)] </messparam4>
<messtext> [CHAR(50)] </messtext>
</message>
..
</messages>
</component>
..
</scenario>
Die Werte der folgenden Tags werden aus der GRMG-Anfrage übernommen, sie haben die folgenden Bedeutungen:
Tag-Name |
Bedeutung |
scenario |
Tag zur Zusammenfassung eines Szenarios |
scenname |
technischer Name des GRMG-Szenarios |
scenversion |
Version des GRMG-Szenarios (> 0) |
sceninst |
Instanz des GRMG-Szenarios (> 0) |
component |
Tag zur Zusammenfassung einer Komponente |
compname |
technischer Name der überwachten Komponente |
compversion |
Version der überwachten Komponente (> 0) |
Die Werte der folgenden Tags müssen in der GRMG-Anwendung gesetzt werden, sie haben die folgenden Bedeutungen:
Tag-Name |
Bedeutung |
comphost |
Name des Host, auf dem die überwachte Komponente läuft |
compinst |
Ordnungszahl der überwachten Instanz, auf der die Komponente läuft; dieser Wert wird nicht in der GRMG-Anfrage gesetzt, sondern wird von der GRMG-Anwendung ermittelt
Beachten Sie beim Programmieren einer GRMG-Anwendung, dass Sie diesen Wert korrekt setzen. Falls der Wert nicht gesetzt ist, wird er von der GRMG-Infrastruktur auf Unknown gesetzt und so in der Monitoring-Architektur dargestellt. Außerdem werden die Verfügbarkeitswerte nicht versorgt. Bei einer Instanz setzen Sie den Wert auf 001. Bei mehreren gleichen Komponenten auf verschiedenen Instanzen (z. B. der J2EE Engine) auf einem Host sorgen Sie durch verschiedene Werte von compinst dafür, dass jede Komponente eindeutig addressierbar ist. |
messages |
Tag zur Zusammenfassung von Meldungen |
message |
Tag zur Zusammenfassung einer einzelnen Meldung |
messalert |
Ergebnis der Meldung; zwei Werte werden unterstützt: OKAY: zugehörige Meldungen werden in der Monitoring-Architektur in der Farbe Grün dargestellt ERROR: zugehörige Meldungen generieren in der Monitoring-Architektur einen roten Alert |
messseverity |
Gewichtung eines Alerts: ein Zahlenwert zwischen 000 und 255, mit dem Alerts derselben Farbe priorisiert werden. Je größer diese Zahl, desto bedeutender ist der entsprechende Alert; im Alert-Monitorbaum wird bei gleicher Alert-Farbe der Alert mit der größeren Gewichtung nach oben propagiert. Der Standard für die Gewichtung eines Alerts in der Monitoring-Architektur ist 50. |
messarea |
Meldungsklasse einer SAP-T100-Meldung, die in die Monitoring-Architektur übermittelt wird; falls die entsprechende Meldung im zentralen Monitoring-System nicht existiert, wird die Meldung in messtext ausgegeben |
messnumber |
Meldungsnummer einer SAP-T100-Meldung, die in die Monitoring-Architektur übermittelt wird; messnumber ist eine Zahl zwischen 000 und 999 |
messpara1 |
Parameter 1 einer SAP-T100-Meldung, falls diese angegeben ist |
messpara2 |
Parameter 2 einer SAP-T100-Meldung, falls diese angegeben ist |
messpara3 |
Parameter 3 einer SAP-T100-Meldung, falls diese angegeben ist |
messpara4 |
Parameter 4 einer SAP-T100-Meldung, falls diese angegeben ist |
messtext |
Meldungstext Geben Sie immer einen Wert für dieses Element zurück. Falls Sie sowohl eine SAP-T100-Meldung als auch einen Meldungstext übergeben, wird in der GRMG-Infrastruktur nur dann dieser Meldungstext ausgegeben, falls die entsprechende SAP-T100-Meldung nicht existiert. |
Um Meldungen der GRMG-Infrastruktur zu übergeben, haben Sie also zwei Möglichkeiten:
· Sie geben eine Meldungsklasse und eine Meldungsnummer an, zu denen im SAP-Web-AS-System eine Meldung definiert ist
· Sie geben einen statischen Meldungstext an
SAP empfiehlt, dass Sie ABAP-Meldungen verwenden.
Startseite Überwachung mit dem
Generic Request and Message Generator