Um Ereignisse nach der Implementierung eines Nachrichtenflusses anzupassen, ohne den Fluss erneut implementieren zu müssen, wird ein konfigurierbaren Service für Überwachungsprofile verwendet. Mit diesem Service können Sie ein Überwachungsprofil auf einen oder mehrere Nachrichtenflüsse anwenden.
Dies ist ein Überwachungsprofilentwurf mit nur einer Ereignisquelle zur Darstellung der Struktur:
<p:monitoringProfile
xmlns:p="http://www.ibm.com/xmlns/prod/websphere/messagebroker/6.1.0/monitoring/profile">
<p:eventSource p:enabled="true" p:eventSourceAddress="SOAPInput.transaction.Start">
<p:eventPointDataQuery>
<p:eventIdentity>
<p:eventName p:literal="" p:queryText=""/>
</p:eventIdentity>
<p:eventCorrelation>
<p:localTransactionId p:queryText="" p:sourceOfId="automatic"/>
<p:parentTransactionId p:queryText="" p:sourceOfId="automatic"/>
<p:globalTransactionId p:queryText="" p:sourceOfId="automatic"/>
</p:eventCorrelation>
<p:eventFilter p:queryText="true()"/> <p:eventUOW p:unitOfWork="messageFlow" /> </p:eventPointDataQuery>
<p:applicationDataQuery>
<p:simpleContent p:dataType="boolean" p:name="" p:targetNamespace="">
<p:valueQuery p:queryText=""/>
</p:simpleContent>
<p:complexContent p:name="" targetNamespace="">
<p:payloadQuery p:queryText=""/>
</p:complexContent>
</p:applicationDataQuery>
<p:bitstreamDataQuery p:bitstreamContent="all" p:encoding="base64Binary"/>
</p:eventSource>
</p:monitoringProfile>
Um Ihnen die Erstellung von Überwachungsprofilen zu erleichtern, enthält das folgende Beispiel eine XML-Datei mit einem Überwachungsprofilentwurf sowie die XML-Schemadatei für Überwachungsprofile (MonitoringProfile.xsd):
Überprüfen Sie Ihre eigenen Überwachungsprofile anhand des XML-Schemas, um ihre Korrektheit sicherzustellen.
Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im WebSphere Message Broker Toolkit integrierte Information Center verwendet wird.
Die folgenden Schritte beschreiben die Vorgehensweise beim Erstellen eines XML-Überwachungsprofils. Folgen Sie diesen Schritten für jedes p:eventSource-Element.
| Ereignistyp | Ereignisquellenadresse |
|---|---|
| Transaktionsstart | Knotenbezeichnung.transaction.Start |
| Transaktionsende | Knotenbezeichnung.transaction.End |
| Transaktions-Rollback | Knotenbezeichnung.transaction.Rollback |
| Terminalereignis | Knotenbezeichnung.terminal.<Terminal> |
Im ausgegebenen Ereignis ist die Adresszeichenfolge für die Ereignisquelle im Attribut wmb:eventData/@wmb:eventSourceAddress angegeben.
Im ausgegebenen Ereignis ist der Ereignisname im Attribut wmb:eventPointData/wmb:eventIdentity/@wmb:eventName angegeben.
Wenn das Element p:eventName nicht übergeben wird, nimmt @wmb:eventName im ausgegebenen Ereignis standardmäßig den Wert @p:eventSourceAddress an.
Mithilfe dieser Funktion können Sie die Ereignisausgaben an Ihre Geschäftsanforderung anpassen, indem Sie Ereignisse ausfiltern, die bestimmten Regeln nicht entsprechen. Auf diese Weise können Sie die Anzahl der ausgegebenen Ereignisse reduzieren und so die Auslastung der Überwachungsanwendung verringern.
Diese Funktion wird häufig zur Kommunikation wichtiger Geschäftsdaten in einem Geschäftsereignis verwendet. Wenn das Ereignis den Eingabebitstrom enthält, können mit dieser Funktion auch Schlüsselfelder extrahiert werden. Dies gibt anderen Anwendungen die Möglichkeit, ein Prüfprotokoll bereitzustellen oder fehlgeschlagene Nachrichten erneut zu übergeben.
Im ausgegebenen Ereignis sind die extrahierten Daten in den Elementen wmb:applicationData/wmb:simpleContent und wmb:applicationData/wmb:complexContent angegeben.
Im ausgegebenen Ereignis sind die extrahierten Bitstromdaten im Element wmb:bitstreamData/wmb:bitstream angegeben.
Jedes ausgegebene Überwachungsereignis muss mindestens ein und kann maximal drei Korrelationsattribute enthalten. Wenn im Überwachungsprofil keine Korrelationsinformationen angegeben sind, generiert die erste Ereignisquelle im Nachrichtenfluss eine eindeutige ID als lokalen Korrelationswert und speichert ihn in der Umgebungsbaumstruktur. Alle späteren Ereignisquellen im Nachrichtenfluss verwenden diesen lokalen Korrelationswert.
Wenn das Transaktionsstartereignis in die Arbeitseinheit des Nachrichtenflusses eingeschlossen werden soll, die Nachrichtenverarbeitung aber fehlschlägt und diese Arbeitseinheit nicht veröffentlicht wird, wird das Transaktionsstartereignis in eine unabhängige Arbeitseinheit eingeschlossen. Dadurch wird sichergestellt, dass Ihre Überwachungsanwendung ein Ereignispaar (Start und Rollback) empfängt und kein isoliertes Rollback-Ereignis.
Eine unabhängige Transaktion kann nur gestartet werden, wenn die Haupttransaktion entweder festgeschrieben oder zurückgesetzt wurde. Wenn die Eigenschaft Festschreibungszähler des Nachrichtenflusses größer als 1 ist (Konfigurierbare Nachrichtenflusseigenschaften) oder die Eigenschaft Festschreibung nach Nachrichtengruppierung festgelegt ist (Nachrichten in einer WebSphere MQ-Nachrichtengruppierung empfangen), werden die für die unabhängige Transaktion vorgesehenen Ereignisse stattdessen ohne Synchronisationspunkt ausgegeben. Dies wird durch die Anzeige einer entsprechenden Nachricht bestätigt.
| Ereignistyp | Zulässige Werte |
|---|---|
| transaction.Start |
|
| transaction.End |
|
| transaction.Rollback |
|
| Terminal |
|
Wenn eine XPath-Abfrage eine Komponente mit einem XML-Namensbereich enthält, enthält der XPath ein Namensbereichspräfix für den Namensbereich. Beispielsweise verweist der folgende XPath auf Komponenten in zwei verschiedenen Namensbereichen:
<p:localTransactionId p:sourceOfId="query" p:queryText="$Body/soapenv:Header/wsa:messageID" />
Damit der Broker das Namensbereichspräfix auflösen kann, muss auch die Namensbereichs-URL übergeben werden. Übergeben Sie für jeden Namensbereich ein Präfixzuordnungselement:
<p:localTransactionId p:sourceOfId="query" p:queryText="$Body/soapenv:Header/wsa:messageID">
<p:prefixMapping p:prefix="soapenv" p:URI="http://www.w3.org/2003/05/soap-envelope" />
<p:prefixMapping p:prefix="wsa" p:URI="http://www.w3.org/2005/08/addressing" />
</p:localTransactionId>
Überwachungsprofil 1: Zwei Ereignisquellen, von denen jede einen Ereignisnamen übergibt
<p:monitoringProfile p:version="2.0">
<p:eventSource p:eventSourceAddress="SOAPInput.transaction.Start">
<p:eventPointDataQuery>
<p:eventIdentity>
<p:eventName p:literal="SOAP start event"/>
</p:eventIdentity>
</p:eventPointDataQuery>
</p:eventSource>
<p:eventSource p:eventSourceAddress="SOAPInput.transaction.End">
<p:eventPointDataQuery>
<p:eventIdentity>
<p:eventName p:literal="SOAP end event"/>
</p:eventIdentity>
</p:eventPointDataQuery>
</p:eventSource>
</p:monitoringProfile>
<p:monitoringProfile p:version="2.0">
<p:eventSource p:eventSourceAddress="SOAPInput.transaction.Start">
<p:eventPointDataQuery>
<p:eventCorrelation>
<p:localTransactionId p:queryText="$Body/soapenv:Header/wsa:messageID" p:sourceOfId="query">
<p:prefixMapping p:prefix="soapenv" p:URI="http://www.w3.org/2003/05/soap-envelope"/>
<p:prefixMapping p:prefix="wsa" p:URI="http://www.w3.org/2005/08/addressing"/>
</p:localTransactionId>
</p:eventCorrelation>
</p:eventPointDataQuery>
</p:eventSource>
</p:monitoringProfile>
<p:monitoringProfile p:version="2.0">
<p:eventSource p:eventSourceAddress="MQInput.terminal.out">
<p:applicationDataQuery>
<p:simpleContent p:dataType="integer" p:name="InvoiceNumber">
<p:valueQuery p:queryText="$Body/invoice/invoiceNo"/>
</p:simpleContent>
<p:simpleContent p:dataType="string" p:name="BatchID">
<p:valueQuery p:queryText="$Body/batch/batchNo"/>
</p:simpleContent>
</p:applicationDataQuery>
</p:eventSource>
</p:monitoringProfile>
<p:monitoringProfile p:version="2.0">
<p:eventSource p:eventSourceAddress="MQInput.terminal.out">
<p:bitstreamDataQuery p:bitstreamContent="body" p:encoding="CDATA"/>
</p:eventSource>
</p:monitoringProfile>
Die CDATA-Codierung ist nicht für alle
Datentypen eignet.
Verwenden Sie CDATA nur, wenn @p:bitstreamContent="body" ist. Verwenden Sie CDATA nicht, wenn die Nachrichtenbitströme Zeichen enthalten können, die in XML nicht zulässig sind (siehe
http://www.w3.org/TR/2006/REC-xml-20060816/#charsets).