Sie können Überwachungsdaten aus WebSphere Message
Broker exportieren, um ein Überwachungsmodell für WebSphere Business Monitor V7 zu erstellen.
Vorbereitungen:
Bei Verwendung älterer Versionen, lesen Sie den Abschnitt Überwachungsmodelle für WebSphere Business Monitor V6.2 erstellen.
Die zur Erstellung eines Überwachungsmodells erforderlichen Überwachungsdaten können nur dann aus
WebSphere Message
Broker exportiert werden, wenn die folgenden Bedingungen erfüllt sind:
- Der Nachrichtenfluss darf nicht leer sein.
- Für den Nachrichtenfluss liegen in der Ansicht Probleme keine Fehler vor.
Berücksichtigen Sie vor dem Export eines Nachrichtenflusses die folgenden Punkte:
- WebSphere Business Monitor muss in der Lage sein, den Anfang und das Ende des Überwachungskontexts festzustellen. Definieren Sie für Nachrichtenflüsse, die von WebSphere Business Monitor überwacht werden sollen, immer Transaktionsereignisse (transaction.Start, transaction.End und transaction.Rollback).
- Vom WebSphere Business Monitor-Toolkit werden keine lokalen Elemente mit anonymen Typen unterstützt.
Die Option zum Exportieren von Überwachungsdaten generiert daher keine Ereignisteile für XPath-Abfragen in Ereignisnutzdaten, die auf ein Element dieses Typs aufgelöst werden. Sie erhalten in diesem Fall eine Warnung im Berichtsprotokoll Nachrichtenfluss_Projektname_batchgen_report.txt.
- Vom WebSphere Business Monitor-Toolkit wird die Erstellung von Kennzahlen des Typs xs:anyType nicht unterstützt.
Wenn ein XPath-Ausdruck in Ihren Ereignisnutzdaten auf ein Element des Typs xs:anyType aufgelöst wird, erstellt die Option zum Exportieren von Überwachungsdaten zwar einen Ereignisteil dieses Typs, im WebSphere
Business Monitor-Toolkit kann aber keine Kennzahl dieses Typs erstellt werden. Sie müssen daher einen Ereignisteil mit einem unterstützten Typ erstellen (siehe Defining Event Parts (Ereignisteile definieren) im Information Center von WebSphere Business Monitor.
- Wenn Sie nicht modellierte Daten einschließen, kann die Option zum Exportieren von Überwachungsdaten den Daten keinen Typ zuordnen. Sie ordnet den Daten in diesem Fall den Typ Zeichenfolge zu.
- Die Option zum Exportieren von Überwachungsdaten unterstützt keine XPath-Abfragen, die
Platzhalterzeichen enthalten.
Tipp: Wenn Sie transaction.Start- und transaction.End-Ereignisse, die nach einer Fehlerbehandlung im Nachrichtenfluss ausgegeben werden, separat ermitteln möchten, müssen Sie im Fehlerterminal (Failure) des Empfangsknotens eine Ereignisquelle erstellen.
Mit der folgenden
WebSphere Message
Broker-Prozedur erstellen Sie eine komprimierte ZIP-Datei, die folgende Überwachungsdaten zum Nachrichtenfluss enthält:
- Alle Überwachungsinformationen, die in den Nachrichtenflussdateien definiert sind.
- Die Datei 'WMBEvent.xsd', die das Schema für das ausgegebene Ereignis ist.
- Alle .xsd-Dateien der Nachrichtengruppen, auf die die ausgewählten Nachrichtenflüsse verweisen.
In WebSphere Message
Broker
- Klicken Sie im WebSphere Message
Broker Toolkit mit der rechten Maustaste auf den
Nachrichtenfluss oder das
Nachrichtenbrokerprojekt und klicken Sie dann
auf Exportieren. Der Exportassistent wird gestartet.
- Klicken Sie auf
und anschließend auf Weiter.
- Wählen Sie die Flüsse aus, aus denen die Überwachungsdaten exportiert werden sollen, und geben Sie einen Dateinamen an.
- Optional: Geben Sie an, dass vorhandene Dateien ohne Warnung überschrieben werden sollen.
- Klicken Sie auf Fertigstellen. Eine komprimierte ZIP-Datei, welche die Anwendungsüberwachungsdaten enthält, wird gespeichert.
Im Protokollverzeichnis des
Nachrichtenbrokerprojekts wird ein
Exportbericht in die Datei
flowProjectName_batchgen.report.txt geschrieben.
In WebSphere Business Monitor V7
Importieren Sie im Entwicklungstoolkit von WebSphere
Business Monitor die
ZIP-Datei, die Sie aus
WebSphere Message
Broker exportiert haben.
Der Assistent für die Generierung von Überwachungsmodellen wird gestartet. In diesem Assistenten können Sie, je nach den in Ihrem Nachrichtenfluss enthaltenen Ereignisquellen, einige oder alle der folgenden Schablonen auswählen:
- Average Transaction Duration (Durchschnittliche Transaktionsdauer): Diese Schablone steht zur Verfügung, wenn Sie die Ereignisquellen
transaction.Start, transaction.End
und transaction.Rollback erstellt haben. Wenn Sie diese Schablone auswählen, werden im Überwachungsmodell ein Messwert und eine Stoppuhr erstellt, die die durchschnittliche Transaktionsdauer angeben; aus den Daten der Stoppuhr wird zudem ein Leistungsindikator (KPI) erstellt.
- Number of Failed Transactions (Anzahl der fehlgeschlagenen Transaktionen): Diese Schablone steht zur Verfügung, wenn Sie die Ereignisquelle
transaction.Rollback erstellt haben.
Wenn Sie diese Schablone auswählen,
werden im Überwachungsmodell Messwerte erstellt, die die Anzahl der fehlgeschlagenen
Transaktionen sowie die durchschnittliche Transaktionsdauer (Standardwert: 01. Januar
9999 01:00:00) angeben. Außerdem werden eine Kennzahl und eine Dimension zum
Erstellen mehrdimensionaler Berichte erstellt. Weitere Informationen finden Sie im
Information Center für WebSphere Business Monitor im Abschnitt Defining
Dimensions (Dimensionen
definieren).
- Message Flow Correlation (Nachrichtenflusskorrelation): Diese Schablone gibt Informationen
zum Broker an (z. B. Brokername, Name der Ausführungsgruppe, 'parentTransactionID'
(Übergeordnete Transaktions-ID), 'globalTransactionID' (Globale Transaktions-ID)). Sie
können diese Informationen ebenso wie andere Messwerte und Leistungsindikatoren in einem Business
Space-Dashboard anzeigen.
Da diese Messwerte im Korrelationsausdruck für die
eingehenden Ereignisse verwendet werden, dürfen Sie diese Schablone nur auswählen,
wenn die Ereignisse für einen angegebenen Überwachungskontext aus derselben
Ausführungsgruppe stammen.
Vollständige und aktuelle Informationen hierzu finden Sie in der Dokumentation zu WebSphere Business Monitor.