メッセージ・フローのアカウンティングおよび統計データの JSON パブリケーション

メッセージ・フローのアカウンティングおよび統計データ用の JSON パブリケーションに情報が書き込まれます。

データは WMQIStatisticsAccounting フォルダー内に作成されます。このフォルダーには、詳細情報を提供するサブフォルダーが含まれます。 関連データが収集されないように現行のデータ収集パラメーターが設定されている場合には、すべてのフォルダーがこのパブリケーション内に存在します。 データは以下のトピックにパブリッシュされます。
スナップショット・データ
  • MQ パブリッシュ/サブスクライブ・ブローカーでのパブリケーションの場合:
    $SYS/Broker/integrationNodeName/Statistics/JSON/SnapShot/
  • MQTT パブリッシュ/サブスクライブ・ブローカーでのパブリケーションの場合:
    IBM/IntegrationBus/integrationNodeName/Statistics/JSON/SnapShot/
アーカイブ・データ
  • MQ パブリッシュ/サブスクライブ・ブローカーでのパブリケーションの場合:
    $SYS/Broker/integrationNodeName/Statistics/JSON/Archive/
  • MQTT パブリッシュ/サブスクライブ・ブローカーでのパブリケーションの場合:
    IBM/IntegrationBus/integrationNodeName/Statistics/JSON/Archive/

統合ノードによって管理される統合サーバーの場合、integrationNodeName統合サーバーを管理する統合ノードの名前です。 独立統合サーバーの場合、統合ノード名の代わりにリテラル・ストリング integration_server を指定します。

スナップショット・データはパフォーマンス分析に使用され、保存および非持続としてパブリッシュされます。 スナップショット・データは 20 秒ごとに生成されます。これを Web ユーザー・インターフェースで表示すれば、メッセージ・フローのパフォーマンスの分析に役立ちます。 統計収集を Web ユーザー・インターフェースを介して開始すると、統計データは既存の出力形式だけでなく、JSON 形式でも出力されます。

アーカイブ・データは監査証跡が要求される可能性のあるアカウンティングで使用され、保存および持続としてパブリッシュされます。 すべてのパブリケーションはグローバルですので、ネットワークのいずれかで登録したサブスクライバーが収集できます。 また、複数のサブスクライバーが収集することもできます。

選択した期間にわたってデータを生成しているメッセージ・フローごとに 1 つの JSON パブリケーションが生成されます。 例えば、MessageFlowA と MessageFlowB の両方が 60 分にわたってアーカイブ・データを生成している場合、MessageFlowA と MessageFlowB の両方は 60 分ごとに JSON パブリケーションを作成します。

これらのメッセージの安全な配信に懸念がある場合（例えば、課金目的など）、 IBM® MQ などの安全な配信手段をご利用ください。

JSON パブリケーション内のフォルダーおよびサブフォルダーは、次の ID を持っています。

  • WMQIStatisticsAccounting
  • MessageFlow
  • ThreadStatistics
  • NodesStatistics
  • TerminalStatistics

ここで提供されている表では、これらのフォルダーそれぞれの内容が説明されています。

下記の表では、「WMQIStatisticsAccounting」フォルダーで作成される、一般的なアカウンティングおよび統計情報について説明されています。

フィールド データ・タイプ 詳細
RecordType CHARACTER 出力のタイプ (以下のいずれか)
  • アーカイブ
  • スナップショット
RecordCode CHARACTER 出力の理由 (以下のいずれか)
  • MajorInterval
  • スナップショット
  • シャットダウン
  • ReDeploy
  • StatsSettingsModified
NumberOfThreads Numeric 「WMQIStatisticsAccounting」フォルダー内のスレッドの統計のサブフォルダーの数
NumberOfNodes Numeric 「WMQIStatisticsAccounting」フォルダー内のノードの統計のサブフォルダーの数

下記の表では、「MessageFlow」フォルダーで作成される、メッセージ・フローの統計情報について説明されています。

フィールド データ・タイプ 詳細
BrokerLabel
文字
(最大 32)
 統合ノード名
BrokerUUID
文字
(最大 32)
 統合ノード汎用固有 ID
ExecutionGroupName
文字
(最大 32)
 統合サーバー名
ExecutionGroupUUID
文字
(最大 32)
 統合サーバー汎用固有 ID
MessageFlowName
文字
(最大 32)
 メッセージ・フロー名
StartDate CHARACTER
間隔開始日
(YYYY-MM-DD)
StartTime CHARACTER
間隔開始時刻
(HH:MM: SS:NNNNNN)
GMTStartTime CHARACTER インターバル開始日時 (ISO8601 形式のユニバーサル・タイム・スタンプ)
EndDate CHARACTER
間隔終了日
(YYYY-MM-DD)
EndTime CHARACTER
間隔終了時刻
(HH:MM: SS:NNNNNN)
GMTEndTime CHARACTER インターバル終了日時 (ISO8601 形式のユニバーサル・タイム・スタンプ)
TotalElapsedTime Numeric 入力メッセージの処理にかかった経過時間の合計 (マイクロ秒)
MaximumElapsedTime Numeric 入力メッセージの処理にかかった最大経過時間 (マイクロ秒)
MinimumElapsedTime Numeric 入力メッセージの処理にかかった最小経過時間 (マイクロ秒)
TotalCPUTime Numeric 入力メッセージの処理にかかったプロセッサー時間の合計 (マイクロ秒)
MaximumCPUTime Numeric 入力メッセージの処理にかかった最大プロセッサー時間 (マイクロ秒)
MinimumCPUTime Numeric 入力メッセージの処理にかかった最小プロセッサー時間 (マイクロ秒)
CPUTimeWaitingForInputMessage Numeric 入力メッセージを待機したプロセッサー時間の合計 (マイクロ秒)
ElapsedTimeWaitingForInputMessage Numeric 入力メッセージを待機した経過時間の合計 (マイクロ秒)
TotalInputMessages Numeric 処理されたメッセージの総数

TotalInputMessages は、入力ノード・ターミナルから伝搬されるメッセージのみを記録します。
TotalSizeOfInputMessages Numeric 入力メッセージの合計サイズ (バイト単位)
MaximumSizeOfInputMessages Numeric 最大入力メッセージ・サイズ (バイト単位)
MinimumSizeOfInputMessages Numeric 最小メッセージ入力サイズ (バイト単位)
NumberOfThreadsInPool Numeric プール内のスレッド数
TimesMaximumNumberofThreadsReached Numeric スレッドの最大数に到達した回数
TotalNumberOfMQErrors Numeric MQGET エラー (MQInput ノード) または Web サービス・エラー (HTTPInput ノード) の数

例えば、メッセージがキューから読み取られる場合、変換エラーが生じます。
TotalNumberOfMessagesWithErrors Numeric エラーが含まれるメッセージ数

これらのエラーには、入力ノードのダウンストリームにスローされる例外、およびキューからメッセージが正常に検索されたが出力ターミナルにそれが伝搬される前に入力ノードによって検出されたエラー (例えば、形式エラーなど) が含まれます。

TotalNumberOfMessagesWithErrors には、TotalInputMessages に含まれていないメッセージを含めることができます。
TotalNumberOfErrorsProcessingMessages Numeric メッセージ処理時のエラー数
TotalNumberOfTimeOutsWaitingForRepliesToAggregateMessages Numeric メッセージ処理時のタイムアウト回数 (AggregateReply ノードのみ)
TotalNumberOfCommits Numeric トランザクション・コミットの回数
TotalNumberOfBackouts Numeric トランザクション・バックアウトの回数
AccountingOrigin 文字 (最大 32) アカウンティング起点

下記の表では、「ThreadStatistics」フォルダーに作成される、各スレッドごとのスレッドの統計情報について説明されています。

フィールド データ・タイプ 詳細
Number Numeric プール内の関連スレッド数
TotalNumberOfInputMessages Numeric スレッドによって処理されたメッセージの総数
TotalElapsedTime Numeric 入力メッセージの処理にかかった経過時間の合計 (マイクロ秒)
TotalCPUTime Numeric 入力メッセージの処理にかかったプロセッサー時間の合計 (マイクロ秒)
CPUTimeWaitingForInputMessage Numeric 入力メッセージを待機したプロセッサー時間の合計 (マイクロ秒)
ElapsedTimeWaitingForInputMessage Numeric 入力メッセージを待機した経過時間の合計 (マイクロ秒)
TotalSizeOfInputMessages Numeric 入力メッセージの合計サイズ (バイト単位)
MaximumSizeOfInputMessages Numeric 入力メッセージの最大サイズ (バイト単位)
MinimumSizeOfInputMessages Numeric 入力メッセージの最小サイズ (バイト単位)

下記の表では、「NodesStatistics」フォルダーに作成される、各ノードごとのノードの統計情報について説明されています。

フィールド データ・タイプ 詳細
Label CHARACTER ノード名 (ラベル)
タイプ CHARACTER ノードのタイプ
TotalElapsedTime Numeric 入力メッセージの処理にかかった経過時間の合計 (マイクロ秒)
MaximumElapsedTime Numeric 入力メッセージの処理にかかった最大経過時間 (マイクロ秒)
MinimumElapsedTime Numeric 入力メッセージの処理にかかった最小経過時間 (マイクロ秒)
TotalCPUTime Numeric 入力メッセージの処理にかかったプロセッサー時間の合計 (マイクロ秒)
MaximumCPUTime Numeric 入力メッセージの処理にかかった最大プロセッサー時間 (マイクロ秒)
MinimumCPUTime Numeric 入力メッセージの処理にかかった最小プロセッサー時間 (マイクロ秒)
CountOfInvocations Numeric このノードによって処理されたメッセージの合計数
NumberOfInputTerminals Numeric 入力ターミナルの数
NumberOfOutputTerminals Numeric 出力ターミナルの数

下記の表では、「TerminalStatistics」フォルダーで作成される、ターミナルの統計情報について説明されています。

フィールド データ・タイプ 詳細
Label CHARACTER ターミナルの名前
タイプ CHARACTER ターミナルのタイプ (以下のいずれか)
  • 入力
  • 出力
CountOfInvocations Numeric 呼び出しの合計数