Ausgabeformate für Abrechnungs- und Statistikdaten für Nachrichtenflüsse

Beim Erfassen von statistischen Daten für Nachrichtenflüsse können Sie das Ausgabeziel für die Daten auswählen.

Sie können eines oder mehrere der folgenden Ziele auswählen, indem Sie den Befehl mqsichangeflowstats ausführen: Wenn kein Format angegeben ist, werden die Abrechnungs- und Statistikdaten standardmäßig an das Benutzertraceprotokoll gesendet. Weitere Informationen zum Festlegen eines Ausgabeformats finden Sie im Abschnitt mqsichangeflowstats-Befehl.

Wenn Sie die Erfassung der Statistikdaten zu Nachrichtenflüssen über den IBM® Integration Explorer starten, werden die Statistikdaten im XML-Format sowie eventuell zusätzlich in anderen möglichen Ausgabeformaten ausgegeben. Wenn Sie die Erfassung der Statistikdaten zu Nachrichtenflüssen über die Webbenutzerschnittstelle starten, werden die Daten im JSON-Format sowie eventuell zusätzlich in anderen möglichen Ausgabeformaten ausgegeben. Dies bedeutet, wenn die Erfassung der Statistikdaten sowohl über den IBM Integration Explorer als auch über die Webbenutzerschnittstelle gestartet wird, werden die Daten sowohl im XML- als auch im JSON-Format ausgegeben. Wenn zuvor kein Ausgabeformat angegeben war und deshalb standardmäßig das Benutzertraceprotokoll als Ziel verwendet wurde, wird diese Standardeinstellung durch das neu festgelegte Ausgabeformat ersetzt und die Daten werden nicht mehr in den Benutzertrace ausgegeben. Wenn der Benutzertrace jedoch explizit als Ausgabeformat festgelegt wurde und danach weitere Formate ausgewählt wurden, werden die Daten zusätzlich zum Benutzertrace auch in den anderen Formaten ausgegeben.

Wenn Sie den Befehl mqsichangeflowstats ausführen, um die erforderlichen Ausgabeformate für die Statistikdaten zu Nachrichtenflüssen explizit festzulegen, ersetzen die im Befehl angegebenen Formate die bisher verwendeten Formate (d. h. sie werden nicht zusätzlich zu den bisherigen Formaten verwendet).

Wenn Sie die Erfassung der Statistikdaten über die Webbenutzerschnittstelle oder den IBM Integration Explorer stoppen, werden alle Ausgabeformate inaktiviert. Wenn Sie die Erfassung der Statistikdaten anschließend erneut mit dem Befehl mqsichangeflowstats starten, wird das Ausgabeformat auf den Standardwert user trace (Benutzertrace) zurückgesetzt, sofern keine anderen Ausgabeformate in dem Befehl angegeben sind. Wenn Sie die Erfassung der Statistikdaten hingegen über den IBM Integration Explorer bzw. die Webbenutzerschnittstelle erneut starten, werden die erfassten Daten entsprechend im XML-Format bzw. im JSON-Format ausgegeben.

Statistische Daten werden in folgenden Situationen in die angegebenen Ausgabeziele geschrieben:

Benutzertrace

Sie können angeben, dass die erfassten Daten in das Benutzertraceprotokoll geschrieben werden. Die Daten werden auch dann geschrieben, wenn die Tracefunktion ausgeschaltet ist.

Wenn für die Berechnungs- und Statistikdaten kein Ausgabeziel angegeben ist, werden die Daten standardmäßig in das Benutzertraceprotokoll ausgegeben. Wenn anschließend eines oder mehrere Ausgabeformate angegeben werden, ersetzen die neu festgelegten Formate die Standardeinstellung und die Daten werden nicht mehr in den Benutzertrace ausgegeben. Wenn der Benutzertrace jedoch explizit als Ausgabeformat festgelegt wurde und danach weitere Formate ausgewählt wurden, werden die Daten zusätzlich zum Benutzertrace auch in den anderen Formaten ausgegeben.

Die Daten werden in eines der folgenden Verzeichnisse geschrieben:

Windows platform Windows
Wenn Sie den Arbeitspfad mithilfe des Parameters -w im Befehl mqsicreatebroker festlegen, befinden sich die Protokolle unter workpath\common\log.
Wenn Sie den Brokerarbeitspfad nicht angegeben haben, wird folgende Position verwendet:
  • Unter Windows:%ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\log, wobei %ALLUSERSPROFILE% die Umgebungsvariable ist, die das Systemarbeitsverzeichnis definiert. Das Standardverzeichnis ist vom Betriebssystem abhängig.Da auf Ihrem Computer möglicherweise nicht das Standardverzeichnis verwendet wird, sollten Sie %ALLUSERSPROFILE% angeben, um sicherzustellen, dass Sie auf das korrekte Verzeichnis zugreifen.
Linux platformUNIX platform Linux und UNIX
/var/mqsi/common/log
z/OS platform z/OS
/component_filesystem/log

JSON-Veröffentlichung

Sie können angeben, dass die erfassten Daten im JSON-Format veröffentlicht werden, das in der Webbenutzerschnittstelle angezeigt werden kann. Wenn die Erfassung der Statistikdaten über die Webbenutzerschnittstelle gestartet wird, werden die Daten im JSON-Format zusätzlich zu eventuell bereits festgelegten anderen Ausgabeformaten ausgegeben.

Das Thema, für das die Daten veröffentlicht werden, hat folgende Struktur:
$SYS/Broker/Brokername/Statistics/JSON/SnapShot/Ausführungsgruppenname/applications/Anwendungsname
/libraries/Bibliotheksname/messageflows/Nachrichtenflussname
Die Variablen entsprechen den folgenden Werten:
Brokername
Der Name des Brokers, für den Statistikdaten erfasst werden.
Ausführungsgruppenname
Der Name der Ausführungsgruppe, für die Statistikdaten erfasst werden.
Anwendungsname
Der Name der Anwendung, für die Statistikdaten erfasst werden.
Bibliotheksname
Der Name der Bibliothek, für die Statistikdaten erfasst werden.
Nachrichtenflussname
Der Name des Nachrichtenflusses, für den Statistikdaten erfasst werden.

XML-Veröffentlichung

Sie können angeben, dass die erfassten Daten im XML-Format veröffentlicht werden und Subskribenten, die im Brokernetz registriert sind und das richtige Thema subskribiert haben, zur Verfügung stehen. Wenn die Erfassung der Statistikdaten über den IBM Integration Explorer gestartet wird, werden die Daten im XML-Format zusätzlich zu eventuell bereits festgelegten anderen Ausgabeformaten ausgegeben.

Das Thema, für das die Daten veröffentlicht werden, hat folgende Struktur:

$SYS/Broker/Brokername/StatisticsAccounting/Datensatztyp/executionGroupLabel/messageFlowLabel
Die Variablen entsprechen den folgenden Werten:
Brokername
Der Name des Brokers, für den Statistikdaten erfasst werden.
Datensatztyp
Wird je nach Datentyp, den Sie subskribieren, auf SnapShot (Momentaufnahme) oder Archive (Archiv) gesetzt. Alternativ können Sie sich mit # für Momentaufnahmedaten und für Archivdaten eintragen, wenn sie erzeugt werden. Bei diesem Wert wird die Groß-/Kleinschreibung berücksichtigt; er muss daher wie folgt eingegeben werden: SnapShot.
executionGroupLabel
Der Name der Ausführungsgruppe, für die Statistikdaten erfasst werden.
messageFlowLabel
Die Bezeichnung auf dem Nachrichtenfluss, für den Statistikdaten erfasst werden.

Subskribenten können Filterausdrücke einfügen, um die Veröffentlichungen, die sie empfangen, zu begrenzen. Beispielsweise können sie festlegen, dass sie nur Momentaufnahmedaten oder für einen einzelnen Broker erfasste Daten erhalten. Subskribenten können Platzhalterzeichen (+ und #) angeben, um Veröffentlichungen zu erhalten, die auf mehrere Ressourcen verweisen.

Die folgenden Beispiele zeigen das Thema, für das sich ein Subskribent einträgt, wenn er verschiedene Datensorten erhalten möchte:
  • Tragen Sie das folgende Thema ein, damit der Subskribent Daten für alle Nachrichtenflüsse erhält, die auf BrokerA ausgeführt werden:

    $SYS/Broker/BrokerA/StatisticsAccounting/#

  • Tragen Sie das folgende Thema ein, damit der Subskribent nur archivierte Statistikdaten zu einem Nachrichtenfluss namens Flow1 erhält, der in der Ausführungsgruppe Execution auf dem Broker BrokerA ausgeführt wird:

    $SYS/Broker/BrokerA/StatisticsAccounting/Archive/Execution/Flow1

  • Tragen Sie das folgende Thema ein, damit der Subskribent sowohl Momentaufnahmedaten als auch Archivdaten zum Nachrichtenfluss Flow1 erhält, der in der Ausführungsgruppe Execution auf dem Broker BrokerA ausgeführt wird:

    $SYS/Broker/BrokerA/StatisticsAccounting/+/Execution/Flow1

Hilfe zum Eintragen eines Subskribenten finden Sie im Abschnitt SupportPac (IH03) mit Dienstprogrammen zur Nachrichtenanzeige, zum Testen und zur Leistungsmessung.

SMF

Unter z/OS können Sie angeben, dass die erfassten Daten in SMF geschrieben werden. Abrechnungs- und Statistikdaten liegen in Datensätzen des SMF-Typs 117 vor. SMF unterstützt die Erfassung von Daten von mehreren Subsystemen, was Ihnen die Möglichkeit gibt, die von verschiedenen Quellen aufgezeichneten Informationen zu synchronisieren.

Zum Auswerten der aufgezeichneten Informationen können Sie jedes Dienstprogramm verwenden, dass SMF-Datensätze verarbeitet.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-07-18 03:02:30


KonzeptthemaKonzeptthema | IBM Integration Bus Version 9.0.0.0 | ac19106_