7.7.21 スケジュール駆動受付実行時の障害対策
この項では,スケジュール駆動受付の運用時に発生する障害に対して取得できる情報の種類について説明します。
スケジュール駆動受付に関する障害情報には次の種類があります。
-
メッセージログ
-
メソッドトレース
-
性能解析トレース
-
例外ログ
-
イベント履歴ログ
これらの障害情報について説明します。
- 〈この項の構成〉
(1) スケジュール駆動受付実行時に発生したエラーの伝わり方
スケジュール駆動受付のエラーの伝わり方は,エラーの種類によって異なります。
ここでは,次の場合についてエラーの伝わり方を説明します。
-
カスタム受付フレームワークがエラーをリターンした場合
-
スケジュール駆動受付がエラーを検知した場合
(a) カスタム受付フレームワークがエラーをリターンした場合
カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方を次の図に示します。
図中に示したエラー1〜エラー5の要因を次に示します。
-
エラー1:要求パラメタ不正など
-
エラー2:宛先(ロケーション)が見つからない,サービスアダプタが停止しているなど
-
エラー3:データ変換の失敗など
-
エラー4:宛先不正,サービス部品が停止,通信障害など
-
エラー5:ビジネスプロセス処理上での例外エラーなど
エラー1〜エラー5のどれかが発生した場合,例外をキャッチしたカスタム受付フレームワークはスケジュール駆動受付の受付処理に対して,CSCMsgServerExceptionをスローします。スケジュール駆動受付の受付処理は,キャッチした例外を基にエラーメッセージを作成し,メッセージログに出力します。
CSCMsgServerExceptionの詳細は,マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.3 カスタム受付フレームワークのAPI」を参照してください。
(b) スケジュール駆動受付がエラーを検知した場合
スケジュール駆動受付がエラーを検知した場合のエラーの伝わり方を次の図に示します。
スケジュール駆動受付は検知した障害を基にエラーメッセージを生成し,メッセージログに出力します。
(2) メッセージログ
メッセージログのJ2EEサーバの稼働ログに,スケジュール駆動受付で発生した各種情報がメッセージとして出力されます。
メッセージログの出力内容や出力先については,「7.4.1 メッセージログ」を参照してください。
(3) メソッドトレース
スケジュール駆動受付のメソッドトレースは,サービスプラットフォームが出力するメソッドトレースの仕様に従います。
メソッドトレースの出力内容および出力先については,「7.4.7(3) メソッドトレース」の「HCSCサーバ(メッセージング基盤)のメソッドトレース」を参照してください。
(4) 性能解析トレース
スケジュール駆動受付の性能解析トレースについて説明します。
(a) 出力形式
性能解析トレースファイルに出力される形式は,J2EEサーバの性能解析トレースと同様です。詳細は,マニュアル「アプリケーションサーバ 機能解説 保守/移行編」の「7. 性能解析トレースを使用した性能解析」を参照してください。
(b) 出力される内容
性能解析トレースファイルに出力される内容を次の表に示します。
項目 |
内容 |
|
---|---|---|
イベントID |
取得ポイントのイベントIDが出力されます。 取得ポイントの詳細は,「(c) 性能解析トレースの取得ポイント」を参照してください。 |
|
リターンコード |
取得ポイント種別が出力されます。
|
|
インターフェース名 |
クラス名が出力されます。 |
|
オペレーション名 |
メソッド名が出力されます。 |
|
オプション情報※ |
メッセージ共通ID |
リクエスト識別情報(親ID)が出力されます。 情報を設定していない場合はnullになります。 |
サービスリクエストID |
リクエスト識別情報(子ID)が出力されます。 情報を設定していない場合はnullになります。 |
|
付加情報 |
次のオプション情報が出力されます。
|
(c) 性能解析トレースの取得ポイント
性能解析トレースの取得ポイントを次の図に示します。
イベントID,トレース取得ポイント,および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。
イベントID |
図中の番号 |
トレース取得ポイント |
レベル |
---|---|---|---|
0x98F0 |
1 |
カスタム受付の入口 |
A |
0x98F1 |
2 |
カスタム受付の出口 |
A |
0x98F2 |
3 |
カスタム受付フレームワークの呼び出し口 |
B |
0x98F3 |
4 |
カスタム受付フレームワークの応答受信口 |
B |
0x9860 |
5 |
カスタム受付フレームワークの入口 |
A |
0x9861 |
6 |
カスタム受付フレームワークの出口 |
A |
0x9864 |
7 |
HCSCメッセージ配送制御の呼び出し口 |
A |
0x9865 |
8 |
HCSCメッセージ配送制御の応答受信口 |
A |
(d) 性能解析トレースの取得方法と出力先
性能解析トレースを取得するには設定が必要です。設定の詳細は,マニュアル「アプリケーションサーバ 機能解説 保守/移行編」の「7. 性能解析トレースを使用した性能解析」を参照してください。
(5) 例外ログ
例外ログには例外情報が出力されます。例外ログの概要については,「7.4.7(1) 例外ログ」の「HCSCサーバの例外ログ」を参照してください。
(6) イベント履歴ログ
スケジュール駆動受付では,イベントの履歴をイベント履歴ログとして出力します。イベント履歴ログによって,イベント発生時に実行されたタスクが完了したことや,タスクの実行が省略されたことを確認できます。
イベント履歴ログはスケジュール駆動受付ごとに出力されます。イベント履歴ログはデフォルトで出力されますが,出力しないよう設定することもできます。
以降でスケジュール駆動受付のイベント履歴ログについて説明します。
(a) 出力形式
スケジュール駆動受付の出力形式を次に示します。
(b) 出力される内容
イベント履歴ログに出力される内容を次の表に示します。
項目 |
内容 |
---|---|
番号 |
トレースレコードの出力通番が表示されます。 |
日付 |
トレースレコードの取得日付(yyyy/mm/dd形式)が出力されます。 |
時刻 |
トレースレコードの取得時刻(hh:mm:ss.SSS形式)が,ローカル時刻でミリ秒単位に出力されます。 |
製品ID |
製品を特定するための識別子として,スケジュール駆動受付を示す「RCPSCD」が出力されます。 |
pid |
プロセスを識別するためのIDが出力されます。 |
tid |
スレッドを識別するためのIDが出力されます。 |
ID |
表示されません。 |
受付ID |
受付IDが出力されます。 |
取得ポイント |
取得ポイント情報として次に示す情報が出力されます。
|
RootAP情報 |
ルートアプリケーション情報 |
付加情報 |
次に示す時刻が「yyyy/MM/dd HH:mm:ss」形式のローカル時刻で出力されます。出力される時刻は,取得ポイント情報によって異なります※4。
時刻を複数出力する場合は「,(コンマ)」で区切られます。 |
CRLF |
レコード終端符号が出力されます。 |
- 注※1
-
次の両方の条件に当てはまる場合に出力されます。
-
スケジュール駆動受付内の処理が正常応答した
-
スケジュール駆動受付の呼び出し先から正常応答が返された
タイマ監視機能のタイムアウト発生時に条件が当てはまる場合を含みます。
-
- 注※2
-
次のどちらかの条件に当てはまる場合に出力されます。
-
ビジネスプロセスからエラー応答が返却された
-
スケジュール駆動受付内でエラーが発生した
タイマ監視機能のタイムアウト発生時に条件が当てはまる場合を含みます。
-
- 注※3
-
次のどちらかの条件に当てはまる場合に出力されます。
-
イベント発生時に実行中のタスクがあり,かつ,新たにタスクを生成しない設定になっている場合
-
イベント処理が続行できない場合
詳細については,マニュアル「サービスプラットフォーム 解説」の「3.6 ビジネスプロセスのスケジュール設定」を参照してください。
-
- 注※4
-
付加情報で出力される時刻を取得ポイント情報ごとに次の表に示します。
取得ポイント情報
付加情報の出力時刻
イベントの発生時刻
タスク処理の開始時刻
タスク処理の終了時刻
CALL
〇
〇
×
RET
〇
〇
〇
ERROR
〇
〇
〇
OMIT
〇
×
×
- (凡例)
-
〇:時刻が出力される
×:時刻が出力されない
(c) 取得ポイント
イベント履歴ログの取得ポイントを次の図に示します。
図中の番号の説明を次の表に示します。
図中の番号 |
トレース取得ポイント |
取得ポイント情報 |
---|---|---|
1 |
スケジュール機能のタスク生成前 |
OMIT |
2 |
タスク処理の開始 |
CALL |
3 |
タスク処理の終了 |
RET ERROR |
(d) 出力先
イベント履歴ログの出力先を次に示します。
<J2EEサーバのログ出力ディレクトリ>/csc/rcp/schedule/<受付ID>
<J2EEサーバのログ出力ディレクトリ>は,HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル(usrconf.cfg)のejb.server.log.directoryキーで指定します。J2EEサーバ用オプション定義ファイルについては,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2 usrconf.cfg(J2EEサーバ用オプション定義ファイル)」を参照してください。
イベント履歴ログのログファイル名を次の表に示します。
ログファイルの出力モード |
ログファイル名 |
---|---|
ラップアラウンドモードの場合 |
eventhistory_<面数>.log |
シフトモードの場合 |
eventhistory_.log |
イベント履歴ログのローテーションは,次のどちらかの条件に合致した際に実行されます。
-
指定したローテーション時刻に達したとき
ローテーション時刻の指定方法は,Application Serverの設定に従います。詳細については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3 usrconf.properties(J2EEサーバ用ユーザプロパティファイル)」を参照してください。
-
指定したファイルサイズに達したとき
イベント履歴ログの設定は,次に示すファイルで変更できます。
設定内容 |
変更する項目 |
マニュアル参照先 |
---|---|---|
トレースの出力有無 |
スケジュール駆動受付コンフィグファイルのurecp-scd.eventhistory.log.enabledプロパティ |
マニュアル「サービスプラットフォーム リファレンス」の「6.18.1 スケジュール駆動受付コンフィグファイル」 |
ファイルサイズ |
スケジュール駆動受付コンフィグファイルのurecp-scd.eventhistory.log.filesizeプロパティ |
|
ファイル面数 |
スケジュール駆動受付コンフィグファイルのurecp-scd.eventhistory.log.filenumプロパティ |
|
ファイル出力先 |
J2EEサーバ用オプション定義ファイル(usrconf.cfg)のejb.server.log.directory |
マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2 usrconf.cfg(J2EEサーバ用オプション定義ファイル)」 |
(e) イベント履歴ログに関する注意事項
イベント履歴ログの初期化や停止に失敗した場合は,次のように動作します。
-
スケジュール駆動受付の起動時に,イベント履歴ログのロガー初期化に失敗した場合,メッセージログにワーニングメッセージ(KDEC84252-W)を出力して起動処理を継続します。デフォルトの出力先へログ出力できなかった場合は,該当するスケジュール駆動受付はイベント履歴ログを取得しないで運用を継続します。
-
スケジュール駆動受付の停止時に,イベント履歴ログのロガーの停止に失敗した場合,メッセージログにワーニングメッセージ(KDEC84253-W)を出力して停止処理を継続します。
(7) スケジュール駆動受付の障害情報
スケジュール駆動受付で発生する障害の種類と,障害発生時の動作を説明します。
(a) スケジュール駆動受付のデプロイ時の障害
スケジュール駆動受付定義ファイルの定義が誤っている場合,スケジュール駆動受付のデプロイに失敗します。
主な原因として,スケジュール駆動受付定義ファイルに誤った値を設定していることが考えられます。
(b) スケジュール駆動受付の起動時の障害
定義ファイルの解析に失敗した場合,スケジュール駆動受付の起動に失敗します。主な原因を次に示します。
-
スケジュール駆動受付定義ファイルの設定値に誤りがある。
-
スケジュール駆動受付コンフィグファイルの設定値に誤りがある。
スケジュール機能の開始に失敗した場合,メッセージKDEC84254-Eが出力され,スケジュールは実行されません。ただし,スケジュール駆動受付の起動処理は続行されます。
(c) スケジュールの実行時の障害
スケジュールの実行時の障害を次に示します。
-
ビジネスプロセスの処理時に発生した障害
スケジュール駆動受付が例外を受け取った場合,メッセージログに次のエラーメッセージが出力されます。この場合,タスク処理が失敗したとみなされますが,スケジュールの実行は続行します。
-
スケジュール駆動受付がランタイム例外やエラー(システム例外)を受け取った場合
メッセージログにエラーメッセージKDEC84202-Eが出力されます。
-
上記以外の例外(業務例外)を受け取った場合
メッセージログにエラーメッセージKDEC84200-Eが出力されます。
-
-
スケジュール駆動受付の処理時に発生した障害
-
作業フォルダの作成に失敗した場合
メッセージログにエラーメッセージが出力され,タスク処理が失敗したとみなされます。スケジュールの実行は続行されます。
作業フォルダの作成に失敗するケースと原因を次に示します。
作業フォルダの作成に失敗するケース
出力されるメッセージ
想定される原因
作業フォルダのルートフォルダが存在しない
KDEC84205-E
HCSCサーバ起動後に,ユーザが作業フォルダのルートフォルダを削除した
作業フォルダの作成に失敗
KDEC84206-E
ディスクフル
-
作業フォルダの削除に失敗した場合
メッセージログに警告メッセージKDEC84207-Wが出力されます。タスク処理とスケジュールの実行は続行します。
-
スケジュール機能が異常停止した場合
エラーメッセージKDEC84212-Eが出力されます。スケジュールは実行されません。
-
(d) スケジュール駆動受付の停止時の障害
予期しない例外を除いて,障害が発生するケースはありません。
(e) スケジュール駆動受付のアンデプロイ時の障害
予期しない例外を除いて,障害が発生するケースはありません。