Cosminexus V9 BPM/ESB基盤 サービスプラットフォーム システム構築・運用ガイド

[目次][用語][索引][前へ][次へ]

7.4.6 保守用ログおよびトレース

障害調査に必要な情報として,保守用のログおよびトレースなどを採取します。

<この項の構成>
(1) 例外ログ
(2) メンテナンスログ
(3) メソッドトレース

(1) 例外ログ

HCSCサーバの障害時の内部エラー情報やビジネスプロセスの障害情報などは,例外ログとして取得します。例外ログは,保守員が障害解析用に使用します。サービスプラットフォームの例外ログとして出力される内容と出力先を次の表に示します。

表7-57 例外ログの出力内容と出力先

例外ログの種類 出力される内容 例外ログファイルの出力先パス ログファイル名
HCSC-Managerの例外ログ HCSC-Manager内部の例外情報を取得します。 HCSC-Manager定義ファイル※1のcscmng.log.dirパラメタで指定したパス exception<面数>.log※1
J2EEサーバの障害発生時の例外情報 HCSCサーバで障害が発生したときの内部の例外情報を取得します。 J2EEサーバの例外ログ(障害発生時の例外情報)の出力先※2に指定されたパス
  • ラップアラウンドモードの場合
    cjexception<面数>.log※1
  • シフトモードの場合
    cjexception.log
HCSCサーバの例外ログ 次の場所で発生した例外情報(スタックトレース)を取得します。
  • カスタム受付フレームワーク,カスタムアダプタ開発フレームワークのEJB呼び出し部分
  • カスタム受付フレームワーク,カスタムアダプタ開発フレームワークを使用する受付およびサービスアダプタ
  • HCSCサーバ(標準受付,SOAP受付,メッセージ配送制御,SOAPアダプタ,SessionBeanアダプタ,MDB(WS-R)アダプタ,MDB(DBキュー)アダプタなど)
HCSCサーバランタイム定義ファイル※3のmethodtrace-filepathプロパティで指定したパス
  • ラップアラウンドモードの場合
    cscmsgexp_<HCSCサーバ名>_<面数>.log※3
  • シフトモードの場合
    cscmsgexp_<HCSCサーバ名>_.log
DBアダプタの例外ログ DBアダプタで障害が発生した場合にスタックトレースを取得します。 HCSCサーバランタイム定義ファイル※3のmethodtrace-filepathプロパティで指定したパス
  • ラップアラウンドモードの場合
    cscdbaexp_<HCSCサーバ名>_<面数>.log※3
  • シフトモードの場合
    cscdbaexp_<HCSCサーバ名>_.log
TP1アダプタの例外ログ TP1アダプタで障害が発生した場合にスタックトレースを取得します。 <J2EEサーバのログ出力ディレクトリ>\CSCADP\TP1ADP\maintenance\<サービスID>
  • ラップアラウンドモードの場合
    exception<面数>.log※4
  • シフトモードの場合
    exception.log
Object Accessアダプタの例外ログ Object Accessアダプタで障害が発生した場合にスタックトレースを取得します。 <J2EEサーバのログ出力ディレクトリ>\CSCADP\OAADP\maintenance\<サービスID>
  • ラップアラウンドモードの場合
    exception<面数>.log※5
  • シフトモードの場合
    exception.log
Message Queueアダプタの例外ログ Message Queueアダプタで障害が発生した場合にスタックトレースを取得します。 <J2EEサーバのログ出力ディレクトリ>\CSCADP\MQADP\maintenance\<サービスID>
  • ラップアラウンドモードの場合
    exception<面数>.log※6
  • シフトモードの場合
    exception.log
FTPアダプタの例外ログ FTPアダプタで障害が発生した場合にスタックトレースを取得します。 FTPアダプタ実行環境プロパティファイルで指定したパス※7
  • ラップアラウンドモードの場合
    cscftpadpexp_<HCSCサーバ名>_<面数>.log※7
  • シフトモードの場合
    cscftpadpexp_<HCSCサーバ名>_.log
ファイル操作アダプタの例外ログ ファイル操作アダプタで障害が発生した場合にスタックトレースを取得します。 <J2EEサーバのログ出力ディレクトリ>\CSCADP\ADPFOP\maintenance\<サービスID>
  • ラップアラウンドモードの場合
    cscadpfopexp_<HCSCサーバ名>_<面数>.log※8
  • シフトモードの場合
    cscadpfopexp_<HCSCサーバ名>_.log
メールアダプタの例外ログ メールアダプタで障害が発生した場合にスタックトレースを取得します。 メールアダプタ実行環境プロパティファイルで指定したパス※9
  • ラップアラウンドモードの場合
    cscmailadpexp_<HCSCサーバ名>_<面数>.log※9
  • シフトモードの場合
    cscmailadpexp_<HCSCサーバ名>_.log
HTTPアダプタの例外ログ HTTPアダプタで障害が発生した場合にスタックトレースを取得します。 <adphttp.config.trace.pathプロパティ※10で指定したパス>\CSCADP\ADPHTTP\maintenance\<サービスID>
  • ラップアラウンドモードの場合
    cscadphttpexp_<HCSCサーバ名>_<面数>.log※10
  • シフトモードの場合
    cscadphttpexp_<HCSCサーバ名>_.log
コマンドアダプタの例外ログ コマンドアダプタで障害が発生した場合にスタックトレースを取得します。 <J2EEサーバのログ出力ディレクトリ>\CSCADP\ADPCMD\maintenance\<サービスID>
  • ラップアラウンドモードの場合
    cscadpcmdexp_<HCSCサーバ名>_<面数>.log※11
  • シフトモードの場合
    cscadpcmdexp_<HCSCサーバ名>_.log
SFTPアダプタの例外ログ SFTPアダプタで障害が発生した場合にスタックトレースを取得します。 <J2EEサーバのログ出力ディレクトリ>\CSCADP\SFTPADP\maintenance\<サービスID>
  • ラップアラウンドモードの場合
    cscsftpadpexp_<HCSCサーバ名>_<面数>.log※12
  • シフトモードの場合
    cscsftpadpexp_<HCSCサーバ名>_.log
ビジネスプロセスの例外ログ ビジネスプロセスで障害が発生した場合にスタックトレースを取得します。 HCSCサーバランタイム定義ファイル※3のmethodtrace-filepathプロパティで指定したパス
  • ラップアラウンドモードの場合
    cscbpexp_<HCSCサーバ名>_<面数>.log※3
  • シフトモードの場合
    cscbpexp_<HCSCサーバ名>_.log

注※1
HCSC-Manager定義ファイルで次のパラメタを指定します。
 cscmng.log.exception.filesize=例外ログファイルサイズ
 cscmng.log.exception.filenum=例外ログファイル面数
 cscmng.log.dir=例外ログ出力先ディレクトリパス
HCSC-Manager定義ファイルの詳細については,マニュアル「サービスプラットフォーム リファレンス」の「HCSC-Manager定義ファイル」を参照してください。

注※2
J2EEサーバの例外ログ(障害発生時の例外情報)の出力先は,usrconf.cfg(J2EEサーバ用オプション定義ファイル)で指定します。デフォルトの出力先は,<サービスプラットフォームのインストールディレクトリ>\CC\server\public\ejb\<J2EEサーバ名>\logsです。
usrconf.cfgの詳細については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.3 usrconf.cfg(J2EEサーバ用オプション定義ファイル)」を参照してください。
例外ログのファイルのサイズや面数などは,usrconf.properties(J2EEサーバ用ユーザプロパティファイル)で指定します。usrconf.propertiesの詳細については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.4 usrconf.properties(J2EEサーバ用ユーザプロパティファイル)」を参照してください。また,ログファイルのローテーション方式などの設定については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

注※3
HCSCサーバランタイム定義ファイルでの出力先パスと面数の指定については,マニュアル「サービスプラットフォーム リファレンス」の「HCSCサーバランタイム定義ファイル」を参照してください。

注※4
TP1アダプタ実行環境プロパティファイルでの面数の指定については,マニュアル「サービスプラットフォーム リファレンス」の「TP1アダプタ実行環境プロパティファイル」を参照してください。

注※5
Object Accessアダプタ実行環境プロパティファイルでの面数の指定については,マニュアル「サービスプラットフォーム リファレンス」の「Object Accessアダプタ実行環境プロパティファイル」を参照してください。

注※6
Message Queueアダプタ実行環境プロパティファイルでの面数の指定については,マニュアル「サービスプラットフォーム リファレンス」の「Message Queueアダプタ実行環境プロパティファイル」を参照してください。

注※7
例外ログファイルは保守用ログと同じディレクトリに出力されます。FTPアダプタ実行環境プロパティファイルでの出力先パスと面数の指定については,マニュアル「サービスプラットフォーム リファレンス」の「FTPアダプタ実行環境プロパティファイル」を参照してください。

注※8
例外ログファイルは保守用ログと同じディレクトリに出力されます。ファイル操作アダプタ実行環境プロパティファイルでの面数の指定については,マニュアル「サービスプラットフォーム リファレンス」の「ファイル操作アダプタ実行環境プロパティファイル」を参照してください。

注※9
例外ログファイルは保守用ログと同じディレクトリに出力されます。メールアダプタ実行環境プロパティファイルでの出力先パスと面数の指定については,マニュアル「サービスプラットフォーム リファレンス」の「メールアダプタ実行環境プロパティファイル」を参照してください。

注※10
例外ログファイルは保守用ログと同じディレクトリに出力されます。HTTPアダプタ実行環境プロパティファイルでの出力先パスと面数の指定については,マニュアル「サービスプラットフォーム リファレンス」の「HTTPアダプタ実行環境プロパティファイル」を参照してください。

注※11
例外ログファイルは保守用ログと同じディレクトリに出力されます。コマンドアダプタ実行環境プロパティファイルでの面数の指定については,マニュアル「サービスプラットフォーム リファレンス」の「コマンドアダプタ実行環境プロパティファイル」を参照してください。

注※12
例外ログファイルは保守用ログと同じディレクトリに出力されます。SFTPアダプタ実行環境プロパティファイルでの面数の指定については,マニュアル「サービスプラットフォーム リファレンス」の「SFTPアダプタ実行環境プロパティファイル」を参照してください。

(2) メンテナンスログ

HCSC-Manager内部の保守情報をメンテナンスログとして取得できます。HCSC-Managerと外部要素(Manager,HCSC管理MBean,リポジトリ)との通信トレース,電文ログとしても使用されます。保守員が障害解析用に使用します。

メンテナンスログとして出力される内容と出力先を次の表に示します。

表7-58 メンテナンスログの出力内容と出力先

出力される内容 メンテナンスログファイルの出力先パス ログファイル名
HCSC-Manager内部の保守情報を取得します。 HCSC-Manager定義ファイルのcscmng.log.dirパラメタで指定したパス maintenance<面数>.log

(3) メソッドトレース

HCSCサーバで障害が発生し,原因の究明が困難な場合に,必要な情報をメソッドトレースとして取得できます。保守員が障害解析のために使用します。

メソッドトレースとして出力される内容と出力先を次の表に示します。

表7-59 メソッドトレースの出力内容と出力先

メソッドトレースの種類 出力される内容 メソッドトレースの出力先パス トレースファイル名
HCSCサーバ(メッセージング基盤)のメソッドトレース HCSCサーバ(メッセージング基盤)内部の保守情報を取得します。 HCSCサーバランタイム定義ファイルのmethodtrace-filepathプロパティで指定したパス。
指定したパスが存在しない場合,またはパスが誤っていた場合は,省略値の出力先にトレースが出力されます。

  • ラップアラウンドモードの場合
    cscmsgmtd_<HCSCサーバ名>_<面数>.log
  • シフトモードの場合
    cscmsgmtd_<HCSCサーバ名>_.log
HCSCサーバ(ビジネスプロセス基盤)のメソッドトレース HCSCサーバ(ビジネスプロセス基盤)内部の保守情報を取得します。
ビジネスプロセス基盤には,ビジネスプロセス実行時のトレースとプロセスインスタンス関連のコマンド実行時のトレースがあります。このマニュアルでは,ビジネスプロセス実行時のトレースについて説明します。
プロセスインスタンス関連のコマンド実行時のトレースはManagement Serverで出力されるトレースと同様です。詳細については,マニュアル「アプリケーションサーバ 機能解説 保守/移行編」を参照してください。

  • ラップアラウンドモードの場合
    cscbpmtd_<HCSCサーバ名>_<面数>.log
  • シフトモードの場合
    cscbpmtd_<HCSCサーバ名>_.log
HCSCサーバ(DBアダプタ)のメソッドトレース HCSCサーバ(DBアダプタ)内部の保守情報を取得します。
DBアダプタ以外のサービスアダプタのメソッドトレースについては,「7.7 サービス部品呼び出し要求時の障害対策」の各サービスアダプタの説明を参照してください。

  • ラップアラウンドモードの場合
    cscdbamtd_<HCSCサーバ名>_<面数>.log
  • シフトモードの場合
    cscdbamtd_<HCSCサーバ名>_.log