snapshotログの収集のタイミングと取得のための設定を次の表に示します。

表5-2　snapshotログの収集のタイミングと取得のための設定

分類	収集のタイミング	デフォルトの設定を変更するために必要な設定
自動的に収集する※	論理サーバが障害時に自動停止される直前	障害検知時コマンドの設定 snapshotログの収集先のカスタマイズ
	J2EEサーバが障害時に自動再起動される直前
	J2EEサーバを手動で一括再起動する直前	snapshotログの収集先のカスタマイズ
任意のタイミングで収集する	Management Serverの運用管理コマンド（mngsvrutil）でsnapshotログの収集を実行したとき

注※　論理サーバの停止前，またはJ2EEサーバの再起動前のどちらのタイミングでsnapshotログを収集するかは，mserver.propertiesのcom.cosminexus.mngsvr.snapshot.collect.pointキーで変更できます。デフォルトの設定では，論理サーバの停止前にsnapshotログが収集されます。

(a)　自動的に収集する場合

次に示すどちらかのタイミングでsnapshotログを自動的に収集する場合には，Management Serverによって障害検知時コマンドが実行されて，スレッドダンプと性能解析トレースなどの資料が取得されます。

• 論理サーバが障害時に自動停止される直前（デフォルトの設定）
• J2EEサーバが障害時に自動再起動される直前

障害検知時コマンドで取得された資料は，snapshotログとして収集できます。障害検知時コマンドの動作や設定の変更については，「5.3　障害検知時コマンドによる資料取得の設定」を参照してください。

(b)　任意のタイミングで収集する場合

任意のタイミングでsnapshotログを収集する場合には，スレッドダンプファイルやユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）が出力されているときだけ，snapshotログとして収集できます。任意のタイミングでsnapshotログを収集する際に，コマンドが実行されてスレッドダンプファイルやユーザダンプまたはcoreダンプが出力されることはありません。

Management Serverの運用管理コマンド（mngsvrutil）を実行して任意のタイミングでsnapshotログを収集する場合は，コマンド実行時に収集先の種別（種別1，種別2）を指定して収集できます。それ以外のタイミングでは，種別1と種別2それぞれの収集対象として定義されているファイルがすべて収集されます。

トラブルシューティングに必要な資料は，資料を保守員へ送付するときのタイミングによって，一次送付資料と二次送付資料に分類されます。snapshotログでは，一次送付資料と二次送付資料を収集できます。

• 一次送付資料
  メールの添付資料として送付できるファイルサイズの資料が該当します。メールなどで早急に保守員に送付できます。
  一次送付資料としてどのファイルを収集するかは，一次送付資料用のsnapshotログ収集先対象リストファイル（snapshotlog.conf）で指定します。mngsvrutilコマンドで引数snapshot 1を指定してsnapshotログを収集する場合は，snapshotlog.confに指定されているファイルが収集されます。
  
• 二次送付資料
  一次送付資料に加えて，ファイルサイズが比較的大きい資料が該当します。ファイルサイズが比較的大きい資料は資料の送付に時間が掛かるため，別途，保守員に送付する必要があります。
  二次送付資料としてどのファイルを収集するかは，二次送付資料用のsnapshotログ収集先対象リストファイル（snapshotlog.2.conf）で指定します。mngsvrutilコマンドで引数snapshot 2を指定してsnapshotログを収集する場合は，snapshotlog.confとsnapshotlog.2.confに指定されているファイルが収集されます。
  

snapshotlog.confおよびsnapshotlog.2.confの指定については，「(3)　snapshotログの収集先のカスタマイズ」を参照してください。

デフォルトの設定で一次送付資料および二次送付資料として収集できる資料を次の表に示します。

表5-3　デフォルトの設定で一次送付資料および二次送付資料として収集できる資料

資料の種類	一次送付資料	二次送付資料
メッセージログ	○	○
ユーザログ	○	○
例外ログ	○	○
保守用ログ	○	○
性能解析トレース	−	○※1
JavaVMのスレッドダンプ	○※1	○※1
JavaVMのガーベージコレクションのログ	○	○
メモリダンプ	−	○
JavaVMログファイル	○	○
エラーリポートファイル	○	○
OSの状態・ログ	○	○
OSの統計情報	○	○
定義情報	○	○
作業ディレクトリ	○	○
リソースの設定	−※2	○
Webサーバのログ	○	○
JavaVMのスタックトレース情報	○※1 ※3	○※1 ※3
稼働情報	○	○
監査ログ	−	○

（凡例）

○：収集できる。　−：収集できない。

注

Cosminexusの各構成ソフトウェアが出力するメッセージログや保守用ログは，snapshotログのデフォルトの設定では，構成ソフトウェアのインストール時にデフォルトで作成されたディレクトリだけが収集対象となっています。構成ソフトウェアのログの出力先を変更している場合には，収集先も変更してください。

注※1

システム提供の障害検知時コマンドによって取得されたものが，snapshotログとして収集されます。システム提供の障害検知時コマンドについては，「5.3　障害検知時コマンドによる資料取得の設定」を参照してください。

注※2

デフォルトの設定では，snapshotlog.confには収集先のパスが記述されていますが，コメントが付いているため収集対象外となっています。コメントを外すと収集できます。

注※3

UNIXの場合だけ取得できる資料です。

デフォルトでsnapshotログの収集先として定義されていないファイルをsnapshotログとして収集したい場合には，そのファイルの出力先をsnapshotログ収集先対象リストファイルに追加してください。また，資料によっては，次のような設定も必要になります。

• 運用開始前の資料取得のための設定
  運用開始前に，資料取得のための設定をしておく必要があります。
  
• コマンドなどによる資料の取得
  snapshotログとして収集する前に，コマンドを実行して収集対象の資料を取得しておく必要があります。資料の取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。
  

（例）

ユーザダンプまたはcoreダンプは，運用開始前にワトソン博士の設定またはcoreファイルのサイズの設定が必要です。運用開始前に取得のための設定をした上で，ユーザ作成の障害検知時コマンドを使用して障害発生時のユーザダンプまたはcoreダンプを取得し，そのユーザダンプまたはcoreダンプをsnapshotログとして収集することをお勧めします。

また，デフォルトのsnapshotログ収集先対象リストファイルには，ユーザダンプまたはcoreダンプのデフォルトの出力先が指定されています。ワトソン博士を設定した場合やOSをCドライブ以外に設定した場合にはsnapshotログの収集先を変更する必要があります。

運用開始前に実施する取得のための設定については，「5.17　ユーザダンプ取得の設定」，または「5.18　coreダンプ取得の設定」を参照してください。ユーザ作成の障害検知時コマンドについては，「5.3　障害検知時コマンドによる資料取得の設定」を参照してください。

snapshotログの収集先は，snapshotログ収集先対象リストファイルでカスタマイズできます。また，adminagent.propertiesでは，論理サーバごとのsnapshotログのファイル数を指定できます。ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(a)　snapshotログの収集先の指定

snapshotログ収集先対象リストファイルを編集して，snapshotログの収集先を指定してください。snapshotログ収集先対象リストファイルの格納場所を次に示します。

• Windowsの場合
  <Cosminexusのインストールディレクトリ>\manager\config\snapshotlog.conf
  <Cosminexusのインストールディレクトリ>\manager\config\snapshotlog.2.conf
  
• UNIXの場合
  /opt/Cosminexus/manager/config/snapshotlog.conf
  /opt/Cosminexus/manager/config/snapshotlog.2.conf
  

snapshotlog.confでは，一次送付資料として収集するファイルの格納ディレクトリを指定します。また，snapshotlog.2.confでは，二次送付資料として収集するファイルの格納ディレクトリを指定します。

なお，このリストファイルでは変数を使用できます。例えば，Cosminexusのインストールディレクトリを表す変数「${cosminexus.home}」を使用して，リストファイルに「${cosminexus.home}/manager/log/.+」（ピリオド（.）は任意の文字，プラス（+）は1回以上を表します）と指定すると，<Cosminexusのインストールディレクトリ>\manager\log（Windowsの場合），または/opt/Cosminexus/manager/logディレクトリ（UNIXの場合）直下のファイルがすべて収集されます。なお，リストファイルの変数の値には，ドル記号（$）を含めないでください。

(b)　snapshotログのファイル数の指定

adminagent.propertiesでは，論理サーバごとのsnapshotログファイルの数を指定できます。

• adminagent.snapshotlog.num_snapshots
  一次送付資料として収集する，論理サーバごとのsnapshotログファイルの数を指定します。
  
• adminagent.snapshotlog.listfile.2.num_snapshots
  二次送付資料として収集する，論理サーバごとのsnapshotログファイルの数を指定します。