Oracle E-Business Suiteメンテナンス・ガイド リリース12.2 E51768-01

目次

前へ

次へ

Oracle E-Business Suiteのロギング機能

概要

Oracle E-Business Suiteの製品には、複数のタイプのログがあります。この章では、ロギング・フレームワークに焦点を当てます。ロギング・フレームワークによって、Oracle Applications Managerでログ・メッセージを設定および表示できます。

その他のタイプのログ・ファイルについては、それぞれの製品領域のドキュメントで説明します。

ロギング・フレームワーク

Oracle E-Business Suite Logging Frameworkでは、デバッグ、エラー・レポートおよびアラート用にログ・メッセージを格納および取得できます。

ログ・メッセージを設定、表示およびパージするには、Oracle Applications ManagerにあるHTMLべースのユーザー・インタフェース・ページを使用します。

これらのメッセージは、開発者がコードに記述する必要があります。詳細は、Oracle E-Business Suite開発者ガイドを参照してください。

ロギング・フレームワークの構成

次の各項では、ロギング・フレームワークの構成について説明します。

中間層プロパティを使用したロギングの構成

すべての中間層プロパティの設定は、プロファイル・オプションの設定よりも優先されます。Javaシステム・プロパティを使用するロギングを構成すること（通常は、jserv.propertiesファイルでApache JServシステム・プロパティを設定することによる）は、現在のプロファイル・オプションの設定に関係なく、すべてのサイトまたはユーザーについてロギングをオンにする迅速な方法です。中間層プロパティは中間層コードにのみ影響し、PL/SQLレイヤー・ロギングには影響しません。

Javaの使用

各JVMのロギングを制御するために、Javaシステム・プロパティを定義できます。

次の例は、Javaシステム・プロパティを使用してすべてのモジュールおよびレベルのロギングをオンにする方法を示しています。

この例では、JVMにファイル/path/to/apps.logの書込み権限があるとします。このファイルは、JVMに書込み権限がある他の任意のファイルに変更できます。

ファイルにログを書き込む場合、AFLOG_FILENAMEを設定して、デフォルト・ファイルaferror.logを明示的に上書きすることをお薦めします。デフォルトではファイルのフル・パスが指定されていないため、中間層プロセスによって書込み可能になっていない場合があります。

コマンドラインJVMシステム・プロパティ

コマンドラインから実行されるアプリケーション（MyClassなど）に対してロギングを有効にするには、コマンドラインにパラメータ値を追加します。

/local/java/jdk1.2.2/bin/java \ 
-DAFLOG_ENABLED=TRUE -DAFLOG_LEVEL=STATEMENT \
-DAFLOG_MODULE=% -DAFLOG_FILENAME=/path/to/apps.log MyClass

Apache JServ Javaシステム・プロパティ

Apache JServ JVMシステム・プロパティを使用してロギングを有効にするには、jserv.propertiesファイル（通常は、$IAS_ORACLE_HOME/Apache/Jserv/etc/にある）に次のコードを追加します。

wrapper.bin.parameters=-DAFLOG_ENABLED=TRUE  
wrapper.bin.parameters=-DAFLOG_LEVEL=STATEMENT  
wrapper.bin.parameters=-DAFLOG_MODULE=%  
wrapper.bin.parameters=-DAFLOG_FILENAME=/path/to/apps.log 

この場合、使用しやすいログ・ファイルの場所は、Jservによって使用されるログ・ディレクトリ（$IAS_ORACLE_HOME/Apache/Jserv/logs/）です。

Cの使用

各Cプロセスのロギングを制御するために、環境変数を定義できます。

次の例は、C環境変数を使用してすべてのモジュールおよびレベルのロギングをオンにする方法を示しています。

この例では、Cプロセスにファイル/path/to/apps.logの書込み権限があるとします。このファイルは、Cプロセスに書込み権限がある他の任意のファイルに変更できます。

ファイルにログを書き込む場合、AFLOG_FILENAMEを設定して、デフォルト・ファイルaferror.logを明示的に上書きすることをお薦めします。デフォルトではファイルのフル・パスが指定されていないため、中間層プロセスによって書込み可能になっていない場合があります。

!#/bin/csh
setenv AFLOG_ENABLED Y
setenv AFLOG_LEVEL STATEMENT
setenv AFLOG_MODULE %
setenv AFLOG_FILENAME /path/to/apps.log
./C-Executable

Oracle Application Object Libraryのプロファイル・オプションを使用したロギングの構成

Oracle Application Object Library（FND）のプロファイル・オプションを設定して、ロギングを構成できます。次の表に、プロファイル・オプション名およびサンプル値を示します。

使用できるレベルは、サイト、アプリケーション、職責およびユーザーです。ユーザー設定は職責設定を上書きし、職責設定はアプリケーション設定を上書きし、アプリケーション設定はサイト設定を上書きします。

この点を強調するために、様々なプロファイル・オプション・レベルの影響の要約を次に示します。

• ユーザー: 特定のユーザーにのみ影響します。

• アプリケーション: 特定のアプリケーションのすべてのユーザーに影響します。

• 職責: その職責の任意のアプリケーションのすべてのユーザーに影響します。

• サイト: すべてのユーザー、アプリケーションおよび職責に影響します。

  注意: サイト・レベルでロギングを設定する場合、ロギング・レベルをUNEXPECTEDに設定することをお薦めします。ERRORまたはEXCEPTIONも可能です。サイトのロギング・レベルをUNEXPECTED、ERRORまたはEXCEPTION以外の値に設定することはお薦めしません。

画面へのロギングの使用

ログ・メッセージをファイルまたはデータベースに書き込む前述の方法以外に、画面へのロギングでは次のことが可能です。

• HTTP要求またはHTTPセッションごとのロギングを有効にする機能。

• サーバーの再起動またはログ・プロファイルの変更が不要な動的構成。

• パフォーマンスの問題を診断するための便利な軽量メカニズム。各メッセージにはミリ秒単位でタイムスタンプが設定されます。

画面へのロギングが有効な場合、特定のHTTP要求応答に対して生成されたJavaログ・メッセージはメモリーでバッファされ、生成されたHTMLページの最後に追加されます。

この機能は、ファイルまたはデータベース・ロギングの既存の構成に影響しません。ファイルまたはデータベース・ロギングは、構成済の中間層ログ・プロパティまたはログ・プロファイル値（あるいはその両方）に従って動作し続けます。

このメカニズムでは、現在はJavaレイヤーのメッセージのみが提供されます。他のレイヤー（PL/SQLなど）からのメッセージが必要な場合は、通常のファイルまたはデータベース・ロギングを使用する必要があります。

Oracle Application Frameworkのページでの画面へのロギングの有効化

セキュリティ上の理由から、この機能は「FND: 診断」プロファイルが「Yes」に設定されている場合にのみアクセスできます。

次の手順を使用して、Oracle Application Frameworkに基づくページで画面へのロギングを有効にします。

1. 「診断」ボタンをクリックします。

2. ドロップダウン・リストから「画面上ログの表示」を選択します。

3. 適切なログ・レベルを選択します。

4. オプションで、jtf*などのモジュール・フィルタ基準を入力します。[URLでは、パーセント記号（%）ではなくアスタリスク記号（*）をワイルドカード文字として使用します。]

CRM Technology Foundationのページでの画面へのロギングの有効化

セキュリティ上の理由から、この機能は「FND: 診断」プロファイルが「Yes」に設定されている場合にのみアクセスできます。

CRM Technology Foundationに基づくページで画面へのロギングを有効にするには、ページのURLに次のパラメータを追加します。

jtfdebug

現在の画面に表示されるロギング・レベルを指定します。

jtfdebugfilter

（オプション）必要に応じて、このパラメータをフィルタとして使用して、Javaパッケージ名に基づいてメッセージを表示できます。

例: <current_url>&jtfdebug=STATEMENT&jtfdebugfilter=jtf*

[URLでは、パーセント記号（%）ではなくアスタリスク記号（*）をワイルドカード文字として使用します。]

起動動作

起動時には、アプリケーションはプロファイル値にアクセスしません。中間層プロパティが設定されていない場合は、起動時に、システムは次のようなロギングにデフォルト設定されます。

• ログは、（現行ディレクトリの）ファイルaferror.logに格納されます。

• ログは、レベルUNEXPECTEDで格納されます。

• ログは、すべてのモジュールについて格納されます。

データベースへの接続が確立された後、サイト・レベルのログ・プロファイルが読み込まれます。ユーザー、職責およびアプリケーションが確立されると、そのユーザーのOracle Application Object Library（FND）プロファイルが読み込まれます。

JavaおよびPL/SQLアプリケーションの場合、ロギング・システムはFND_GLOBAL.INITIALIZE（APPS_INITIALIZEからコールされる）によって初期化されます。これは、通常は、すべてのJavaアプリケーション・セッション、フォーム、レポートまたはコンカレント・プログラムの起動の一部としてコールされます。その時点では、ロギング・システムにユーザー情報があり、ログは正しいユーザー・プロファイルを使用して記録されます。FND_GLOBAL.INITIALIZEの前に、ロギング・システムがコールされると、自己初期化が行われ、ログはサイト・レベルのプロファイル値を使用して記録されます。

Javaアプリケーションの場合、起動ステップの順序は次のとおりです。

1. Javaシステム・プロパティとして設定されたログ・パラメータがある場合は、それらを使用します。

2. ロギングは、Javaシステム・プロパティAFLOG_ENABLED=FALSEを使用して無効化されていません。残りのログ・パラメータでシステム・プロパティとして設定されていないものがある場合は、対応するOracle Application Object Library（FND）プロファイル・オプション値をデータベースから取得します。ユーザー・レベルのプロファイル値は職責レベルのプロファイル値を上書きし、職責レベルのプロファイル値はアプリケーション・レベルのプロファイル値を上書きし、アプリケーション・レベルのプロファイル値はサイト・レベルのプロファイル値を上書きします。

3. システム・プロパティとしてもプロファイル値としても設定されていないログ・パラメータがある（またはエラーでアクセスできない）場合は、デフォルト値を使用します。

ロギング・フレームワークのガイドライン

次のガイドラインに従って、ロギング用にシステムを設定します。ログ管理タスクのユーザー・インタフェースとしてOracle Applications Managerを使用することをお薦めします。

推奨されるデフォルトのサイト・レベル設定

通常の操作では、システムを次のように構成することをお薦めします。

• 使用可能: オン

• ロギング・レベル: UNEXPECTED

• ログ・リポジトリ: データベース

• モジュール・フィルタ: %

  注意: デフォルトのサイト・レベルのロギング・レベルをSTATEMENTまたはPROCEDUREに設定した場合、システム・パフォーマンスが低下する場合があります。この構成では、大量のログ・メッセージが生成され、システムが大幅に遅くなる場合があります。さらに、サイト・レベルのロギング・レベルを長期間低い重要度に設定すると、FND_LOG_MESSAGES表の領域が足りなくなる可能性があります。

デバッグの推奨設定

システム・エラーに関する情報を収集するためにロギング・レベルを下げる必要がある場合は、次の推奨構成を使用します。（前述のように、デフォルトのロギング・レベルはUNEXPECTEDです。これにより、最適なシステム・パフォーマンスが維持されます。）

画面へのロギングの使用

Oracle CRM Technology FoundationまたはOracle Application Frameworkに基づくJavaベースのページの場合、生成されたHTMLを表示しているブラウザにアクセスできる場合は、エラーがレポートされたときに画面へのロギング機能を使用して詳細を表示できます。「画面へのロギングの使用」を参照してください。

この軽量メカニズムは、次の場合に最適に機能します。

• Javaレイヤーのメッセージのみが対象である。

• 特定の要求応答のデバッグのみが必要である。ブラウザからのJSP要求など。

• 特定のセッションでのすべての要求応答のデバッグが必要である。

特定のユーザーへのエラーの絞込み

Oracle Application Object Libraryプロファイルを使用して、エラーが発生したときに有効であった特定のユーザー、職責およびアプリケーションのロギングを有効にできます。プロファイル変更を有効にするために、再度ログインするようユーザーに依頼します。デバッグの完了後は、忘れずにプロファイルを通常の値に戻します。

特定のコードで問題が発生していることが疑われる場合は、階層モジュール・フィルタを使用して、ログに記録されるメッセージを限定します。たとえば、fnd.common.%です。

適切な詳細レベルに応じてロギング・レベルを設定します。EVENTメッセージよって、重要な進行状況イベントがレポートされます。EXCEPTION、ERRORおよびUNEXPECTEDメッセージでは、障害がレポートされます。

大量の場合

負荷の大きい大量の場合のシナリオでは、中間層メッセージをローカル・ファイルに記録できます。これは、リモート・データベースへのロギングよりも高速です。そのためには、AFLOG_FILENAMEプロパティを定義して、すべての中間層ロギングをローカル・ファイルに書き込みます。生成されるメッセージの数を制限してください。

• Oracle Application Object Library FNDプロファイルを使用して、次の条件に従ってロギングを制限します。

  • 特定のユーザー

  • 特定の職責

  • 特定のアプリケーション

• 特定のコードで問題が発生していることが疑われる場合は、階層モジュール・フィルタを使用して、ログに記録されるメッセージを限定します。たとえば、fnd.common%です。

• 適切な詳細レベルに応じてロギング・レベルを設定します。EVENTメッセージよって、重要な進行状況イベントがレポートされます。EXCEPTION、ERRORおよびUNEXPECTEDメッセージでは、障害がレポートされます。

保守のために、ログ・ファイルを定期的にローテーションし、古いメッセージをデータベース表からパージしてください。

構成プロパティの更新

中間層プロパティを使用してロギングを構成した場合、変更が抽出されるように、影響を受けるプロセスを再起動する必要があります。

FNDログ・プロファイルを使用してロギングを構成した場合、ユーザーに再度ログインするよう依頼する必要があります（再起動は必要ありません）。

画面へのロギングを使用してロギングを構成した場合、更新は即時です。再ログインまたは再起動は必要ありません。

ロギングを完全に無効にする方法

ロギングを完全に無効にする手順は、次のとおりです。

• ロギングが中間層プロパティを使用して構成されている場合は、該当するすべての中間層構成ファイル（jserv.propertiesなど）または起動スクリプト（あるいはその両方）で、AFLOG_ENABLED中間層プロパティをFALSEに設定します。

• ロギングがデータベースでOracle Application Object Libraryプロファイルを使用して構成されている場合は、Oracle Applications Managerのロギング設定画面を使用して、すべてのアプリケーション、職責およびユーザーのロギングをオフにします。詳細は、Oracle Applications Managerオンライン・ヘルプを参照してください。

変更した値がいつどのように有効になるかの詳細は、前述の「構成プロパティの更新」の項を参照してください。

ログ・メッセージのパージ

古いログ・メッセージは、データベース表の領域制限の原因となるため、定期的に削除してください。また、ログ・ファイルを定期的にローテーションしてください。

ログ・メッセージのパージには、いくつかの方法があります。次に、それらについて説明します。

コンカレント・プログラムの使用

コンカレント・プログラム「デバッグ・ログおよびシステム・アラートのパージ」（短縮名: FNDLGPRG）は、メッセージのパージに推奨される方法です。このプログラムでは、有効なトランザクション（新規アラートまたはオープン・アラート、有効なICXセッション、コンカレント要求など）のメッセージを除き、指定した日付までのすべてのメッセージがパージされます。このプログラムは、デフォルトでは日次で実行されるようにスケジュールされており、7日よりも古いメッセージがパージされます。内部的には、このコンカレント・プログラムによってFND_LOG_ADMIN APIが起動されます。これらのAPIについては、このドキュメントで後で説明します。

Oracle Applications Managerの使用

「Applications Dashboard」の「Navigate to」ドロップダウン・リストから、「System Alerts and Metrics」にナビゲートします。次に、「Logs」をクリックします。

Oracle CRMのシステム管理者コンソールの使用

「設定」>「システム」>「デバッグ・ロギング」にナビゲートします。

PL/SQLの使用

FND_LOG_ADMIN PL/SQLパッケージを使用して、ログ・メッセージを削除できます。

次に例を示します。

SET SERVEROUTPUT ON
declare
    del_rows NUMBER;
BEGIN
del_rows := fnd_log_admin.delete_all;
DBMS_OUTPUT.PUT_LINE(del_rows || ' rows deleted');
END;

ログ・メッセージの表示

この項では、ログ・メッセージの表示および操作に使用できる様々なユーザー・インタフェースと、各UIからログ・メッセージにアクセスする方法について説明します。

CRMのシステム管理者コンソール

「設定」>「システム」>「デバッグ・ロギング」にナビゲートします。

Oracle Application Frameworkのページ

Oracle Application Frameworkのページで作業する場合は、次の手順を使用してログ・メッセージを表示できます。

1. Oracle Application Frameworkに基づくページには、「診断」というラベルの付いたグローバル・ボタンがあります。このボタンをクリックして、「ログの表示」を選択できるウィンドウを開きます。（この「診断」グローバル・ボタンは、診断テストの管理および実行が可能なOracle Applications ManagerのDiagnostics機能のことではありません。）

2. 「ログの表示」を選択して、Oracle Applications Managerの「Logs」ページを開きます。「Logs」ページは、System Alerts and Metrics機能の一部です。

   注意: 「診断」グローバル・ボタンが表示されるには、プロファイル・オプションFND_DIAGNOSTICSがYESに設定されている必要があります。

Oracle Applications Manager

Oracle Applications ManagerのLoggingの機能には、次の方法でアクセスできます。

• Oracle Application Frameworkの「診断」グローバル・ボタンから、「ログの表示」を選択します。

• システム管理職責を使用して、「Oracle Applications Manager」>「Logs」にナビゲートします。

• Oracle Applications Managerの「Site Map」から、「Monitoring」>「Logs」（「Current Activity」の下）にナビゲートします。

• フォーム・ベース・アプリケーションで、「ヘルプ」（メニュー）>「診断」>「ロギング」にナビゲートします。

OAMでは次のことを実行できます。

• 様々な基準を使用した検索（コンカレント・プログラム要求ID、セッションID、ユーザーIDなど）

• 関連するログのドリルダウン表示

• ログ添付の表示

• ログおよび添付のサポート・カートへの追加

• 相互依存値リストを使用した有効な値の選択

• CSV形式でのログのエクスポート/ダウンロード

• ログの削除

• ロギング・プロファイルに基づくログの構成

• ログの要約の表示

• OAM「Concurrent Processing Request」ページから要求ログへのドリルダウン

OAMのLogging機能へのアクセスは、Oracle Application Object Library機能セキュリティを使用して制御されます。シード済職責であるシステム管理およびシステム管理者には、ロギング機能が割り当てられています。その他の職責の場合は、次の方法を使用します。

• フル・アクセス（検索/構成/削除）: OAM_BF_SYSLOG_ALL_MENU（Log Search: All Functions）（メニュー）

  このメニューには、次の項目があります。

  • 検索: OAM_BF_SYSLOG_READ_ONLY_MENU（Log Search: Read Only）（メニュー）

  • 削除: OAM_BF_SYSLOG_DELETE（Log Delete）（機能）

  • 構成: OAM_BF_SYSLOG_CONFIG（Log Setup）機能

Oracle Forms

「ヘルプ」>「診断」>「ロギング」にナビゲートします。

応用技術製品のログ・ファイル

次の表に、応用技術製品で使用されるログ・ファイルをいくつか示します。これらのログ・ファイルでは、前述のロギング・フレームワークは必ずしも使用されていません。

Copyright © 1994, 2013, Oracle and/or its affiliates. All rights reserved.