プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド
12c (12.2.1.1.0)
E77226-02
目次へ移動
目次

前
前へ
次
次へ

診断ログ・ファイルの表示と構成

診断ログ・ファイルは、問題の発生前および発生後にトラブルシューティングするために役立ちます。

次の項で説明するように、診断ログ・ファイルを表示したり、診断ログ・ファイルおよびファイル内の情報に影響する設定を構成したりできます。

ログ情報、エラー・メッセージおよびアラートを表示するためのFusion Middleware Controlの使用

Fusion Middleware Controlログ・ビューアを使用して、Oracle Business Intelligenceコンポーネントのログ・エントリを検索して表示できます。

ログ・ファイルを検索するとログ・メッセージが見つかり、たとえば、特定の日付範囲、ユーザー、ユーザー・トランザクションまたはメッセージのレベル(エラー、警告、通知など)をターゲットとするフィルタを適用できます。Fusion Middleware Controlログ・ビューアから、ログ・ファイル全体を表示することもできます。

エラー・メッセージと警告のログ・エントリが複数のログ・ファイルにまたがって生成される場合、その追跡は困難です。しかし、複数のログ・ファイルにわたる特定のユーザー・トランザクションのログ情報を表示することが可能です。トランザクション・レベルのロギングでは、実行コンテキストID(ECID)と呼ばれる一意のトランザクションIDを、ユーザー・リクエストに応答して生成されるすべてのログおよびエラー・メッセージに関連付けています。このロギングによって、基となる問題の原因を迅速に診断できます。ただし、ログ内のメッセージによっては(たとえば、サーバーの起動や停止のシステム・メッセージ)、トランザクション属性を持ちません。クライアント・リクエストに関連するすべてのログ・メッセージは、トランザクション属性を持ちます。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

Fusion Middleware Controlを使用してログ情報、エラー・メッセージおよびアラートを表示するには:

  1. Fusion Middleware ControlのOracle Business Intelligenceページの表示の説明に従って、Business Intelligenceの「概要」ページに移動します。
  2. 「診断」ページの「ログ・メッセージ」タブを表示します。

    要素のページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。

  3. 次のリストを表示します。
    • 「最新のエラー」領域の最新のエラー

    • 最新の警告」領域の最新の警告

  4. 「ログ・メッセージの表示」の下のリンクを選択して、すべてのログ・ファイルのメッセージまたは指定されたコンポーネントのログ・ファイルのメッセージを表示します。
    • ログ・ビューアを使用するログ・ファイルの検索

    • プレゼンテーション・サービス・ログ

    • サーバー・ログ

    • スケジューラ・ログ

    • JavaHostログ

    • クラスタ・コントローラ・ログ

    • アクション・サービス・ログ

    • セキュリティ・サービス・ログ

    • 管理者サービス・ログ

    Fusion Middleware Controlでは、選択に応じた「ログ・メッセージ」ページにメッセージが表示されます。

  5. 適切な検索基準を入力して、対応するエラー・メッセージを表示します。

    メッセージをECID別に表示するには、「関連メッセージの表示」をクリックし、「ECID(実行コンテキストID)ごと」を選択します。

  6. 1つ以上の行を選択して、選択されているメッセージのログ・ファイル・エントリの詳細を表示します。

ログ・ファイルのローテーション・ポリシーの構成とログ・レベルの指定

ログ・ファイルのサイズと経過時間に基づいて、新しいログ・ファイルを作成する必要があるタイミングを決定する基準を構成できます。

ログ・ファイルに保存するメッセージのレベルを決定するログ・レベルも指定できます。

この項では、次の項目について説明します。

ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用

ログ・ファイルのローテーション・ポリシーおよびログ・レベルを構成すると、ログ・ファイルに十分なデータを保持しつつ、管理可能な状態に維持できます。

この手順を始める前に、「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。

Fusion Middleware Controlを使用して、ログ・ファイルのローテーション・ポリシーを構成し、ログ・レベルを指定するには:

  1. Fusion Middleware ControlのOracle Business Intelligenceページの表示の説明に従って、Business Intelligenceの「概要」ページに移動します。
  2. 「診断」ページの「ログ構成」タブを表示します。
  3. 「ロックと編集」をクリックして、変更を実行できるようにします。
  4. このページのヘルプ・トピックの説明を参照して、各要素を設定します。

    たとえば、使用するログ・レベルを指定したり、場合によってはその粒度を設定したりできます。

    次のオプションに関するページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。

    ログ構成

    • 最大ファイル・サイズ」オプション

    • ログの最長保存期間」オプション

    問合せログ

    • 最大ファイル・サイズ」オプション

    • ログの最長保存期間」オプション

    デフォルト・ログ・レベル

    コンポーネント固有のログ・レベル

  5. 「適用」,をクリックしてから、「変更のアクティブ化」をクリックします。
  6. Business Intelligence概要ページに戻り、「再起動」をクリックします。

追加のログ・ファイル設定の手動での変更

Fusion Middleware Controlで変更できるログ・ファイル設定に加えて、手動で変更できる設定もあります。コンポーネントのログ構成ファイル内の様々な要素を使用して、その設定を変更します。

ログ・ファイル形式を構成する設定を手動で変更するには:

  1. 次のコンポーネント・ログ構成ファイルを開きます。

    BI_DOMAIN/config/fmwconfig/biconfig/

    詳細は、「診断ログ構成ファイルの概要とその位置」を参照してください。

  2. ログ・ファイル形式を指定するFormat要素を追加する必要があるセクションを見つけます。デフォルトはODL-TEXTです。

    Fusion Middleware Controlログ・ビューアを使用してOracle Business Intelligenceのログ・ファイルを表示および検索するには、ファイルがODL-Text形式またはODL-XML形式である必要があります。

  3. 次の例に示すように、必要な要素とその祖先要素を追加します。
    <server>
       <ServerInstance>
          <Log>
             <Format>ODL-TEXT</Format>
          </Log>
       </ServerInstance>
    </server>
    

    JavaHost Serverの診断ログ構成ファイルの詳細は、「診断ログ構成ファイルの概要とその位置」を参照してください。

  4. 変更内容を保存し、ファイルを閉じます。
  5. Oracle Business Intelligenceを再起動します。

ログ・ビューアを使用した問題の診断

Fusion Middleware Controlのログ・ビューアを使用して、Oracle Business Intelligenceシステムでの問題の解決に役立つ可能性があるメッセージを探すことができます。

ログ・ビューアを使用して問題を診断するには:

  1. Fusion Middleware Controlが表示されます。

  2. ナビゲータで、「WebLogicドメイン」を選択して「bi」を右クリックし、「ログ」「ログ・メッセージの表示」の順に選択します。

    「ログ・メッセージ」ページが表示されます。ログ・ビューアがすべてのログ・ファイルから行を収集し、このページに表示します。行をフィルタして、関心のあるものを表示できます。

  3. リストのフィルタを開始するには、検索基準を入力して関心のあるメッセージを探します。

    • 特定の日付の前後にエラーが発生したことがわかっている場合は、「日付範囲」「時間間隔」に設定します。フィルタの開始および終了の日付を選択します。

    • エラーが繰り返し発生している場合は、「日付範囲」「最新」に設定します。「日」を選択して、1や3などの数字を指定します。

    • 「メッセージ・タイプ」には、次の「インシデント・エラー」、「エラー」、「警告」および「通知」を選択します。返されるメッセージの数が多すぎる場合は、「通知」を選択解除して、エラーと警告のみを表示します。

      「通知」を選択する利点は、Oracle Business Intelligenceシステムの動作内容がわかることで、異常が発生したのがいつかを特定するのに役立てることができます。

  4. Oracle Business Intelligenceのメッセージをフィルタするには、次のようにします。

    1. 「フィールドの追加」をクリックし、「モジュール」を選択して、「追加」をクリックします。

    2. 「モジュール」「次を含む」に設定されていることを確認して、次の値を入力します。

      oracle.bi.management

      この値は、Oracle Business Intelligenceのシステム管理のためのすべてのログ・エントリが由来するJavaパッケージの名前を指定します。

  5. 「検索」をクリックします。

    このページには、診断中の問題に関係するエラーおよび警告を含め、条件に合うすべてのログ・メッセージがリストされます。

  6. ログ・メッセージのコピーを保存するには、「メッセージをファイルにエクスポート」をクリックし、「Oracle診断ログ・テキスト(.txt)として」または必要に応じてその他の形式を選択します。

ログ・メッセージを表示すると、「メッセージ」列に、何の操作がいつ行われたかが表示されます。いつサーバーが再起動されたか、構成の変更が行われたかなど、重要な情報を知ることができます。「ログ・ファイル」列の値を使用すると、書込み先のファイルがわかり、Oracle Business Intelligenceの動作の手がかりとなります。たとえば、nqserver.logの値はOracle BIサーバーとの相互作用を示し、sawlog5.logの値はプレゼンテーション・サービスとの相互作用を示します。

ログ・メッセージを表示して、何が特定の状況の原因となったかを確認できます。たとえば、Fusion Middleware Controlで別のリポジトリを指定するという変更を行ったのに、プレゼンテーション・サービスではそのリポジトリを表示できないとします。ログ・メッセージを表示すると、管理対象サーバーをホストし、新規リポジトリのコピー先となるコンピュータのメモリーが不足していることを示すエラー・メッセージが見つかります。先のエラー・メッセージは、管理サーバーがリポジトリの変更をレポートし、その変更を管理対象サーバーに同期しようとしたことを示します。