メッセージ・フローのアカウンティングおよび統計データの出力フォーマット

メッセージ・フローの統計を収集する場合、データの出力先を選択できます。

mqsichangeflowstats コマンドを使用して、以下の宛先を 1 つ以上選択することができます。 形式が指定されていない場合、アカウンティング・データおよび統計データはデフォルトでユーザー・トレース・ログに送信されます。 出力形式の指定について詳しくは、mqsichangeflowstats コマンドを参照してください。

IBM® Integration Explorer を使用してメッセージ・フロー統計データの収集を開始すると、既に発行されている形式に加え、XML 形式でも統計が発行されます。 Web ユーザー・インターフェースを使用してメッセージ・フロー統計データの収集を開始すると、既に発行されている形式に加え、JSON 形式でも統計が発行されます。 その結果、IBM Integration Explorer と Web ユーザー・インターフェースの両方を使用して統計の収集を開始すると、データは XML と JSON 両方の形式で発行されます。 事前に出力形式が指定されていなかったためにデフォルトのユーザー・トレースになっていた場合、新たに指定した形式でデフォルトが置き換えられ、データはユーザー・トレースに対して発行されなくなります。 しかし、ユーザー・トレースが明示的に指定された場合、ユーザー・トレースに加えて、それ以降に選択された追加の形式が発行されます。

必要な出力形式を mqsichangeflowstats コマンドを使用して明示的に指定すると、そのコマンドで指定した形式が、現在メッセージ・フローに対して発行されている形式を置き換えます (つまり、追加されるのではありません)。

Web ユーザー・インターフェースまたは IBM Integration Explorer のいずれかから統計の収集を停止すると、すべての出力形式がオフになります。 その後に mqsichangeflowstats コマンドを使用して統計の収集を再開する場合、コマンドで他の形式が指定されない限り、出力形式は user trace のデフォルト値にリセットされます。ただし、統計の収集が IBM Integration Explorer を使用して再開された場合、データは XML 形式で収集されます。統計の収集が Web ユーザー・インターフェースを使用して再開された場合、データは JSON 形式で収集されます。

以下の状況のときに、指定した出力場所に統計データが書き込まれます。

ユーザー・トレース

収集したデータがユーザー・トレース・ログに書き込まれるように指定できます。 トレースがオフになっている場合でも、データが書き込まれます。

アカウンティングおよび統計における出力の宛先が指定されていない場合、デフォルトはユーザー・トレース・ログになります。 以降、1 つ以上の出力形式を指定した場合、指定された形式でデフォルトが置き換えられ、データはユーザー・トレースに対して発行されなくなります。 しかし、ユーザー・トレースが明示的に指定された場合、ユーザー・トレースに加えて、それ以降に選択された追加の形式が発行されます。

データは、以下のいずれかの場所に書き込まれます。

Windows platform Windows
作業パスを mqsicreatebroker コマンドの -w パラメーターを使用して設定する場合、 場所は workpath¥common¥log です。
ブローカー作業パスを指定しなかった場合、場所は以下のとおりです。
  • Windows の場合は、%ALLUSERSPROFILE%¥Application Data¥IBM¥MQSI¥common¥log です。ここで%ALLUSERSPROFILE% は、システム作業ディレクトリーを定義する環境変数です。 デフォルトのディレクトリーは、オペレーティング・システムによって異なります。ご使用のコンピューターでは標準値を使用しない場合があります。%ALLUSERSPROFILE% を使用して、必ず正しい場所にアクセスしてください。
Linux platformUNIX platform Linux および UNIX
/var/mqsi/common/log
z/OS platform z/OS®
/component_filesystem/log

JSON パブリケーション

収集されるデータが、Web ユーザー・インターフェースで表示するために使用可能な JSON 形式でパブリッシュされるように指定できます。 統計収集を Web ユーザー・インターフェースを介して開始すると、統計データは既存の出力形式だけでなく、JSON 形式でも出力されます。

データがパブリッシュされるトピックは、以下の構造になっています。
$SYS/Broker/brokerName/Statistics/JSON/SnapShot/executionGroupName/applications/applicationName
/libraries/libraryName/messageflows/messageFlowName
変数は、次の値に対応します。
brokerName
統計が収集されたブローカーの名前
executionGroupName
統計が収集された実行グループの名前
applicationName
統計が収集されたアプリケーションの名前
libraryName
統計が収集されたライブラリーの名前
messageFlowName
統計が収集されたメッセージ・フローの名前

XML パブリケーション

収集されるデータが XML フォーマットでパブリッシュされるように指定できます。ブローカー・ネットワークに登録済みのサブスクライバーは、適切なトピックにサブスクライブすると、そのデータを使用できるようになります。 IBM Integration Explorer を使用して統計の収集を開始すると、既に発行されている形式に加え、XML 形式でも統計データが発行されます。

データがパブリッシュされるトピックは、以下の構造になっています。

$SYS/Broker/brokerName/StatisticsAccounting/recordType/executionGroupLabel/messageFlowLabel
変数は、次の値に対応します。
brokerName
統計が収集されたブローカーの名前。
recordType
サブスクライブしているデータのタイプに応じて、SnapShot または Archive に設定されます。 あるいは、# を使用して、スナップショットとアーカイブの両方のデータに登録します (作成されている場合)。 この値は大/小文字の区別があり、SnapShot として入力しなければなりません。
executionGroupLabel
統計が収集された実行グループの名前。
messageFlowLabel
統計が収集されたメッセージ・フローのラベル。

サブスクライバーはフィルター式を組み込んで、受け取るパブリッシュを制限することができます。 例えば、スナップショット・データだけが表示されるようにしたり、1 つのブローカーに関して収集されるデータを表示するようにできます。 サブスクライバーは、ワイルドカード (+ および #) を指定して、複数のリソースを参照するパブリケーションを受け取ることができます。

以下の例は、さまざまな種類のデータを受け取るためにサブスクライバーが登録するトピックを示しています。
  • サブスクライバーが BrokerA 上で実行されるすべてのメッセージ・フローのデータを受け取るには、以下のトピックを登録します。

    $SYS/Broker/BrokerA/StatisticsAccounting/#

  • サブスクライバーがブローカー BrokerA 上の実行グループ Execution 上で実行されるメッセージ・フロー Flow1 に関連したアーカイブ統計のみを受け取るには、以下のトピックを登録します。

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

  • サブスクライバーがブローカー BrokerA 上の実行グループ Execution 上で実行されるメッセージ・フロー Flow1 のスナップショットとアーカイブ・データの両方を受け取るには、以下のトピックを登録します。

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

サブスクライバーの登録については、メッセージの表示、テスト、 およびパフォーマンス・ユーティリティー SupportPac (IH03)を参照してください。

SMF

z/OS では、収集されたデータが SMF に書き込まれるように指定できます。 アカウンティング・データおよび統計データは、SMF タイプ 117 レコードを使用します。SMF は複数のサブシステムからのデータの収集をサポートしているため、異なるソースから記録される情報の同期化が可能な場合もあります。

記録された情報を解釈するには、SMF レコードを処理する任意のユーティリティー・プログラムを使用してください。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

        
        最終更新:
        
        最終更新: 2013-07-17 15:14:25


概念トピック概念トピック | IBM Integration Bus バージョン 9.0.0.0 | ac19106_