Oracle® Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド 12c (12.2.1) E70044-01 |
|
前 |
次 |
この章では、Fusion Middleware Controlやログ・ファイルなどのツールを使用してOracle Business Intelligenceの問題を診断および解決する方法について説明します。
この章では、次の項目について説明します。
Oracle Business Intelligenceには、表6-1に示されているとおり、問題の原因と解決策を見つけるのに役立つ様々な診断ツールが用意されています。
表6-1 診断ツール
ツール | 説明 | 参照先 |
---|---|---|
診断バンドル |
Oracleサポート・リクエストに添付するログおよび構成情報を収集できます |
|
Fusion Middleware Controlの「概要」ページ |
システムに関する最近の問題を表示できます。 |
第8.2.2項「Fusion Middleware ControlのOracle Business Intelligenceページの表示」 |
パフォーマンス・メトリック |
パフォーマンスに影響を及ぼすメトリックを表示できます。 |
|
Fusion Middleware Controlの「診断」ページ |
問題を深く調べてログ・ファイルを表示および構成できます。 |
第6.3.1項「ログ情報、エラー・メッセージおよびアラートを表示するためのFusion Middleware Controlの使用」 第6.3.2.1項「ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用」 |
使用状況トラッキング |
データベースの最適化、集計の戦略、ユーザーや部門が利用したリソースに基づく課金など、様々な方法で利用できる使用状況トラッキングの統計情報を生成できます。 |
|
カタログ・オブジェクトのレポート |
Oracle BIプレゼンテーション・カタログのオブジェクトの詳細を知ることができます。 |
第16.9項「カタログ・マネージャを使用したカタログ・データを表示するためのレポートの作成」 |
整合性チェック・マネージャ |
リポジトリの有効性をチェックできます。 |
『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のリポジトリまたはビジネス・モデルの整合性のチェックに関する項 |
モデル・チェック・マネージャ |
Oracle BI Summary Advisorおよび集計の永続性エンジンに影響を及ぼす可能性のある問題のモデルについてチェックできます。 |
『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のモデル・チェック・マネージャを使用した問題のモデルについてのチェックに関する項 |
ODBC/JDBCプロシージャ |
Oracle BIサーバーに関する診断情報を取得できます。 |
第6.7項「ODBC/JDBCプロシージャを使用したOracle BIサーバーの診断の取得」 |
この項では、問題を解決するためにOracleサポートが必要とする診断バンドルを収集する方法について説明します。
Oracle開発またはサポートがバグまたはサポート・リクエスト(SR)送信を受け入れる前に、構成後診断バンドルを収集する必要があります。
前提:
製品のFAQを確認する必要があります。
BIインストールおよび構成に成功しました。特にBI構成アシスタントがエラーなしで完了しました。これに該当しない場合、Oracleサポートに問い合せる前に診断を収集する方法の詳細は、次を参照してください。BI構成アシスタントに失敗した場合、『Oracle Fusion Middleware Oracle Business Intelligenceインストレーション・ガイド』の新しいサーバー構成を参照してください。
セキュリティ機密情報は収集されません。
前提条件:
· ファイル・システム権限を持つ必要があります
診断バンドルを収集するには:
次のコマンドを実行して、診断バンドルを収集します。
DOMAINHOME/bitools/bin/diagnostic_dump.sh <zip file name>
リクエストされたときにサポートまたは開発組織にzipファイルを提供します。
次の項で説明するように、診断ログ・ファイルを表示したり、診断ログ・ファイルおよびファイル内の情報に影響する設定を構成したりできます。
Fusion Middleware Controlログ・ビューアを使用して、Oracle Business Intelligenceコンポーネントのログ・エントリを検索して表示できます。ログ・ファイルを検索するとログ・メッセージが見つかり、たとえば、特定の日付範囲、ユーザー、ユーザー・トランザクションまたはメッセージのレベル(エラー、警告、通知など)をターゲットとするフィルタを適用できます。Fusion Middleware Controlログ・ビューアから、ログ・ファイル全体を表示することもできます。
エラー・メッセージと警告のログ・エントリが複数のログ・ファイルにまたがって生成される場合、その追跡は困難です。しかし、複数のログ・ファイルにわたる特定のユーザー・トランザクションのログ情報を表示することが可能です。トランザクション・レベルのロギングでは、実行コンテキストID(ECID)と呼ばれる一意のトランザクションIDを、ユーザー・リクエストに応答して生成されるすべてのログおよびエラー・メッセージに関連付けています。このロギングによって、基となる問題の原因を迅速に診断できます。ただし、ログ内のメッセージによっては(たとえば、サーバーの起動や停止のシステム・メッセージ)、トランザクション属性を持ちません。クライアント・リクエストに関連するすべてのログ・メッセージは、トランザクション属性を持ちます。
この手順を始める前に、第8.3.1項「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。
Fusion Middleware Controlを使用してログ情報、エラー・メッセージおよびアラートを表示するには:
第8.2.2項「Fusion Middleware ControlのOracle Business Intelligenceページの表示」の説明に従って、Business Intelligenceの「概要」ページに移動します。
「診断」ページの「ログ・メッセージ」タブを表示します。
要素のページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。
次のリストを表示します。
「最新のエラー」領域の最新のエラー
「最新の警告」領域の最新の警告
すべてのログ・ファイルの表示/検索およびコンポーネント別のログ・ファイルの表示/検索の下のリンクを選択して、すべてのログ・ファイルのメッセージまたは指定されたコンポーネントのログ・ファイルのメッセージを表示します。次のリンクのページレベル・ヘルプにアクセスするには、ページの「ヘルプ」ボタンをクリックします。
ログ・ビューアを使用するログ・ファイルの検索
プレゼンテーション・サービス・ログ
サーバー・ログ
スケジューラ・ログ
JavaHostログ
クラスタ・コントローラ・ログ
アクション・サービス・ログ
セキュリティ・サービス・ログ
管理者サービス・ログ
Fusion Middleware Controlでは、選択に応じた「ログ・メッセージ」ページにメッセージが表示されます。
適切な検索基準を入力して、対応するエラー・メッセージを表示します。
メッセージをECID別に表示するには、「関連メッセージの表示」をクリックし、「ECID(実行コンテキストID)ごと」を選択します。
1つ以上の行を選択して、選択されているメッセージのログ・ファイル・エントリの詳細を表示します。
ログ・ビューアに表示される要素の詳細は、Fusion Middlewareのヘルプを参照してください。
ログ・ファイルのサイズと経過時間に基づいて、新しいログ・ファイルを作成する必要があるタイミングを決定する基準を構成できます。ログ・ファイルに保存するメッセージのレベルを決定するログ・レベルも指定できます。
この項には次のトピックが含まれます:
この手順を始める前に、第8.3.1項「Fusion Middleware Controlの使用」で説明している情報について確認しておいてください。
Fusion Middleware Controlを使用して、ログ・ファイルのローテーション・ポリシーを構成し、ログ・レベルを指定するには:
第8.2.2項「Fusion Middleware ControlのOracle Business Intelligenceページの表示」の説明に従って、Business Intelligenceの「概要」ページに移動します。
「診断」ページの「ログ構成」タブを表示します。
「ロックと編集」をクリックして、変更を実行できるようにします。
このページのヘルプ・トピックの説明を参照して、各要素を設定します。
たとえば、使用するログ・レベルを指定したり、場合によってはその粒度を設定したりできます。
次のオプションに関するページ・レベルのヘルプにアクセスするには、「このページのヘルプ」メニュー・オプションをクリックします。
ログ構成
「最大ファイル・サイズ」オプション
「ログの最長保存期間」オプション
問合せログ
「最大ファイル・サイズ」オプション
「ログの最長保存期間」オプション
デフォルト・ログ・レベル
コンポーネント固有のログ・レベル
「適用」をクリックしてから、「変更のアクティブ化」をクリックします。
Business Intelligenceの「概要」ページに戻り、「再起動」をクリックします。
Fusion Middleware Controlで変更できるログ・ファイル設定に加えて、手動で変更できる設定もあります。コンポーネントのログ構成ファイル内の様々な要素を使用して、その設定を変更します。
ログ・ファイル形式を構成する設定を手動で変更するには:
次のコンポーネント・ログ構成ファイルを開きます。
BI_DOMAIN/config/fmwconfig/biconfig/
詳細は、第6.4.2項「診断ログ構成ファイルの概要とその位置」を参照してください
ログ・ファイル形式を指定するFormat要素を追加する必要があるセクションを見つけます。デフォルトはODL-TEXTです。
Fusion Middleware Controlログ・ビューアを使用してOracle Business Intelligenceのログ・ファイルを表示および検索するには、ファイルがODL-Text形式またはODL-XML形式である必要があります。
次の例に示すように、必要な要素とその祖先要素を追加します。
<server> <ServerInstance> <Log> <Format>ODL-TEXT</Format> </Log> </ServerInstance> </server>
JavaHostサーバー診断ログ構成ファイルの例は、例6-2を参照してください。
変更内容を保存し、ファイルを閉じます。
Oracle Business Intelligenceを再起動します。
Fusion Middleware Controlのログ・ビューアを使用して、Oracle Business Intelligenceシステムでの問題の解決に役立つ可能性があるメッセージを探すことができます。
ログ・ビューアを使用して問題を診断するには:
Fusion Middleware Controlが表示されます。
ナビゲータで、「WebLogicドメイン」を選択して「bi」を右クリックし、「ログ」、「ログ・メッセージの表示」の順に選択します。
「ログ・メッセージ」ページが表示されます。ログ・ビューアがすべてのログ・ファイルから行を収集し、このページに表示します。行をフィルタして、関心のあるものを表示できます。
リストのフィルタを開始するには、検索基準を入力して関心のあるメッセージを探します。
特定の日付の前後にエラーが発生したことがわかっている場合は、「日付範囲」を「時間間隔」に設定します。フィルタの開始および終了の日付を選択します。
エラーが繰り返し発生している場合は、「日付範囲」を「最新」に設定します。「日」を選択して、1や3などの数字を指定します。
「メッセージ・タイプ」には、次の「インシデント・エラー」、「エラー」、「警告」および「通知」を選択します。返されるメッセージの数が多すぎる場合は、「通知」を選択解除して、エラーと警告のみを表示します。
「通知」を選択する利点は、Oracle Business Intelligenceシステムの動作内容がわかることで、異常が発生したのがいつかを特定するのに役立てることができます。
Oracle Business Intelligenceのメッセージをフィルタするには、次のようにします。
「フィールドの追加」をクリックし、「モジュール」を選択して、「追加」をクリックします。
「モジュール」が「次を含む」に設定されていることを確認して、次の値を入力します。
oracle.bi.management
この値は、Oracle Business Intelligenceのシステム管理のためのすべてのログ・エントリが由来するJavaパッケージの名前を指定します。
「検索」をクリックします。
このページには、診断中の問題に関係するエラーおよび警告を含め、条件に合うすべてのログ・メッセージがリストされます。
ログ・メッセージのコピーを保存するには、「メッセージをファイルにエクスポート」をクリックし、「Oracle診断ログ・テキスト(.txt)として」または必要に応じてその他の形式を選択します。
ログ・メッセージを表示すると、「メッセージ」列に、何の操作がいつ行われたかが表示されます。いつサーバーが再起動されたか、構成の変更が行われたかなど、重要な情報を知ることができます。「ログ・ファイル」列の値を使用すると、書込み先のファイルがわかり、Oracle Business Intelligenceの動作の手がかりとなります。たとえば、nqserver.logの値はOracle BIサーバーとの相互作用を示し、sawlog5.logの値はプレゼンテーション・サービスとの相互作用を示します。
ログ・メッセージを表示して、何が特定の状況の原因となったかを確認できます。たとえば、Fusion Middleware Controlで別のリポジトリを指定するという変更を行ったのに、プレゼンテーション・サービスではそのリポジトリを表示できないとします。ログ・メッセージを表示すると、管理対象サーバーをホストし、新規リポジトリのコピー先となるコンピュータのメモリーが不足していることを示すエラー・メッセージが見つかります。先のエラー・メッセージは、管理サーバーがリポジトリの変更をレポートし、その変更を管理対象サーバーに同期しようとしたことを示します。
この項では、診断ログ・ファイルと診断ログ構成ファイルについて説明します。内容は次のとおりです。
診断ログ・ファイルは、Oracle Business Intelligence Serverによって生成されるメッセージ情報を格納するためのファイルです。これらのログ・ファイルは、次の場所に保存されています。
BI_DOMAIN/servers/INSTANCE_KEY/logs(システム・コンポーネント用)
BI_DOMAIN/servers/WLS_SERVER_NAME/logs(JEEコンポーネント用)。
例:
oraclehome/user_projects/domains/bi/servers/obis1/logs(BIサーバー用)
oraclehome/user_projects/domains/bi/servers/AdminServer/logs(JEE管理サーバー用)
Oracle Business Intelligenceでは、次の診断ログ・ファイルが使用されます。
プレゼンテーション・サービス
\CatalogCrawler\sawcatalogcrawlerlogsysn.log - カタログ・クローラのログ・ファイル。Fusion Middleware Controlログ・ビューアで検索できません。
sawlogn.log - 診断ログ出力の最新部分に相当し、Fusion Middleware Controlログ・ビューアで検索できる、プレゼンテーション・サービスのログ・ファイル。
プレゼンテーション・サービスのロギングの詳細は、第6.6項「Oracle BIプレゼンテーション・サービスのロギング」を参照してください。
Oracle BIサーバー
obis<n>_query.log - Oracle BIサーバー問合せログ。Fusion Middleware Controlログ・ビューアで検索できません。
たとえば、<n> = -1、-2などです。
注意: 日付およびタイムスタンプはログ・ファイルにあります。
nqserver<n>.log - Oracle BIサーバー・メイン診断ログ。Fusion Middleware Controlログ・ビューアで検索できます。
たとえば、<n> = 1、2などです
注意: 日付およびタイムスタンプはログ・ファイルにあります。
nqsadmintool.log - Oracle BI管理ツールのログ。
Oracle BIサーバー・ユーティリティ - たとえば、biserverxmlexecやequalizerpdsも、実行時に独自のログを生成します。
JavaHost
jh.log - JavaHost Serverのメイン診断ログ。Fusion Middleware Controlログ・ビューアで検索できます。
注意: 日付およびタイムスタンプはログ・ファイルにあります。
Oracle BIスケジューラ
nqscheduler.log - Oracle BIスケジューラのログ・ファイル。Fusion Middleware Controlログ・ビューアで検索できます。
注意: 日付およびタイムスタンプはログ・ファイルにあります。
クラスタ・コントローラ
nqcluster.log - Oracle BIクラスタ・コントローラの診断ファイル。Fusion Middleware Controlログ・ビューアで検索できます。
注意: 日付およびタイムスタンプはログ・ファイルにあります。
BI JEEログ(アクション・サービスおよびセキュリティ・サービス)。次のログ・ファイルは両方とも、Fusion Middleware Controlログ・ビューアで検索できます。
AdminServer-diagnostic.log
bi_server1-diagnostic.log
注意: ログ・ファイルnqcluster.log、nqscheduler.logおよびnqserver<n>.logについては、ファイルにログ記録されるメッセージにタイムゾーンを設定できません。メッセージは、グリニッジ標準時(GMT)でファイルにログ記録されます。Fusion Middleware Controlログ・ビューアでメッセージを表示する際は、ローカルのタイムゾーンでメッセージが表示されます。 |
診断ログ構成ファイルは、Oracle Business Intelligenceの診断ログ・ファイルへの出力を制御します。
注意: 変更が後で上書きされる可能性があるため、1つのコンポーネントの診断ログ構成ファイルを編集することはしないでください。 |
Oracle Business Intelligenceのログ構成ファイルは、次の場所に保存されています。
BI_DOMAIN/config/fmwconfig/biconfig/BI_COMPONENT_NAME
例:
oraclehome/user_projects/domains/bi/config/fmwconfig/biconfig
./OBICCS/ccslogconfig.xml
./OBIJH/logging_config.xml
./OBIPS/instanceconfig.xml
./OBSCH/schedulerconfig.xml
./OBIS/logconfig.xml
診断ログ構成ファイルの形式について
診断ログ構成ファイルは、見かけは多少異なる場合がありますが、ODL(Oracle Diagnostic Log)標準に準拠します。
例6-1と例6-2は、Oracle Business Intelligenceの2つのログ構成ファイルを示しています。
例6-1 BIサーバー診断ログ構成ファイルの形式
<server> <ServerInstance> <Log> <MaximumFileSizeKb>10000</MaximumFileSizeKb> <MaximumLogAgeDay>60</MaximumLogAgeDay> <Format>ODL-TEXT</Format> <Level> <IncidentError>1</IncidentError> <Error>1</Error> <Warning>16</Warning> <Notification>1</Notification> <Trace>16</Trace> </Level> </Log> <UserLog> <MaximumFileSizeKb>10000</MaximumFileSizeKb> <MaximumLogAgeDay>10</MaximumLogAgeDay> <Format>ODL-TEXT</Format> </UserLog> </ServerInstance> </server>
例6-2 JavaHost Server診断ログ構成ファイルの形式
<?xml version = '1.0' encoding = 'utf-8'?> <logging_configuration> <log_handlers> <log_handler name='odl-handler' class='oracle.core.ojdl.logging.ODLHandlerFactory'> <property name='path' value='C:\oracle_bi_ee_BIFNDNPTPSNT0911060426S-Release\jhlogs\javahost.log'/> <property name='maxFileSize' value='1000000'/> <property name='maxLogSize' value='5000000'/> </log_handler> </log_handlers> <loggers> <logger name='saw' level='NOTIFICATION:1' useParentHandlers='false'> <handler name='odl-handler'/> </logger> </loggers> </logging_configuration>
Oracle Business Intelligenceコンポーネントは、ログ構成ファイル内のサーバー固有の設定を使用して、診断ログ・ファイルを制御します。例:
Oracle BIプレゼンテーション・サービス・ログ構成ファイル
- writerClassId
設定によって、sawlog.logファイルに書き込まれるメッセージが構成されます。
Oracle BIサーバー・ログ構成ファイル
- Log
設定によって、nqserver.logファイルに書き込まれるメッセージが構成されます。
詳細は、第6.4.5項「システム・ログ内のメッセージ」を参照してください。
- UserLog
設定によって、nqquery.logファイルに書き込まれるメッセージが構成されます。
詳細は、第6.5項「問合せログの管理」を参照してください。
Oracle BIスケジューラ・ログ構成ファイル
- Log
設定によって、nqscheduler.logファイルに書き込まれるメッセージが構成されます。
JavaHost Serverログ構成ファイル
- log_handlers
要素とサブ要素では、ログ・ファイルのローテーション・ポリシーを構成してログ・ファイル名とその位置を指定できます。
- loggers
要素とサブ要素では、JavaHost Serverログ・レベルを標準のODL(Oracle Diagnostic Log)ログ・レベルにマップすることによって、Javaコンポーネント(JavaHost Server)のログ・レベルを適切に処理できます。
ログ・ファイル・メッセージのカテゴリとレベルによって、ログ・ファイルに書き込まれるメッセージの詳細度と重要度のレベルが決まります。Fusion Middleware Controlを使用すると、logconfig.xmlファイル内のこれらの設定を制御できます。
Oracle Business Intelligenceのログ・ファイル内の各メッセージ・カテゴリは、1 - 32の間の固有のデフォルト値に設定されており、ログ・レベル以下のレベルのメッセージのみが記録されます。
表6-2は、ログ・ファイル・メッセージのカテゴリを示しています。
表6-2 ログ・ファイル・メッセージのカテゴリ・レベル
カテゴリ:レベル | 説明 |
---|---|
IncidentError:1 |
原因不明の重大な問題が発生しました。問題を解決するには、Oracleサポート・サービスに問い合せてください。 パフォーマンスには影響ありません。 |
Error:1 |
システム管理者による対応が必要な問題が発生しました。 パフォーマンスには影響ありません。 |
Warning:1 |
エラーの発生を回避するための確認を必要とし、場合によっては対応が必要となる処理が実行されたか、状況が検出されました。 パフォーマンスには影響ありません。 |
Notification:1 |
通常のアクションまたはイベントのレポートが発生しました。ログイン完了などのユーザー操作や、ログ・ファイルのローテーションなどの自動操作です。 パフォーマンスには影響ありません。 |
Notification:16 |
構成関連のメッセージが生成されたか、問題が発生しました。 パフォーマンスへの影響はわずかです。本番環境でこのレベルを広範囲にわたって有効にしても、ソフトウェアのパフォーマンスに大きな影響はありません。 |
Trace:1 |
デバッグやパフォーマンス監視に使用されるトレースまたはデバッグ・メッセージが書き込まれました。通常、このメッセージには詳細なイベント・データが含まれており、内部の実装の詳細がわからなくても理解できます。 パフォーマンスに少し影響します。このレベルは、ソフトウェアに関する問題をデバッグするために、本番環境で広範囲にわたって有効にすることもできます。このレベルのロギングを有効にすると、パフォーマンスに少し影響する場合がありますが、ソフトウェアが使用できなくなるほどではありません。 |
Trace:16 |
かなり詳細なトレースまたはデバッグ・メッセージが書き込まれました。メッセージは明確に記述されており、製品に関する豊富な知識を持つOracleサポート・サービスの技術者であれば、内部の実装の詳細を完全に把握していなくても理解できます。 パフォーマンスに大きく影響します。このレベルは、ソフトウェアの問題をデバッグする特別な状況を除いて、本番環境では有効にしないでください。 |
Trace:32 |
非常に詳細なトレースまたはデバッグ・メッセージが書き込まれました。このソフトウェアを使用し、メッセージを生成するサブシステムの実装の詳細を十分に把握しているOracle開発者を対象としています。 パフォーマンスに非常に大きな影響があります。このレベルは本番環境では有効にしないでください。開発者がテスト環境または開発環境でこのソフトウェアをデバッグするときのみ使用してください。 |
次のログ構成ファイルの例の場合、Notificationメッセージ・カテゴリではレベル1のメッセージのみが記録されます。ログ・レベルが0に設定されている場合、そのメッセージ・カテゴリでは何も記録されません。
<Level> <IncidentError>1</IncidentError> <Error>1</Error> <Warning>1</Warning> <Notification>1</Notification> <Trace>1</Trace> </Level>
ログ・ファイル内のデフォルト設定を手動で変更することは避けてください。変更する場合は、Fusion Middleware Controlを使用します。詳細は、第6.3.2.1項「ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用」を参照してください。
ログ・ファイル・ローテーションとは、ログ・ファイルが指定されたしきい値や日付を超えたときに新しいログ・ファイルが作成されることを言います。例として、Oracle BIスケジューラのコンポーネント・ログ構成ファイルのMaximumFileSizeKb設定を考えてみましょう。この設定で指定されるサイズをログ・ファイルが超えると、既存のスケジューラ・ログ・ファイルの名前が変更され、新しいログ・ファイルが作成されます。また、MaximumLogAgeDayの設定より古いログ・ファイル日付も削除されます。
Oracle BIコンポーネントはそれぞれ異なるログ・ファイル名を持ち、ログ構成ファイルの設定が異なります。たとえば、スケジューラのファイル・ネーミング規則は次のとおりです。
nqscheduler.log - 最新のログ・ファイル。
nqscheduler-<n>.log - 名前が変更された、以前のログ・ファイル。
<n> = 日付とタイムスタンプ(例: nqscheduler-20100909-2135.log)
詳細は、第6.3.2.1項「ログ・ファイルのローテーション・ポリシーを構成しログ・レベルを指定するためのFusion Middleware Controlの使用」を参照してください。
Oracle BIサーバーでは、構成設定に基づいてnqserver.logファイルにメッセージが書き込まれます。このログ・ファイルへのメッセージの書込みに加えて、UNIXシステムのシステム・ログ・ファイルに、特定の重大なメッセージも書き込まれます。システム・ログ・ファイルに書き込まれるメッセージの種類は、次のとおりです。
BIサーバーが起動できない場合(たとえば、別のサーバーがすでに起動しているため)、システム・ログ・ファイルには次のようなメッセージが書き込まれます。
@1%lsおよびポート@2%ls上で別のサーバーがすでに実行されています。
メモリーの問題が発生した場合、システム・ログ・ファイルには次のようなメッセージが書き込まれます。
低断片化ヒープを有効にできませんでした。
コンピュータのハード・ディスクがいっぱいの場合、システム・ログ・ファイルには次のようなメッセージが書き込まれます。
ディスクの空き容量不足です。
Oracle BIサーバーには、問合せアクティビティを個々のユーザー・レベルでロギングする機能があります。ロギングは、品質保証テスト、デバッグおよびOracleサポート・サービスによるトラブルシューティングで使用します。本番モードでは、通常、問合せロギングは無効にされています。
問合せログ・ファイルの名前はnqquery.logで、次の場所にあります。
BI_DOMAIN/servers/obisn/logs
Oracle BIサーバーの問合せロギングはユーザー・レベルで追跡されます。ユーザー・コミュニティ全体を追跡すると、リソースが集中的に使用されます。
注意: 本番システムでは、ターゲットを絞ったユーザー・コミュニティのみを対象に問合せロギングを有効にすることをお薦めします。本番システムでは、使用状況トラッキングを本番レベルのロギング機能として使用できます。詳細は、第7章「使用状況トラッキングの管理」を参照してください。 |
ユーザー名が明らかにテスト・ユーザーを示しており、問合せロギングが有効であることが確認されている場合のみ、ユーザーをテストしてください。このようなユーザーのロギングが有効な場合、ユーザーにはsales_admin_with_logging、sales_dev_with_logging、sales_test_with_loggingなどの名前を付けることが推奨されているため、ユーザーを簡単に識別できます。なお、本番の管理者ログインは、使用可能なリソースに負担がかかるため、問合せロギングを有効にしないでください。
次のものについても、問合せロギングを無効にします。
初期化文字列内のSQL文。「初期化文字列」フィールドは、「一般」タブの「初期化ブロック」ダイアログにあります。
LOGGING列は、ログ・レベルで格納されている値を参照します。
各本番ユーザーのロギング・レベルは0(ゼロ)に設定します。「ロギング・レベル」フィールドは、「ユーザー」タブの「ユーザー」ダイアログにあります。管理ツールで、メイン・ツールバーの「管理」オプションから「アイデンティティ」を選択します。「Identity Manager」ダイアログで、ユーザーをダブルクリックし、「ユーザー」タブを選択します。
この項には次のトピックが含まれます:
この項では、問合せログのサイズの設定、ロギング・レベルの選択およびユーザーの問合せログの有効化について説明します。
問合せロギングによって非常に大きなログ・ファイルが作成されるため、デフォルトでは、ロギング・システムは無効化されています。ロギングを有効にすることで、リポジトリが正しく構成されているかどうかのテスト、システム上でのアクティビティの監視、パフォーマンスの問題の解決またはOracleサポート・サービスの支援が可能となります。ロギングが必要なユーザーごとに、システム上の問合せロギングを有効にする必要があります。そのためには、Oracle BI管理ツールを使用します。
第6.5.1.2項「ユーザーの問合せロギング・レベルの設定」の説明に従って、個々のユーザーの問合せロギング・レベルを有効にできます。グループのロギング・レベルは構成できません。
特定のユーザーのロギング・レベルは、セッション変数によって上書きされます。たとえば、管理者のロギング・レベルが4で、セッション変数のロギング・レベルがリポジトリ内でデフォルト0(ゼロ)と定義される場合、管理者のロギング・レベルは0になります。
ロギング・レベルは、組織に適したロギングの量に基づいて設定します。一般の操作の場合、通常、ロギングは無効です(ロギング・レベルは0に設定されています)。ロギングを有効にする場合は、1または2のロギング・レベルを選択します。この2つのレベルは、管理者による使用を目的としています。
問合せの一時的なログ・レベルを設定することで、パフォーマンスやデータの問題を診断できます。Oracle BIプレゼンテーション・サービスの「詳細設定」タブで、「高度なSQL句」セクションに接頭辞句を追加することで、SELECT文の問合せロギングを有効にできます。SELECT文の例を次に示します。
SELECT year, product, sum(revenue) FROM time, products, facts;
「接頭辞」フィールドで、次のようにロギング・レベル5を指定できます。
Set Variable LOGLEVEL=5;
この問合せでは、基礎となるLOGLEVEL
変数の値にかかわらず、ロギング・レベル5が使用されます。
注意: 3以上のロギング・レベルは、Oracleサポート・サービスの支援を受ける場合のみ使用してください。 |
表6-3は、問合せロギング・レベルを示しています。
表6-3 問合せロギング・レベル
ロギング・レベル | 記録される情報 |
---|---|
レベル0 |
ロギングは行われません。 |
レベル1 |
クライアント・アプリケーションから発行されたSQL文が記録されます。次のものも記録されます。
|
レベル2 |
レベル1で記録されるすべてのものが記録されます。 加えて、各問合せについて、リポジトリ名、ビジネス・モデル名、サブジェクト・エリア名、物理データベースに対して発行されたSQL文、キャッシュに対して発行された問合せ、物理データベースに対する問合せとキャッシュに対して発行された問合せからそれぞれ返された行数、およびクライアント・アプリケーションに返される行数が記録されます。 |
レベル3 |
レベル2で記録されるすべてのものが記録されます。 加えて、キャッシュをシードする予定だった問合せがキャッシュに挿入されなかった場合、既存のキャッシュ・エントリを消去して現在の問合せ用の領域を作成する場合、および完全一致のヒット・ディテクタを更新できなかった場合、論理問合せ計画のログ・エントリが追加されます。 Oracleサポート・サービスの支援がない場合は、このレベルを選択しないでください。 |
レベル4 |
レベル3で記録されるすべてのものが記録されます。 加えて、問合せ実行計画が記録されます。Oracleサポート・サービスの支援がない場合は、このレベルを選択しないでください。 |
レベル5 |
レベル4で記録されるすべてのものが記録されます。 加えて、実行計画内の様々な時点における中間の行数が記録されます。Oracleサポート・サービスの支援がない場合は、このレベルを選択しないでください。 |
レベル6および7 |
使用されません。 |
ユーザーの問合せロギング・レベルを設定するには:
Oracle BI管理ツールで、「管理」→「アイデンティティ」を選択します。
「Identity Manager」ダイアログが表示されます。
問合せロギング・レベルを設定するユーザーの名前をダブルクリックします。
「ユーザー」ダイアログが表示されます。
「ロギング・レベル」フィールドの横の「↑」または「↓」の矢印をクリックして、ロギング・レベルを設定します。
ユーザーの問合せロギングを無効にするには、ロギング・レベルを0に設定します。
「OK」をクリックします。
問合せログを表示するには、Oracle Business Intelligenceのログ・ビューア・ユーティリティ(またはテキスト・エディタ)を使用します。問合せログ内の各エントリには、問合せを発行したユーザーの名前、問合せが開始されたセッションのセッションIDおよび個々の問合せのリクエストIDのタグが付けられています。
ログ・ビューア・ユーティリティ(UNIXのORACLE_HOME/bi/bifoundation/server/bin)を実行するには、コマンド・プロンプトを開き、nqlogviewer
と引数の組合せを入力します。構文は次のとおりです。
nqlogviewer [-u user_name] [-f log_input_filename] [-o output_result_filename] [-s session_ID] [-r request_ID]
この構文の説明は次のとおりです。
user_name
は、Oracle Business Intelligenceリポジトリ内のユーザーの名前です。このパラメータによって、エントリの範囲が特定のユーザーに限定されます。このパラメータを指定しないと、問合せロギングが有効なすべてのユーザーが表示されます。
log_input_filename
は、コンテンツが取得される既存のログ・ファイルの名前です。このパラメータは必須です。
output_result_filename
は、ログの出力が保存されるファイルの名前です。ファイルがすでに存在する場合、ファイルに結果が追加されます。ファイルが存在しない場合は、新しいファイルが作成されます。この引数を指定しないと、出力はモニター画面に送信されます。
session_ID
は、ユーザー・セッションのセッションIDです。BIサーバーでは、セッションの開始時に、各セッションに一意のIDが割り当てられます。このパラメータによって、ログ・エントリの範囲が指定のセッションIDに限定されます。このパラメータを指定しないと、すべてのセッションIDが表示されます。
request_ID
は、個々の問合せのリクエストIDです。BIサーバーでは、問合せの開始時に、各問合せに一意のIDが割り当てられます。このパラメータによって、ログ・エントリの範囲が指定のリクエストIDに限定されます。このパラメータを指定しないと、すべてのリクエストIDが表示されます。
リクエストIDはアクティブなリクエスト間で一意ですが、セッションを通じて一意であるとはかぎりません。リクエストIDは循環方式で作成され、リクエストがクローズされたりセッションの実行に長時間かかったりする場合には、リクエストIDが再利用されます。
セッション・マネージャを通じてユーザー名、セッションIDおよびリクエストIDを見つけることもできます。詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』を参照してください。
管理者は、「プレゼンテーション・サービス管理」ページの「セッションの管理」オプションを使用して、問合せログを表示できます。
いくつかの問合せ情報を記録し、ログ・ビューアを起動すると、ログを分析できます。レベル1および2のログ・エントリは、通常、自明です。ログ・エントリは、基礎となるデータベースを担当するデータベース管理者(DBA)が、データベースを調整して最適な問合せパフォーマンスを実現するうえでの手がかりになります。問合せログは、BIサーバーを使用するアプリケーションの精度の確認にも役立ちます。
ログは、次のセクションに分かれています。
SQLリクエスト - このセクションには、クライアント・アプリケーションから発行されたSQL文が示されます。この情報を使用して、同じアプリケーションまたは別のアプリケーションから問合せを再実行できます。
一般の問合せ情報 - このセクションには、リポジトリ、ビジネス・モデル、および問合せが実行されたサブジェクト領域が示されます。この情報は、今後のアプリケーション開発やシステム管理における優先順位を設定するために使用可能な、問合せの使用状況に関する統計を収集する目的で使用できます。
データベース問合せ - このセクションは、"Sending query to the database named <data_source_name>"というエントリで開始します(ここで、<data_source_name>は、BIサーバーが接続しているデータソースの名前です)。複数のデータベース問合せを1つ以上のデータソースに送信できます。各問合せはログ内の1つのエントリに相当します。
データベース問合せセクションには、基礎となるデータベースに送信されたSQL文の記録など、様々な用途があります。記録されたこのSQL文を使用してデータベースに対して問合せを直接実行することで、パフォーマンス・チューニング、結果の検証またはその他のテストを行うことができます。この情報を使用して、問合せを受けている表を調べて、集計ナビゲーションが予測どおりに動作していることを確認することもできます。基礎となるデータベースの構造を理解している場合は、効果的な集計表や索引の構築など、パフォーマンス向上の手がかりにもなります。
問合せのステータス - ログ内の問合せ成功のエントリは、問合せが正常終了したか失敗したかを示します。失敗した問合せをログで検索して、失敗の原因を判断できます。たとえば、特定の時間帯のすべての問合せが、データベースの停止時間が原因で失敗することがあります。
この項では、特にプレゼンテーション・サービスにおけるロギングについて説明します。内容は次のとおりです。
Oracle Business Intelligenceのロギングの一般情報は、第6.4項「診断ログ・ファイルとログ構成ファイルについて」を参照してください。
デフォルトでは、Oracle BIプレゼンテーション・サービスは、すべてのエラー・イベントと、十分な重要性のある情報イベントや警告イベントを記録するように構成されています。サーバーの起動や停止が、重要な情報イベントの例です。ログ・ファイルには、sawlogxx.logという名前が付けられます。xxは、増分する値に置き換えられます。
発生する特定の問題をデバッグするために、ロギング・レベルを増やして、デフォルト構成より多くの情報を記録することができます。たとえば、Oracle BIプレゼンテーション・サービスの特定の接続問題をデバッグする場合は、saw.odbcログ・ソースのみ、最大ロギングを増やすことができます。これにより、このコンポーネントの詳細なロギングが追加されますが、他のイベントによる詳細なロギングでログがいっぱいになることはありません。Oracle BIプレゼンテーション・サービスのすべての構成情報は、instanceconfig.xmlファイルからロードされます。
注意: ロギングはパフォーマンスに影響するため、特定の問題を診断する場合を除いて、本番実装でロギングを増やさないでください。 |
プレゼンテーション・サービスの「管理」ページのオプションを使用してロギング・レベルを変更します。
プレゼンテーション・サービスのロギング・レベルを設定するには:
グローバル・ヘッダーで「管理」をクリックします。
「メンテナンスとトラブルシューティング」領域の「ログ構成の再ロード」で、使用するロギング・レベルを選択します。
「ログ構成の再ロード」をクリックすると、プレゼンテーション・サービスを再起動しなくても変更を有効にできます。
プレゼンテーション・サービスを停止して再起動しても、変更は引き続き有効です。
「セッションの管理」リンクをクリックして「セッションの管理」ページを表示します。
セッションごとに、適切なレベルを表の「ログ・レベル」列に指定します。
更新後のレベルは、そのセッションに対して即時有効になります。レベルを選択する際、必ず重大度の値をプレゼンテーション・サービスですべてのメッセージに指定されている値以下にします。
例6-3は、構成ファイルの構造を示しています。各ノードのカーディナリティは大カッコ内に示します。
例6-3 instanceconfig.xmlファイル内のログ・セクションの構造
Logging [1..1] Writers [0..1] Writer [0..1] WriterClassGroups [0..1] Filters [0..1] FilterRecord [0..n]
例6-4は、4つのライターを含むinstanceconfig.xmlファイルの例を示しています。
例6-4 4つのライターが含まれるinstanceconfig.xmlファイル
<?xml version="1.0" ?> <Server> . . . . . . . <Logging> <Writers> <Writer implementation="FileLogWriter" name="Global File Logger" writerClassId="1" dir="{%ORACLE_BIPS_INSTANCE_LOGDIR%}" filePrefix="sawlog" maxFileSizeKb="10000" filesN="10" fmtName="ODL-Text" ODLLogFilePath="{%ORACLE_BIPS_INSTANCE_LOGDIR%}/diagnostic.log"/> <Writer implementation="CoutWriter" name="Global Output Logger" writerClassId="2" /> <Writer implementation="EventLogWriter" name="Event Logger" writerClassId="3" /> <Writer implementation="CrashWriter" name="CrashWriter" writerClassId="4" /> </Writers> <WriterClassGroups> <WriterClassGroup name="All">1,2,3,4</WriterClassGroup> <WriterClassGroup name="File">1</WriterClassGroup> <WriterClassGroup name="Console">2</WriterClassGroup> <WriterClassGroup name="EventLog">3</WriterClassGroup> <WriterClassGroup name="Crash">4</WriterClassGroup> </WriterClassGroups> <Filters> <FilterRecord writerClassGroup="Console" path = "saw" information="1" warning="31" error="31" trace="0" incident_error="32" /> <FilterRecord writerClassGroup="File" path = "saw" information="1" warning="31" error="31" trace="0" incident_error="32" /> <FilterRecord writerClassGroup="File" path="saw.mktgsqlsubsystem.joblog" information="1" warning="2" error="31" trace="0" incident_error="32"/> <FilterRecord writerClassGroup="File" path="saw.httpserver.request" information="16" warning="32" error="32" trace="0" incident_error="32"/> <FilterRecord writerClassGroup="File" path="saw.httpserver.response" information="16" warning="32" error="32" trace="0" incident_error="32"/> </Filters> </Logging> </Server>
表6-4は、構成階層内の各ノードの説明を示しています。
表6-4 Oracle BIプレゼンテーション・サービス・ログ構成ファイルの要素
要素 | 属性 | 説明 |
---|---|---|
Writers |
なし |
ライター構成が含まれます。 この構成は起動時にロードされます。 |
Writer |
なし |
ライターを構成します。 |
Writer |
disableCentralControl |
(オプション)このエントリがFusion Middleware Controlによって更新されないように指定します。デフォルト値はtrueです。 |
Writer |
implementation |
次の実装が定義されています。
|
Writer |
name |
ライターの一意の名前です。 |
Writer |
writerClassId |
1 - 10の範囲の整数値を指定します。この値は、ロギングを許可または禁止するために、フィルタで使用されます。 個々のライターはそれぞれ一意の値を持つ必要があり、その値が後でフィルタ構成で使用されます。 異なるライターが同じクラスIDを持つこともありますが、その場合、フィルタでそれらのライターを区別することはできません。 |
Writer |
fmtName |
(オプション)ログ・メッセージの形式を指定します。有効な値は次のとおりです。
この属性を設定しないと、ログ・メッセージはデフォルト形式で表示されます。デフォルト形式は、ファイル・ログ・ライターの場合は10g形式で、コンソールの場合はODL-TEXTです。 例は、第6.6.4項「ログ・メッセージの形式例」を参照してください。 |
Writer(FileLogWriter固有の属性) |
dir |
ログ・ファイルが作成されるディレクトリを指定します。 |
Writer(FileLogWriter固有の属性) |
ODLLogFilePath |
Fusion Middleware Controlがログ・ビューアに表示するファイルを指定します。 |
Writer(FileLogWriter固有の属性) |
maxFileSizeKb |
ログ・ファイルの最大サイズをKB単位で指定します。 ファイル・サイズの上限に達するとファイルは閉じられ、新しいログ・ファイルが作成されます。 |
Writer(FileLogWriter固有の属性) |
filePrefix |
ログ・ファイルの接頭辞を指定します。 |
Writer(FileLogWriter固有の属性) |
filesN |
ログ・ファイルの最大数を指定します。 この値を超えると、最初のファイルが削除され、再び作成されます。ログ出力が起動し、最初のファイルの先頭に書き込みが実行されます。 |
Writer(EventLogWriter固有の属性) |
winSource |
ログに記録されるイベントのイベント・ログ・ソースを指定します。 |
Writer(CrashWriter固有の属性) |
file |
ダンプ・ファイル・パスを指定します。 Windowsの場合、ダンプ・ファイルは |
Writer(CrashWriter固有の属性) |
line |
ダンプ・ファイルの行番号です。 |
WriterClassGroups |
なし |
ライター・クラスの定義が含まれます。ライター・クラスは、ライター・クラスIDのグループです。 |
WriterClassGroup(クラスIDのカンマ区切りのリストを子テキストとして含む。) |
name |
WriterClassGroupの名前を指定します。 |
Filters |
なし |
フィルタ構成が含まれます。 |
FilterRecord |
writerClassGroup |
このレコードが適用されるライターのグループを指定します。WriterClassGroupは通常、WriterClassGroupsセクションであらかじめ定義されています。 |
FilterRecord |
disableCentralControl |
(オプション)このエントリがFusion Middleware Controlによって更新されないように指定します。デフォルト値はtrueです。 |
FilterRecord |
path |
ログ・ソース・パスを指定します。SOAP情報のロギングを有効にするには、次の値を入力します。 saw.httpserver.request.soaprequest 現在のフィルタ・レコードは、パスで識別されるソフトウェア・コンポーネントとそのすべてのサブコンポーネントに適用されます。 |
FilterRecord |
情報 |
対応するメッセージ・タイプの重大度を指定する整数が含まれます。 指定の値より重大度が低いメッセージのみが記録されます。 |
FilterRecord |
警告 |
対応するメッセージ・タイプの重大度を指定する整数が含まれます。 指定の値より重大度が低いメッセージのみが記録されます。 |
FilterRecord |
エラー |
対応するメッセージ・タイプの重大度を指定する整数が含まれます。 指定の値より重大度が低いメッセージのみが記録されます。 |
FilterRecord |
trace |
対応するメッセージ・タイプの重大度を指定する整数が含まれます。 指定の値より重大度が低いメッセージのみが記録されます。 |
FilterRecord |
incident_error |
対応するメッセージ・タイプの重大度を指定する整数が含まれます。 指定の値より重大度が低いメッセージのみが記録されます。 |
Writer要素のfmtName属性により、ログ・メッセージは、デフォルト(10g形式)、ODL-TEXT、ODL-XMLのいずれかの形式になります。これらの形式のエントリの例を、次に示します。
例6-5は、デフォルト形式を示しています。
例6-5 デフォルト形式
デフォルト形式の場合、次のように、識別の見出しを伴うメッセージが生成されます。
Type: Information Severity: 30 Time: Wed Jul 26 11:22:20 2006 File: project\sawserver\sawserver.cpp Line: 399 Properties: ThreadID-2552 Location: saw.sawserver saw.sawserver.initializesawserver saw.sawserver Oracle BI Presentation Services has started successfully.
例6-6は、ODL-TEXT形式を示しています。
例6-6 ODL-TEXT形式
短縮形式の場合、次のように、識別の見出しを伴わない省略された形式でメッセージが生成されます。
[timestamp] [component id] [messagetype:level] [message-id] [module id] ([field-name: field-value])* message-text [[ supplemental-detail ]] [2010-05-27T10:51:20.000-07:00] [OBIPS] [NOTIFICATION:1] [] [saw.sawserver] [ecid: 1243446680218334471555761] [tid: 2552] Oracle BI Presentation Services (OBIPS) 11.1.1.2 (Build 0) are starting up.[[ File:sawserver.cpp Line:432 Location: saw.sawserver saw.sawserver.initializesawserver saw.sawserver ecid: 1243446680218334471555761 ]]
例6-7は、ODL-XML形式を示しています。
例6-7 ODL-XML形式
xml形式の場合、次のように、XML形式のメッセージが生成されます。
<msg time="2010-05-08T18:41:05.000+00:00" comp_id="OBIPS" type="NOTIFICATION" level="1" msg_id="" module="saw.sawserver" ecid="124180446517874242628761" tid="127c"> <txt> Oracle BI Presentation Services has started successfully</txt> <suppl_detail /> </msg>
プレゼンテーション・サービスによって記録される各メッセージは、表6-5に示されている様々なコンポーネントで構成されます。
表6-5 プレゼンテーション・サービス・ログ・メッセージのコンポーネント
メッセージ・コンポーネント | 説明 |
---|---|
メッセージ・テキスト |
ユーザーへのログ・メッセージのテキストです。 |
メッセージ・タイプ |
5種類(情報、警告、エラー、インシデント・エラー、トレース)のうちの1つです。 詳細は、表6-2を参照してください。 |
重大度 |
重大度は、正の整数で表されます。 値が低くなるほど、メッセージの重大度は増します。重大度が0のメッセージは最も重要なタイプのメッセージであり、重大度が32のメッセージはまったく重要ではありません。 |
メッセージ・プロパティ |
プロパティには、他の種類の情報が含まれます。その種類はメッセージによって異なり、ユーザー名、クライアント・ブラウザのIPアドレス、スレッドIDなどが含まれる場合があります。 |
FilterRecordで、ロギングの詳細をカスタマイズします。FilterRecordを使用して、実装(出力タイプ)とWebログのカテゴリ(インシデント・エラー、エラー、トレース、警告および情報)のロギング・レベルを指定します。
次の例では、最初の2つのFilterRecordに、次の文字列が含まれています。
path="saw"
この文字列は、情報イベントをレベル1、エラー・メッセージをレベル31などで記録します。
<FilterRecord writerClassGroup="Console" path="saw" information="1" warning="31" error="31" trace="0" incident_error="32" /> <FilterRecord writerClassGroup="File" path="saw" information="1" warning="31" error="31" trace="0" incident_error="32" /> <FilterRecord writerClassGroup="File" path="saw.mktgsqlsubsystem.joblog" information="1" warning="2" error="31" trace="0" incident_error="32"/>
この上位パスはすべてのイベントに適用されます。
前述の例の3番目のFilterRecordのように、各種タイプのイベントのログ・レベルをさらに詳細に指定する新しいFilterRecordを追加することで、FilterRecordをカスタマイズできます。この例の場合、saw.mktgsqlsubsystem.logからディスク・ファイルに情報が記録され、Marketingジョブ・イベントが生成されます。
次の例に示すように、情報レベルを1から0に変更することによって、または行をコメント・アウトすることによって、ジョブの詳細のロギングを無効にできます。
<FilterRecord writerClassGroup="Console" path="saw" information="1" warning="31" error="31" trace="0" incident_error="32" /> <FilterRecord writerClassGroup="File" path="saw" information="1" warning="31" error="31" trace="0" incident_error="32" /> <FilterRecord writerClassGroup="File" path="saw.mktgsqlsubsystem.joblog" information="1" warning="2" error="31" trace="0" incident_error="32"/>
この項には次のトピックが含まれます:
エージェント・エラーおよびデバッグのログ・エントリが、Fusion Middleware Controlを使用してメイン・スケジューラ・ログ・ファイル、nqscheduler.logに書き込まれ、ログ・ビューアに表示されます。詳細は、第6.3.1項「ログ情報、エラー・メッセージおよびアラートを表示するためのFusion Middleware Controlの使用」を参照してください。
エージェント・ログ・エントリには、キー・エージェント・イベントが含まれ、単一のトレース行に情報が記載されます。例:
Agent Chain Completed. Status: Completed, Agent ID: /users/weblogic/ChainedAgent, UserID: weblogic, OBIPS: example.com:0:9710, Job/Instance ID: 123/4567
表6-6に、エージェント・イベント・ロギングおよび関連するトレース・タイプとレベルを示します。
表6-6 エージェント・イベント・ロギングおよび関連する値
イベント | 状態 | メッセージ・タイプ:レベル |
---|---|---|
エージェント・チェーンを開始しました。 |
実行中 |
TRACE:1 |
エージェント・チェーンを開始しました。 |
再実行中 |
NOTIFICATION:1 |
エージェント・チェーンが完了しました。 |
失敗 |
ERROR:1 |
エージェント・チェーンが完了しました。 |
タイムアウト |
ERROR:1 |
エージェント・チェーンが完了しました。 |
タイムアウト |
WARNING:1 |
エージェント・チェーンが完了しました。 |
警告 |
WARNING:1 |
エージェント・チェーンが完了しました。 |
取消済 |
NOTIFICATION:1 |
エージェント・チェーンが完了しました。 |
再度実行 |
NOTIFICATION:1 |
エージェント・チェーンが完了しました。 |
完了 |
TRACE:1 |
開始されたエージェント |
N/A |
TRACE:1 |
終了したエージェント |
N/A |
TRACE:1 |
Fusion Middleware Control内のレベルを設定すると、nqscheduler.logファイルに書き込まれたログ出力の詳細を確認できます。詳細は、第6.3.2項「ログ・ファイルのローテーション・ポリシーの構成とログ・レベルの指定」を参照してください。ECIDを使用してログ・エントリをフィルタ処理をし、特定のエージェント・チェイン固有の情報を検索できます。
エージェントが実行に完全に失敗した場合やOracle BIスケジューラでデバッグが有効な場合には、エージェントのログ・ファイルが生成されます。
Oracle BIスケジューラのinstanceconfig.xmlファイル内でDebug要素をtrueに設定することによって、デバッグを手動で有効にできます。たとえば、次の場所にあります。
oraclehome/user_projects/domains/bi/config/fmwconfig/biconfig/OBISCH
詳細は、第6.4.2項「診断ログ構成ファイルの概要とその位置」を参照してください
エージェント・ログ・ファイルの場所もOracle BIスケジューラのinstanceconfig.xmlファイルで指定されます(詳細は、第18.3.3.3項「エージェントのスケジューラ構成設定」を参照)。ログ・ファイルのデフォルトの場所は、Oracle BIスケジューラがインストールされるコンピュータの、Oracle Business Intelligenceインストール・ディレクトリ内のLogディレクトリです。
ログ・ファイル名の形式は、次のとおりです。
Agent-JobID-InstanceID.xxx
このファイル名の各部の内容は、次のとおりです。
Agentは、すべてのエージェント・ログ・ファイルの接頭辞です。
JobIDは、エージェントのOracle BIスケジューラ・ジョブ識別子です。
InstanceIDは、エージェントのOracle BIスケジューラ・インスタンス識別子です。
xxxは、ファイル拡張子です。
.errは、エージェント・エラー・ログ・ファイルを表します。
.logは、デバッグ・ログ・ファイルを表します。
エージェント・エラー・ログ・ファイルとデバッグ・ログ・ファイルは、実行に失敗したエージェント・インスタンスごとに、個別のファイルとして作成されます。テキスト・エディタを使用してファイルを表示できます。エントリは、通常、自明です。
エラー・ログがあるからといって、エージェントが完全に失敗したとはかぎりません。たとえば、エージェントが複数の電子メール・アドレスにコンテンツを配信するものとします。無効なアドレスがある場合や、メール・サーバーが停止している場合には、エージェントに対してエラー・ログが生成されます。
ジョブ・マネージャで、エラー・メッセージと、ジョブ・インスタンスの終了コードを表示することもできます。詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionジョブ・スケジューリング・ガイドのジョブ・マネージャのインスタンス・プロパティに関する項を参照してください。終了ステータスは、正常終了した配信の数を示します。
この項では、ODBC/JDBCプロシージャを使用してOracle BIサーバーに関する診断情報を取得する方法について説明します。内容は次のとおりです。
ODBC/JDBCプロシージャを使用して、Oracle BIサーバーに関する診断情報を取得することができます。これらのプロシージャは、管理ツールを実行できない非Windowsプラットフォーム上で特に有用です。
nqcmdユーティリティで、ODBCを使用してプロシージャを実行します。詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のnqcmdを使用したリポジトリのテストと改良に関する項を参照してください。
JDBCを使用してプロシージャを実行することもできます。JDBCを使用してOracle BIサーバーに接続する方法の詳細は、ORACLE_HOME/bi/bifoundation/jdbcのbijdbc.jarファイルに含まれるREADME.TXTファイルを参照してください。
最初にOBISAvailableDiagnostics()
を実行して、使用可能な診断カテゴリのリストと説明を取得できます。例:
call OBISAvailableDiagnostics()
この結果は、次のように表示されます。
カテゴリ | 説明 |
---|---|
General | 接続したOBISインスタンスの一般的な概要 |
DBInstance:DBNAME1 | DBNAME1で名前が付けられたDBインスタンスに関連するすべての統計 |
DBInstance:DBNAMEn | DBNAMEnで名前が付けられたDBインスタンスに関連するすべての統計 |
LDAP:Instance1 | Instance1で名前が付けられたLDAPインスタンスに関連するすべての統計 |
LDAP:Instancen | Instancenで名前が付けられたLDAPインスタンスに関連するすべての統計 |
DBConnectionPool:Instance1 | Instance1で名前が付けられたDB接続プールに関連するすべての統計 |
DBConnectionPool:Instancen | Instancenで名前が付けられたDB接続プールに関連するすべての統計 |
ThreadPool:Instance1 | Instance1で名前が付けられたスレッド・プールに関連するすべての統計 |
ThreadPool:Instancen | Instancenで名前が付けられたスレッド・プールに関連するすべての統計 |
Cache:Instance1 | Instance1で名前が付けられたキャッシュに関連するすべての統計 |
Cache:Instancen | Instancenで名前が付けられたキャッシュに関連するすべての統計 |
「General」カテゴリを除き、カテゴリはすべて「Instance」カテゴリです。「Instance」カテゴリは、(特定の物理データベースなどの)特定のインスタンス・オブジェクトに関連する統計です。オブジェクトの複数のインスタンスを初期化した場合、category_name:instance_nameという形式で、インスタンスごとに個別のカテゴリが存在します。例については、上の表を参照してください。
ODBC/JDBCカテゴリについて次の点に注意してください。
「ThreadPool」カテゴリには、DbConnection PoolMgrによって作成および管理されているスレッドからの統計のみが表示されます。
「Cache」カテゴリには、Compiler CacheおよびLDAP Internal Cacheからの統計が表示されます。
使用可能な診断カテゴリを取得すると、OBISDiagnostics(
string
)
をコールして、個々のカテゴリの診断を取得できます。ここで、string
はカテゴリ名です。例:
call OBISDiagnostics('ThreadPool:orcldb_pool')
この結果は、次のように表示されます。
パラメータ名 | 値 |
---|---|
CAPACITY | 1000 |
THREAD COUNT | 20 |
BUSY THREAD COUNT | 15 |
ACCUMULATED REQUESTS | 5 |
MAX STACK SIZE | 100 |
カテゴリのスペルは正しくなければなりません。正しくない場合は、行が返されません。
次にもう1つの例を示します。
call OBISDiagnostics('General')
この結果は、次のように表示されます。
パラメータ名 | 値 |
---|---|
TOTAL SESSIONS | 10 |
QUERIES PER SEC | 5 |
NEW LOGINS | 10 |
ACTIVE LOGINS | 7 |
NEW REQUESTS | 30 |
DATA CACHE HIT PER SEC | 5 |
NEW INIT BLOCKS | 10 |
次の表は、各カテゴリ・タイプのパラメータ参照情報を示しています。
表6-7 「General」カテゴリのパラメータ
パラメータ名 | 説明 |
---|---|
TOTAL SESSIONS |
Oracle BIサーバーにクライアントを接続しているセッションの合計数。 |
QUERIES PER SEC |
Oracle BIサーバーで完了した問合せの1秒当たりの数。 |
NEW LOGINS |
Oracle BIサーバーが受信した新規ログイン・リクエストの合計数。 |
ACTIVE LOGINS |
Oracle BIサーバー内でアクティブなログインの合計数。 |
NEW REQUESTS |
Oracle BIサーバーが受信した新規実行リクエストの数。 |
DATA CACHE HIT PER SEC |
1秒当たりのデータ・キャッシュ・ヒットの割合。 |
NEW INIT BLOCKS |
Oracle BIサーバーが受信した新規初期化ブロック・リクエストの合計数。 |
表6-8 「DBInstance」カテゴリのパラメータ
パラメータ名 | 説明 |
---|---|
QUERIES PER SEC |
バックエンド・データベースで完了した問合せの1秒当たりの数。 |
FAILED QUERIES PER SEC |
バックエンド・データベースで失敗した1秒当たりの問合せの数。 |
NEW PREPARES |
バックエンド・データベースに送信された準備の数。 |
ROWS PER SEC |
バックエンド・データベースから取得された1秒当たりの行数。 |
KB PER SEC |
バックエンド・データベースから取得された1秒当たりのKB数。 |
表6-9 「LDAP」カテゴリのパラメータ
パラメータ名 | 説明 |
---|---|
NEW REQUESTS |
受信された新規LDAP認証リクエスト数の合計数。 |
NEW IMPERSONATED REQUESTS |
受信された新規偽装LDAP認証リクエスト数の合計数。 |
ACTIVE REQUESTS |
Oracle BIサーバー内でアクティブなLDAP認証リクエストの数。 |
表6-10 「DBConnectionPool」カテゴリのパラメータ
パラメータ名 | 説明 |
---|---|
CAPACITY |
データベース接続プールで許可される最大の接続数。 |
CONNECTION COUNT |
スレッド・プールのオープン接続の現在の数。 |
BUSY CONNECTION COUNT |
データベース接続プールで問合せを処理するために割り当てられた接続、または問合せを現在処理中の接続の数。 |
AVG REQUESTS PER SEC |
データベース接続プールに送信された1秒当たりの平均リクエスト数。 |
AVG OPEN REQUESTS PER SEC |
1秒当たりにオープンされる接続の平均数。他の接続がタイムアウトになったか、接続に問題があるため、新しい接続に対して接続がオープンされている可能性があります。 |
表6-11 「ThreadPool」カテゴリのパラメータ
パラメータ名 | 説明 |
---|---|
CAPACITY |
スレッド・プールで許容されるスレッドの最大数。 |
THREAD COUNT |
スレッド・プール内の現在のスレッド数。 |
BUSY THREAD COUNT |
作業が割り当てられている現在のスレッド数。スレッドがリソースまたはデータを待機中にブロックされたか、CPU上でアクティブに実行されている可能性があります。 |
ACCUMULATED REQUESTS |
スレッド・プールに送信されたリクエストの合計数。 |
MAX STACK SIZE |
スレッド・プール内のすべてのスレッドによって消費されたスタック・バイトの最大数。 |
ここでは、システムの起動に関連した解決策について説明します。
管理サーバーの起動時は、インストール時に指定したリポジトリ・データベースが実行されている必要があります。実行されていないと、JDBCエラーにより起動できなくなります。
問題: 管理サーバーを起動できない。
管理サーバーを起動できない場合は、次の操作を実行します。
次のディレクトリにある、管理サーバーおよび管理対象サーバーのログ・ファイルを参照します。
BI_DOMAIN/servers/AdminServer/logs
次のディレクトリにある管理対象サーバーのログ・ファイルを確認することも可能です。
BI_DOMAIN/servers/bi_server1/logs
原因: データベースが停止している。AdminServer.logに、次のスタック・トレースとともに「Caused By: java.net.UnknownHostException: yourcomputername」が書き込まれます。
####<Jan 19, 2010 8:04:09 PM PST> <Info> <JDBC> <username> <AdminServer> <[ACTIVE] ExecuteThread: '0' for queue: 'weblogic.kernel.Default (self-tuning)'> <<anonymous>> <Stack trace associated with message 001129 follows:
java.sql.SQLException: The Network Adapter could not establish the connection.
解決: データベースを起動します。
管理対象サーバーが停止している場合、コマンドラインを使用して起動します。
詳細は、第2.3.2項「ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動」を参照してください。
BIサーバーを起動できない場合は、次のディレクトリにあるログ・ファイルを参照します。
BI_DOMAIN/servers/obis1/logs。またはログ・ビューアを使用します。
問題: Oracle WebLogic Server管理コンソールにログインできない。
原因: 管理サーバーが稼動していない。
解決策: http://<host>:<port>/consoleが起動するかどうか確認してください。起動しない場合、BIシステムを起動します。詳細は、第2.3項「コマンドを使用した停止、起動およびOracle Business Intelligenceプロセスのステータスの表示」を参照してください。