WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren

Im Nachrichtenflusseditor können Sie auf der Registerkarte Überwachung unter den Eigenschaften eines Knotens beliebig viele Überwachungsereignisse hinzufügen.

Bevor Sie beginnen:
Lesen Sie folgende Abschnitte: Es muss ein Nachrichtenfluss vorhanden sein, der einen Knoten enthält, zu dem Sie ein Überwachungsereignis hinzufügen möchten.

Zur Konfiguration eines Überwachungsereignisses können Sie XPath 1.0-Ausdrücke verwenden. Einige XPath-Ausdrücke (diese werden im Abschnitt Nicht für die Option zum Exportieren von Überwachungsdaten geeignete XPath-Ausdrücke aufgelistet) sind allerdings nicht für den Export von Überwachungsinformationen geeignet (Überwachungsmodell für WebSphere Business Monitor V7 oder höher erstellen).

Ereignisse erstellen

Eine Ereignisquelle ist ein Punkt in einem Nachrichtenfluss, an dem ein Überwachungsereignis ausgegeben werden kann. Jede Ereignisquelle besitzt eine Reihe von Eigenschaften, die den Inhalt der von ihr ausgegebenen Überwachungsereignisse steuern.
  1. Zeigen Sie die Eigenschaften für den Knoten an.
  2. Wählen Sie die Registerkarte Überwachung aus.
  3. Klicken Sie auf Hinzufügen.

    Daraufhin wird das Fenster Eintrag hinzufügen geöffnet.

  4. Füllen Sie das Feld Ereignisquelle aus.

    Das Feld verfügt über eine Dropdown-Liste mit allen Ereignissen, die für diesen Knoten definiert werden können. Aus den Ereignisquelleninformationen ergeben sich die Werte für die Attribute des Elements wmb:eventPointData/wmb:messageFlowData/wmb:node des Ereignisses.

    Nachdem Sie die Ereignisquelle ausgewählt haben, wird der zugehörige Wert für Ereignisquellenadresse als schreibgeschützte Eigenschaft angezeigt.
    Tipp: Falls Sie sich später entschließen, Ereignisse mit dem Befehl mqsichangeflowmonitoring zu aktivieren oder zu inaktivieren, müssen Sie einen Wert für Ereignisquellenadresse angeben, nicht den Ereignisnamen.
  5. Geben Sie die Details zu Ereignisname an; wählen Sie entweder Literal oder Datenposition aus.

    Jedes Überwachungsereignis besitzt einen Namen, der in das Attribut wmb:eventPointData/wmb:eventIdentity/@wmb:eventName des Ereignisses übernommen wird. Die Standardnamen sind in der folgenden Tabelle aufgeführt:

    Ereignisquelle Standardereignisname Beispiel
    Transaktionsstart Knotenbezeichnung.TransactionStart MQInput.TransactionStart
    Transaktionsende Knotenbezeichnung.TransactionEnd MQInput.TransactionEnd
    Rollback der Transaktion Knotenbezeichnung.TransactionRollback MQInput.TransactionRollback
    Terminal Knotenbezeichnung.Terminalbezeichnung.Terminal MQInput.OutTerminal
    Sie haben folgende Möglichkeiten, um den Standardwert zu überschreiben:
    • Geben Sie eine alternative Literalzeichenfolge an.
    • Geben Sie eine XPath-Abfrage an; die Abfrage extrahiert den Ereignisnamen aus einem Feld in der Eingabenachricht. Klicken Sie auf Bearbeiten, um das XPath-Ausdruckserstellungsprogramm zu verwenden.
    Sie können Überwachungseigenschaften nicht zur Konfiguration von Transaktionsereignissen auf folgenden Knoten verwenden: Verwenden Sie stattdessen ein Überwachungsprofil (siehe Überwachungsereignisquellen mithilfe eines Überwachungsprofils konfigurieren).
  6. Optional: Vervollständigen Sie den Abschnitt für den Ereignisfilter, indem Sie einen XPath-Ausdruck angeben, um zu steuern, ob das Ereignis ausgegeben werden soll. Führen Sie eine der folgenden Aktionen aus:
    • Geben Sie den Ausdruck ein (z. B. $Body/StockTrade/Details/Value > 10000) oder
    • Klicken Sie auf Bearbeiten, um das XPath-Ausdruckserstellungsprogramm zu starten.
    Der Ausdruck muss wahr oder falsch sein und kann sich auf Felder in der Nachrichtenbaumstruktur oder an anderer Stelle im Nachrichtenaufbau beziehen. Der Standardwert ist true(), d. h., das Ereignis wird immer erzeugt.

    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.

  7. Optional: Füllen Sie den Abschnitt Ereignisnutzlast aus, wenn das Ereignis ausgewählte Datenfelder, die aus der Nachricht extrahiert werden, enthalten soll. Klicken Sie auf Hinzufügen, um das Dialogfenster Datenposition hinzufügen zu öffnen. Führen Sie eine der folgenden Aktionen aus:
    • Geben Sie die Position ein (z. B. $LocalEnvironment/File/Name).
    • Klicken Sie auf Bearbeiten, um das XPath-Ausdruckserstellungsprogramm zu starten.

    Sie können beliebig viele Felder aus den Nachrichtendaten extrahieren und in das Ereignis einschließen. Es kann sich um einfache oder komplexe Felder handeln. Einfacher Inhalt befindet sich im Feld wmb:applicationData/wmb:simpleContent des Ereignisses; komplexe Daten befinden sich im Feld wmb:applicationData/wmb:complexContent.

    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.

  8. Optional: Wählen Sie das Feld Bitstromdaten in Nutzlast einschließen aus, wenn das Ereignis Nachrichtenbitstromdaten erfassen soll.
    Content
    Wählen Sie Header, Hauptteil oder Alle aus.
    Encoding
    Wählen Sie Base64, HexBinary oder CData (der Originaltext, ohne Codierung) aus.
  9. Optional: Wählen Sie die Registerkarte Korrelation aus, um Details zur Ereigniskorrelation anzugeben.
  10. Geben Sie die Details zur Ereigniskorrelation ein. Informationen zur Korrelation finden Sie im Abschnitt Korrelation und Überwachungsereignisse.

    Jedes Überwachungsereignis muss mindestens ein und kann maximal drei Korrelationsattribute enthalten. Wenn Sie keine Korrelationsinformationen angeben, legt die erste Ereignisquelle im Nachrichtenfluss eine eindeutige Kennung an, die auch von allen weiteren Ereignisquellen in derselben Transaktion verwendet wird.

    1. Optional: Geben Sie die Details für Lokaler Transaktionskorrelator an.
      Automatisch
      Es wird der lokale Korrelationswert verwendet, der vom letzten Ereignis für diesen Aufruf des Nachrichtenflusses verwendet wurde. Falls noch kein lokaler Korrelationswert existiert, wird ein neuer eindeutiger Wert generiert.
      Geben Sie die Position des Korrelators an
      Geben Sie einen Wert ein, oder klicken Sie auf 'Bearbeiten', um das XPath-Ausdruckserstellungsprogramm zu starten. Der lokale Korrelationswert wird von der angegebenen Position in der Nachrichtenbaumstruktur gelesen. Stellen Sie sicher, dass die angegebene Position einen Korrelationswert enthält, der für diesen Aufruf des Nachrichtenflusses eindeutig ist.
    2. Optional: Geben Sie die Details für Übergeordneter Transaktionskorrelator an, um ein Korrelationsfeld aus der übergeordneten Transaktion zu extrahieren.
      Automatisch
      Es wird der übergeordnete Korrelationswert verwendet, der vom letzten Ereignis für diesen Aufruf des Nachrichtenflusses verwendet wurde. Falls noch kein übergeordneter Korrelationswert existiert, wird kein übergeordneter Korrelationswert verwendet.
      Geben Sie die Position des Korrelators an
      Geben Sie einen Wert ein, oder klicken Sie auf 'Bearbeiten', um das XPath-Ausdruckserstellungsprogramm zu starten. Der übergeordnete Korrelationswert wird von der angegebenen Position in der Nachrichtenbaumstruktur gelesen. Stellen Sie sicher, dass die angegebene Position einen geeigneten übergeordneten Korrelationswert enthält.
    3. Optional: Geben Sie die Details für Globaler Transaktionskorrelator an, um ein Korrelationsfeld aus einer globalen Transaktion zu extrahieren.
      Automatisch
      Es wird der globale Korrelationswert verwendet, der vom letzten Ereignis für diesen Aufruf des Nachrichtenflusses verwendet wurde. Falls noch kein globaler Korrelationswert existiert, wird kein globaler Korrelationswert verwendet.
      Geben Sie die Position des Korrelators an
      Geben Sie einen Wert ein, oder klicken Sie auf 'Bearbeiten', um das XPath-Ausdruckserstellungsprogramm zu starten. Der globale Korrelationswert wird von der angegebenen Position in der Nachrichtenbaumstruktur gelesen. Stellen Sie sicher, dass die angegebene Position einen geeigneten globalen Korrelationswert enthält.
  11. Optional: Legen Sie fest, ob die Ausgabe von Überwachungsereignissen durch einen Nachrichtenfluss mit der Nachrichtenflusstransaktion koordiniert wird, in einer unabhängigen Arbeitseinheit erfolgt oder in keiner Arbeitseinheit enthalten ist.
    Klicken Sie auf die Registerkarte Transaktion und wählen Sie die geeignete Option für Ereignisarbeitseinheit aus.
    Nachrichtenfluss
    Das Ereignis und alle anderen Ereignisse mit dieser Einstellung werden nur ausgegeben, wenn der Nachrichtenfluss seine Arbeitseinheit erfolgreich festschreibt.

    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.

    Unabhängig
    Das Ereignis wird in einer zweiten Arbeitseinheit ausgegeben, die von der Hauptarbeitseinheit unabhängig ist. Das Ereignis und alle anderen Ereignisse mit dieser Einstellung werden unabhängig davon ausgegeben, ob die Hauptarbeitseinheit erfolgreich festgeschrieben wird.

    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.

    None
    Das Ereignis wird ohne Synchronisationspunkt ausgegeben (nicht in einer Arbeitseinheit). Das Ereignis wird ausgegeben, wenn die Nachricht die Ereignisquelle durchläuft und kann sofort gelesen werden.
    Nicht alle diese Optionen sind für alle Ereignistypen verfügbar. Die Standardwerte und die zulässigen Werte sind in der folgenden Tabelle aufgeführt:
    Ereignisquelle Zulässige Werte Standardwert
    Transaktionsstart
    • Nachrichtenfluss
    • Unabhängig
    • Ohne
    Nachrichtenfluss
    Transaktionsende
    • Nachrichtenfluss
    • Ohne
    Nachrichtenfluss
    Rollback der Transaktion
    • Unabhängig
    • Ohne
    Unabhängig
    Terminal
    • Nachrichtenfluss
    • Unabhängig
    • Ohne
    Nachrichtenfluss
  12. Klicken Sie auf Finish (Fertigstellen).

    Die Tabelle Ereignisse auf der Registerkarte 'Überwachung' in der Ansicht 'Eigenschaften' für den Knoten wird mit den gerade hinzugefügten Details zu dem Ereignis aktualisiert und das Ereignis aktiviert.

  13. Optional: Inaktivieren Sie das Ereignis.
  14. Speichern Sie den Nachrichtenfluss.

Überwachungseigenschaften implementieren

  1. Nachdem Sie alle Ereignisse zum Nachrichtenfluss hinzugefügt haben, können Sie den Nachrichtenfluss zur Brokerarchivdatei (BAR-Datei) hinzufügen und die Datei implementieren.

    Die Überwachung für den Nachrichtenfluss ist inaktiv. Sie wird nicht durch die Implementierung der BAR-Datei aktiviert.

  2. Aktivieren Sie die Überwachung für den Nachrichtenfluss mit dem Befehl mqsichangeflowmonitoring -c.

Überwachungseigenschaften aktualisieren

Die Überwachungseigenschaften für einen Knoten zeigen alle Überwachungsereignisse an, die für den Knoten definiert sind. Sie können die Überwachungseigenschaften eines Knotens auf folgende Weise bearbeiten:
  • Sie können ein Überwachungsereignis aktivieren oder inaktivieren.
  • Sie können Überwachungsereignisse für den Knoten hinzufügen, löschen oder ändern.
  1. Klicken Sie mit der rechten Maustaste auf den Knoten und wählen Sie Eigenschaften aus.
  2. Wählen Sie die Registerkarte Überwachung aus.

    Die Überwachungsereignisse, die Sie zuvor definiert haben, werden angezeigt.

  3. Aktivieren oder inaktivieren Sie nach Bedarf das Kontrollkästchen Aktiviert für die einzelnen Ereignisse.
    • Inaktivieren Sie das Kontrollkästchen, um ein Ereignis zu inaktivieren.
    • Aktivieren Sie das Kontrollkästchen, um ein Ereignis zu aktivieren.
  4. Klicken Sie zum Hinzufügen eines Ereignisses auf Hinzufügen.
  5. Sie können ein Ereignis löschen, indem Sie es auswählen und dann auf Löschen klicken.
  6. Sie können ein Ereignis bearbeiten, indem Sie es auswählen und dann auf Bearbeiten klicken.

    Das Fenster Ereignis hinzufügen wird geöffnet. Eine Beschreibung der Optionen in diesem Fenster finden Sie im Abschnitt Ereignisse erstellen.

  7. Speichern Sie den Nachrichtenfluss.
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:20:26


TaskthemaTaskthema | Version 8.0.0.5 | ac60381_