付録B.4 ワークフローログの編集方法

ここでは,稼働状況解析ユティリティを使用したログ編集機能について説明します。稼働状況解析ユティリティについては,「5.1 以前のバージョンとの互換のための環境設定」を参照してください。

<この項の構成>
(1) ログ編集機能の概要
(2) ワークフローログレコードファイルのディスク容量見積もり
(3) 編集するワークフローログの選択
(4) ワークフローログレコードファイルの管理
(5) ログ編集機能の別サーバマシンでの実行

(1) ログ編集機能の概要

ログ編集機能を使用すると,業務結果の各種視点からの分析や統計情報の取得などに有効な,ワークフローログレコードを作成できます。

ワークフローログレコードは,アンロードジャーナルファイルとビジネスプロセス定義情報ファイルを基に,ログ編集機能で作成します。

このワークフローログレコードを表計算ソフトなどで利用すると,ノードごとの案件の滞留時間,特定時間のノードごとの処理案件数などの統計を取得できます。

ワークフローログレコードの形式の詳細は,「付録C.3 ワークフローログレコードファイルのデータ形式」を参照してください。

ワークフローログレコードの一覧を表B-2に示します。

表B-2 ワークフローログレコードの一覧

ワークフローログの種類内容
begin_workワークの生成に関する情報
move_root_caseノード間の案件の遷移に関する情報
send_consult_case相談に関する情報
go_root_case案件の遷移要求に関する情報
suspend_root_case案件の一時停止に関する情報
suspend_workワーク単位での案件の一時停止に関する情報
ready_root_case案件の再開始に関する情報
ready_workワーク単位での案件の再開始に関する情報
put_root_case案件の投入に関する情報
cancel_workワークのキャンセルに関する情報
role_to_userロールトレーからユーザトレーへの案件の移動に関する情報
send_answer_case相談の回答に関する情報
api_msgユーザが出力したログデータに関する情報
send_back_root_case案件の差し戻し要求に関する情報
take_back_root_case案件の引き戻し要求に関する情報
end_of_root_case案件の遷移終了に関する情報
end_of_workワークの終了に関する情報
put_case_from_BP他のビジネスプロセスからの案件の投入に関する情報
send_back_to_BP他のビジネスプロセスへの案件の差し戻しに関する情報

(2) ワークフローログレコードファイルのディスク容量見積もり

ワークフローログレコードファイルのディスク容量は,アンロードジャーナルファイルの容量に比例します。

このため,大容量のアンロードジャーナルファイルを編集する場合,ディスクの容量不足とならないように,ワークフローログレコードファイルのディスク容量を見積もる必要があります。

ワークフローログレコードファイルのディスク容量は,次の概算式を参考にして見積もってください。

[図データ]

W
アンロードジャーナルファイルに含まれるワーク数
n
1ワーク当たりのユーザが処理したノード数
m
1ワーク当たりのケース数

(3) 編集するワークフローログの選択

ログ編集機能では,編集したいワークフローログレコード種別を選択できます。

あらかじめ稼働状況の分析に必要なワークフローログレコード種別が限定できる場合,編集するワークフローログレコード種別を選択すると,実行時間を短縮し,ディスク容量を節約できます。

(4) ワークフローログレコードファイルの管理

ワークフローログレコードファイルは,ログ編集機能実行時に出力されます。

デフォルトの出力先は,%WFdir%¥analyst¥runtime.lgです。「%WFdir%」はWorkflowインストール先ディレクトリ,「analyst」は稼働状況解析ユティリティ作業ディレクトリを示します。稼働状況解析ユティリティ作業ディレクトリのパス名は,環境設定ユティリティの[稼働状況解析ユティリティ作業ディレクトリ名]で確認できます。

ログ編集機能実行後は,ワークフローログレコードファイルを別ディレクトリ下に移動してください。上書きによって編集結果が紛失することを防ぐため,ワークフローログレコードファイルが存在する場合はログ編集機能を実行できません。

(5) ログ編集機能の別サーバマシンでの実行

ログ編集機能は,システムリソース(メモリ,ディスクなど)に負荷をかけるため,Workflowシステムを終了してから実行するか,Workflowシステムが稼働しているサーバマシンとは別のサーバマシンでの実行をお勧めします。

(a) 別サーバマシンでログ編集機能を実行する場合の条件

Workflowシステムが稼働しているサーバマシンとは別のサーバマシンでログ編集機能を実行する場合,次の条件を確認してください。

(b) 別サーバマシンでログ編集機能を実行する方法

別サーバマシンでログ編集機能を実行する方法を,図B-3に示します。

図B-3 別サーバマシンでのログ編集機能の実行

[図データ]

  1. サーバマシンBの各国対応設定で,サーバマシンAと同じ国及び言語を設定する
  2. サーバマシンBに,稼働状況解析ユティリティ作業ディレクトリを作成する
  3. 環境設定ユティリティで,2.のディレクトリのパス名を「稼働状況解析ユティリティ作業ディレクトリ名」に設定する
  4. サーバマシンBに,処理対象のアンロードジャーナルファイル及びビジネスプロセス定義情報ファイルを転送する。又は,サーバマシンBから,それらのファイルをリモートで参照できるようにする
  5. 稼働状況解析ユティリティを起動して,ログ編集機能を実行する