Windchill でのログ作成の管理
Windchill ログメッセージには、アプリケーションの動作のトラブルシューティングに使用できる例外トレースバックなどの情報が保存されます。
Windchill Directory Serverがインストールされているサーバーから、コマンドラインユーティリティを使用して Windchill Directory Serverのログファイルを管理します。詳細については、を参照してください。
Apache log4j は、Windchill 9.0 以降、ログメッセージの管理および発行のための主なメカニズムとして使用されています。従来のログ機能の中には log4j を利用するように修正されたものもありますが、既存の多くの Windchill ログ機能は以前のリリースのままであり、Windchill プロパティファイルの設定によって管理されています。
10.0 リリースでは、従来の一部の Windchill ログ機能が log4j へ移行されました。
ログを管理するには、以下を熟知している必要があります。
• wt.properties ファイルのログ作成に影響を与えるプロパティ設定。これらのプロパティの詳細については、
<Windchill>/codebase ディレクトリにある
properties.html および
定義済み wt.properties ログファイルの設定を参照してください。
• log4j パッケージに関する一般的な情報。
log4j の概要については、以下の URL のホームページを参照してください。
• Windchill ログに使用される log4j ロガー。
デフォルトの Windchill ロガーについての説明、およびログファイルにエントリを生成するインタフェースとしてどの Java パッケージまたはクラスが使用されるかについては、以下のファイルを参照してください。
<Windchill>/codebase/loggers.html
ロガーに関連付けられた MBean を使用して、ログ内容を一時的に変更できます。ロガーと MBean の関連付けについては、loggers.html ファイルを参照してください。
• log4j ログに影響を与えるプロパティ設定。これらのプロパティ設定は、<Windchill>/codebase/WEB-INF のプロパティファイルにあります。
◦ log4jMethodServer.properties - メソッドサーバーの log4j ログ、およびメソッドサーバーに組み込まれている Tomcat サーブレットエンジンで動作する Windchill Web アプリケーションのログを制御します。
◦ log4jServerManager.properties - サーバーマネージャの log4j ログを制御します。
また、<Windchill>/codebase/log4j.properties ファイルは、別のコンフィギュレーションファイルが指定されていない場合に log4j が使用するデフォルトのコンフィギュレーションファイルとしても使用されます。log4j.properties ファイルは、ほとんどのアプレット、PSE、およびほとんどのコマンドラインアプリケーションのログオプションを制御します。
前記の log4j properties ファイルは、xconfmanager ユーティリティを使用せずに、ファイルを編集して変更する必要があります。これらのファイルを手動で変更する場合は、
カスタマイズの管理の説明に従ってファイルをバックアップしてください。
• log4j ログファイルを表示および送信する方法。
log4j ログファイルを表示または送信するには、いくつかの方法があります。以下に例を示します。
◦ LogsDirViewers MBean ノードを使用して、ログを表示および電子メール送信できます。
◦ > にある「システム設定コレクター」を使用して、ログファイルを収集できます。
◦ 「Log File Viewer」ページで、サーバーのログファイルをサーチ、リスト表示、および参照できます。「システム正常性監視ツール」ページから、このページへリンクできます。「サーバーステータス」ページで「監視ツール」リンクをクリックすると、このページが表示されます。
「サーバーステータス」ページとそのリンクの詳細については、
サーバーステータスを参照してください。
「サーバーステータス」ページの詳細を参照するには、 > からこのページを開き、このページでオンラインヘルプを表示します。
• xconfmanager ユーティリティを使用して、レガシーログのログ設定と詳細度プロパティを永続的に変更する方法。xconfmanager ユーティリティを使用する詳細については、を参照してください。
• ログレベルを表示または設定する方法。
ログレベルを設定するにはいくつかの方法があります。
◦ wt.util.jmx.SetLogLevel コマンドラインユーティリティを使用すると、指定したサーバープロセスの指定したロガーのロガー詳細レベルを設定またはリセットできます。このユーティリティは、次のように指定します。
java wt.util.jmx.SetLogLevel [-ms|-sm|-se|-all]* [-resetAll]
[<logger_name> [<log_level>]]
<ロガー名> はロガーの名前、<ログレベル> は指定した詳細レベルです。ログレベルに指定できる値は、ALL、TRACE、DEBUG、INFO、WARN、ERROR、FATAL、および OFF です。
サーバープロセスは、以下の組み合わせで指定できます。
▪ -sm -- クラスタ内のすべてのサーバーマネージャが対象です。
▪ -ms -- サーブレットエンジンが組み込まれているかどうかにかかわらず、クラスタ内のすべてのメソッドサーバーが対象です。
▪ -se -- クラスタ内のすべてのサーブレットエンジンが対象です。
▪ -all -- 上記すべてのプロセスが対象です。何も指定しない場合は、これを指定したものと見なされます。
-resetAll オプションは、ターゲットプロセス内のすべての log4j の詳細度を log4j コンフィギュレーションファイルで指定されたレベルにリセットします。-resetAll とロガー名を両方とも指定した場合、指定したロガーの詳細レベルを設定する前に、リセットが実行されます。-resetAll とロガー名のどちらかを指定する必要があります。
◦ 「システム正常性監視ツール」ページの「Log Levels」リンクは、現在のサーバープロセスについて、サーバーマネージャロガー、メソッドサーバーロガー、またはサーブレットエンジンロガーのログレベルを表示または設定できるページを示しています。 > > から「Log Levels」リンクにアクセスできます。「サーバーステータス」ページで「監視ツール」をクリックします。
次のセクションでは、wt.properties ログファイルの設定およびログイベントのコンフィギュレーション設定の詳細について説明します。
> にある「システム設定コレクター」を使用して、ログファイルを収集できます。