プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle Business Intelligence Publisher管理者ガイド
12c (12.2.1.3.0)
E80600-02
目次へ移動
目次

前
次

12 診断とパフォーマンスの監視

この章では、BI Publisherの問題を診断するためのログ・ファイルの構成、およびユーザー・アクティビティとシステム・パフォーマンスのメトリックを取得するためのユーザー監査の構成について説明します。

内容は次のとおりです。

Oracle BI Publisherでの問題の診断と解決

Oracle BI Publisherの使用時に問題が発生した場合のエンド・ユーザーのサポートや、原因を把握して問題を修正するためのOracleサポートとのやり取りは、通常、システム管理者が担当します。

問題は、エンド・ユーザーがエラー・メッセージを受信したり、パフォーマンスの低下や可用性の損失を経験したときに報告されることがあります。

管理者は、主に次のように対処して問題解決をサポートします。

診断ログ・ファイルについて

BI Publisherは、Oracle Diagnostic Logging (ODL) 形式で診断ログ・ファイルに書き込みます。

ログ・ファイルの名前とログ・ファイルの内容の形式は、Oracle標準に準拠します。WLST displayLogsコマンドを使用してログ・ファイルを表示するか、ログ・ファイルをローカル・クライアントにダウンロードし、別のツールを使用してそれらを表示することができます(たとえば、テキスト・エディタや別のファイル表示ユーティリティ)。

ログ・ファイルは、Oracle Fusion Middleware Controlを使用して作成および編集されます。デフォルトでは、インストール後、bipublisher-handlerログが作成されます。このログ・ファイルを構成することも、新しいロガーを作成することもできます。

ログ・ファイル・メッセージのカテゴリとレベルについて

ログ・ファイルの各メッセージ・カテゴリは、1から32までの特定のデフォルト値に設定され、ログ・レベル以下のレベルのメッセージだけがログに書き込まれます。

ログ・ファイルのメッセージには次の表に説明するように様々なカテゴリがあります。

レベル 説明

IncidentError:1

原因不明の重大な問題です。この問題を解決するにはOracleサポートに問い合せる必要があります。この例としては、回復不能なエラーや重大な問題があります。

Error:1

システム管理者が対応する必要がある問題が発生しましたが、製品の不具合によるものではありません。パフォーマンスへの影響はありません。

Warning:1

管理者による確認を要する、潜在的な問題。この例としては、パラメータ値が無効な場合や指定したファイルが存在しない場合などがあります。

Notification:1

プライマリ・サブコンポーネントや機能のアクティブ化や非アクティブ化などの主要なライフサイクル・イベント。これはNOTIFICATIONのデフォルト・レベルです。

NOTIFICATION:16

通常のイベントをレポートする粒度の詳細なレベル。

TRACE:1

パブリックAPIエントリや終了ポイントなど、管理者に重要なイベントに関するトレースまたはデバッグ情報。

TRACE:16

詳細なトレースまたはデバッグ情報で、Oracleサポートによる特定のサブシステムの問題診断に有益なもの。

TRACE:32

非常に詳細なトレースまたはデバッグ情報で、Oracleサポートによる特定のサブシステムの問題診断に有益なもの。

ログ・ファイルの形式について

ログ・ファイルの形式は一貫している必要があります。

ただし、使用可能な形式は複数あり、ログ・ファイルで使用する形式は変更も可能です。ログ・ファイルで使用する形式を変更し、新しい形式が現在のログ・ファイルの形式と異なる場合は、新しいログ・ファイルが作成されます。たとえば、ODL-XMLを含むログ・ファイルには必ずXMLが含まれ、テキストが混在することはありません。

ログ・ファイルの形式は「ログ・ファイルの編集」ダイアログで構成します。「ログ・ファイルの構成」を参照してください。形式は、TextまたはXMLにすることができます。

ログ・ファイル・ローテーションについて

ログ・ファイルのローテーションは、ファイル・サイズまたは時間に基づきます。

ログ・ファイルがローテーションの基準を超えると常に、既存のログ・ファイルの名前が変更され、新しいログ・ファイルが作成されます。

ファイルは次のように命名されます。

  • log.xml

  • log.xml.1(最も古いログ・ファイル)

  • log.xml.n

ログ・ファイルの構成

Oracle Fusion Middleware Controlを使用してBI Publisherのログ・ファイルを構成します。

次のトピックを参照してください。

ログ・レベルの設定

Oracle Fusion Middleware Controlでログ・レベルを設定できます。

Oracle Fusion Middleware Controlでログ・レベルを設定するには
  1. Oracle Fusion Middleware Controlで、BI Publisherサーバーを見つけます。次に例を示します。

    Application Deploymentsの下のbipublisher (11.1.1) (bi_cluster)を展開し、bipublisher (11.1.1)(bi_server1).を右クリックします。

  2. メニューから、「ログ」をクリックし、「ログ構成」をクリックします。
  3. ログ・レベル」タブの「ログ出力名」で、「ルート・ログ出力」を展開し、次に「Oracle」を展開します。

    oracle.xdoの場所を特定し、ドロップダウン・リストからログ・レベルを選択します。

  4. 「適用」をクリックします。

その他のログ・ファイル・オプションの構成

Oracle Fusion Middleware Controlでログ・ファイルを構成します。

ログ・ファイルを構成するには:
  1. 「ログ・レベルの構成」で説明されているように、「ログ構成」ページに移動します。
  2. 「ログ・ファイル」タブを選択します。
  3. 表でbipublisher-handlerを選択し、「構成の編集」をクリックします。
  4. 「ログ・ファイルの編集」ダイアログで、bipublisher-handlerのログ・ファイル・オプションを構成します。サンプルを次に示します。

スケジューラ・ジョブ診断の有効化

「レポート・ジョブのスケジュール」ページの「診断」タブでジョブ診断を有効にして、「レポート・ジョブ履歴」からジョブ診断ログをダウンロードできます。

「レポート・ジョブのスケジュール」ページの「診断」タブにアクセスするには、BI管理者またはBIデータ・モデル開発者の権限が必要です。次の手順に従って、ジョブ診断を有効にします。
  1. 「新規」メニューから「レポート・ジョブ」を選択します。
  2. スケジュールするレポートを選択し、「診断」タブをクリックします。
  3. 必要な診断を選択して有効にします。
    オプション 説明
    SQL実行計画の有効化 実行計画またはSQLモニター・レポートの情報を含む診断ログを生成します。
    データ・エンジン診断の有効化 データ・プロセッサ・ログを生成します。
    レポート・プロセッサ診断の有効化 FO (書式設定オプション)とサーバー関連ログの情報を生成します。
    統合ジョブ診断の有効化 スケジューラ・ログ、データ・プロセッサ・ログ、FOおよびサーバー・ログの詳細を含む全体ログを生成します。

    「レポート・ジョブ履歴」からジョブ診断ログをダウンロードして、詳細を表示できます。

ログ・メッセージの表示

Oracle Fusion Middleware Controlを使用してログ・メッセージを表示するか、直接ログ・ファイルを表示できます。

Oracle Fusion Middleware Controlでログ・メッセージを表示するには:

  1. Oracle Fusion Middleware Controlで、BI Publisherサーバーを見つけます。次に例を示します。

    「アプリケーションのデプロイ」の下で、bipublisher (11.1.1)を右クリックします。

  2. メニューから、「ログ」をクリックし、「ログ・メッセージの表示」をクリックします。
  3. 特定のログ・ファイルを表示するには、「ターゲット・ログ・ファイル」をクリックします。
  4. ログ・ファイル」ページで、メッセージを表示する特定のログを選択するか、ログ・ファイルをダウンロードします。
  5. ログ・ファイルの表示」をクリックして、メッセージを表示します。

ログ・ファイルの読込みによるメッセージの表示

ログ・ファイルは、「ログ・ファイルの編集」ダイアログの「ログ・パス」に指定されたディレクトリにあります。サーバー上のそのディレクトリに移動して、ログ・ファイルを表示します。

次は、ODL形式のエラー・メッセージの例です。

<msg time="2009-07-30T16:00:03.150-07:00" comp_id="xdo" type="ERROR" level="1" host_id="MyBIPHost" host_addr="122.22.222.22" module="oracle.xdo" tid="11" user="Administrator">
<txt>Variable 'G_dept' is missing...</txt>
</msg>

次の表は、ログ・ファイルに表示されるメッセージの属性を説明しています。

属性名 説明

time

メッセージが生成された日時。ローカル・タイムゾーンが反映されます。

comp_id

メッセージを生成したコンポーネントのID。

type

メッセージのタイプ。使用可能な値は、INCIDENT_ERROR、ERROR、WARNING、NOTIFICATION、TRACEおよびUNKNOWNです。メッセージ・タイプの詳細は、「ログ・ファイル・メッセージのカテゴリとレベルについて」を参照してください。

level

メッセージ・レベル。メッセージ・タイプを限定する整数値で示されます。指定できる値は、1 (最高の重大度)から32 (最低の重大度)までです。

host_id

メッセージを生成したホストの名前。

host_addr

メッセージを生成したホストのネットワーク・アドレス。

module

メッセージを生成したモジュールのID。コンポーネントが単独のモジュールの場合は、この属性にコンポーネントIDが表示されます。

tid

メッセージを生成したスレッドのID。

user

メッセージを生成した実行コンテキストを所有するユーザーの名前。

パフォーマンスの監視とユーザー監査について

パフォーマンスの監視では、問合せ、レポートおよびドキュメント生成のパフォーマンスを監視したり、収集した詳細情報を分析できます。

BI PublisherはOracle Dynamic Monitoring Service (DMS)でパフォーマンス統計を収集します。http://server_address:enterprise_manager_port/dms/SpyでEnterprise ManagerのDMSによって提供されているDMSスパイのサーブレットを使用して、パフォーマンス・データを監視できます。BI Publisherでは、DMSによって収集された属性、動作および関連統計を明らかにするMBeanも提供されます。次の表に、提供されるBeanの概要を示します。

管理Bean 説明

ReportEventMonitor

レポートごとに1つのMbeanを作成し、レポートの詳細な監視データを表示します。

ServerEventMonitor

サーバーごとに存在し、ユーザーとサーバーのアクティビティ・サマリーを表示します。

UserEventMonitor

ユーザーごとに1つのMbeanを作成し、ユーザーの詳細な監視データを表示します。

監視と監査の有効化

管理サーバー構成ページで監視と監査を有効にします

監視と編集を有効にする手順は次のとおりです。

  1. 管理サーバー構成ページで「モニターと監査」を有効にします。「「サーバー構成」ページでの監視と監査の有効化」を参照してください。

  2. Fusion Middleware Control(Enterprise Manager)を使用して、「監査ポリシー設定」を構成します。「監査ポリシー設定の構成」を参照してください。

  3. WebLogic Serverを再起動します。

「サーバー構成」ページでの監視と監査の有効化

BI Publisherアプリケーションの監視と監査を有効にすることができます。

監視と監査を有効にする手順は次のとおりです
  1. 管理」リンクをクリックします。
  2. 「システム・メンテナンス」で「サーバー構成」を選択します。
  3. 「監視と監査」リージョンで、「監視と監査の有効化」チェック・ボックスを選択します。

監査ポリシー設定の構成

Oracle Fusion Middleware Controlで監査ポリシー設定を構成します。

監査ポリシー設定を構成するには

  1. Oracle Fusion Middleware Controlの「WebLogicドメイン」で、「セキュリティ」「監査登録とポリシー」の順に選択します。
    監査されたアプリケーションが「監査ポリシー」ページの「WebLogicドメイン」の下に表示されます。
  2. 「監査コンポーネント名」リストから「BI Publisherサーバー」を選択します。
  3. 監査レベル」を設定し、BI Publisherの監査を有効にします。次の図に例を示します。

通常では、「監査レベル」「中」に設定します。

イベントごとに監査レベルをカスタマイズする場合は、「監査レベル」リストから「カスタム」を選択します。この設定により、イベントごとに監査レベルを設定してフィルタを適用できるようになります。使用可能なイベントを表示するために、カテゴリ(「ユーザー・セッション」、「レポート・アクセス」、「レポート実行」、「レポート・ジョブ」または「レポート・アクセス」)を選択します。

BI Publisherサーバーの監査対象のイベントは次のとおりです。

  • ユーザー・ログイン

  • ユーザー・ログアウト

  • レポート・リクエスト

  • レポート・リクエストのスケジュール

  • レポート再公開

  • レポート・データのダウンロード

  • レポートのダウンロード

  • レポート・データ・プロセス

  • レポート・レンダリング

  • レポートの配信

  • レポート・ジョブのスケジュール

  • レポート・ジョブの取消し

  • レポート・ジョブの削除

  • レポート・ジョブのパージ

  • レポート・ジョブの再開

  • レポート・ジョブ履歴の削除

  • レポート・ジョブ履歴のパージ

  • リソースの作成

  • リソースの更新

  • リソースのコピー

  • リソースの削除

  • リソース名の変更

WebLogic Serverの再起動

WebLogic Serverインスタンスを再起動します。

それには、Oracle Fusion Middleware Controlを使用するか、Windowsを実行している場合は「スタート」メニューから「Stop BI Servers」「Start BI Servers」を選択します。

監査ログの表示

WebLogic Server BIサーバー・ディレクトリのbipublisherフォルダの監査ログを表示できます。ORACLE_HOME/user_projects/domains/bi/servers/bi_server1/logs/auditlogs/bipublisher/audit_1_0.log

データベースの監査リポジトリに問い合せることもできます。収集されたデータを分析するために、BI Publisherを使用して独自のレポートを作成できます。

監査フレームワークで提供されるレポートの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』を参照してください。

12cリリースでBIドメインを構成すると、ドメインに対する監査スキーマが作成され、データソースが作成され、監査データベースが登録されます。

BI Publisherを使用した監査レポートの作成

監査を構成したら、BI Publisherを使用して独自のレポートを作成し、監査データを視覚化できます。

BI Publisherで監査データのレポートを作成する手順は次のとおりです。

  1. データソースをBI Publisherに登録します。
  2. データ・モデルの作成
  3. レポートを作成します。

BI Publisherへのデータソースの登録

以前の手順でJNDIとして作成した監査データソース(JNDI/JDBC接続)をJNDIデータソースとしてBI Publisherに登録します。

JNDIとして登録したJDBC接続を作成したので、接続URL、ユーザー名とパスワードなどを入力してJDBC接続を新たに作成する必要はありません。JNDI名(例: jdbc/AuditDB)を使用するのみで登録できます。

  1. 管理者権限でBI Publisherにログインし、「管理」リンクをクリックします。
  2. データソース」で、「JNDI接続」をクリックし、「データソースの追加」をクリックします。
  3. 「データソース名」および「JNDI名」dbc/AuditViewDataSourceを入力します。
  4. 接続のテスト」をクリックしてデータソース接続が機能していることを確認します。
  5. データソースに適切なロールを追加し、レポート開発者とコンシューマがこのデータソースに構築されたレポートを参照できるようにします。
  6. 「適用」をクリックして保存します。

データ・モデルの作成

BIPUBLISHER_Vビューに対してSQL問合せを実行して、データ・モデルを作成します。

監査データソースからデータ・モデルを作成する手順は次のとおりです。

注意:

『Oracle Business Intelligence Publisherデータ・モデリング・ガイド』を参照してください。

  1. グローバル・ヘッダーで、「新規」をクリックし、「データ・モデル」をクリックします。
  2. デフォルトのデータソース」を監査JNDIデータソースに設定します。
  3. 「データ・セット」をクリックし、「新規作成」メニューから新しい「SQL問合せ」データセットを選択します。
  4. クエリー・ビルダーを使用して問合せを作成するか、BIPUBLISHER_Vビューに対するSQL問合せを入力します。

    次のSQL問合せサンプルでは、すべてのイベント・タイプに共通するBI Publisher監査データのみが返されます。

    Select IAU_EVENTCATEGORY,
           IAU_EVENTTYPE,
           IAU_EVENTSTATUS,
           to_char("IAU_TSTZORIGINATING", 'DD-MON-YYYY HH24:MI:SSxFF') as IAU_DATETIME,
           IAU_INITIATOR,
           IAU_RESOURCE,
           IAU_MESSAGETEXT
    from BIPUBLISHER_V;

    監査で記録される属性はイベントのカテゴリとタイプによって異なります。イベントのカテゴリまたはタイプに固有の属性をフェッチするために、イベントのタイプまたはカテゴリごとに個別の問合せを作成できます。

    次の問合せサンプルでは、レポートの作成、データソースの削除、フォルダ名の変更など、リソースへのアクセスの監査レコードが返されます。各イベント・タイプの記録済属性の完全なリストは、「Oracle Business Intelligence Publisherの監査イベント」を参照してください。

    SELECT IAU_EVENTCATEGORY,
           IAU_EVENTTYPE,
           to_char("IAU_TSTZORIGINATING", 'DD-MON-YYYY HH24:MI:SSxFF') as IAU_DATETIME,
           IAU_INITIATOR, 
           IAU_EVENTSTATUS,
           IAU_FAILURECODE, 
           IAU_MESSAGETEXT,
           IAU_RESOURCE,
           RESOURCETYPE,
           RESOURCESUBTYPE,
           NEWPATH,
           NEWNAME
    from BIPUBLISHER_V where IAU_EVENTCATEGORY = 'ResourceAccess'
  5. データ・モデルをテストするには、「データの表示」をクリックします。サンプル・サイズを選択し、データ・モデルを実行します。サンプルのXMLをデータ・モデルに保存します。
  6. データ・モデルを保存します。

レポートの作成

これで、BI Publisherのレイアウト・オプションのいずれか1つを使用してレポート・レイアウトを設計し、監査データを視覚化できるようになりました。

BI Publisherレイアウト・エディタを使用してレポートを作成する手順は次のとおりです
  1. グローバル・ヘッダーで、「新規」をクリックし、「レポート」をクリックします。
  2. 以前の手順で作成したデータ・モデルを選択します。
  3. レポート作成ウィザードの指示に従ってレポートを作成します。

    レイアウト・エディタの使用方法の詳細は、『Oracle Business Intelligence Publisherレポート・デザイナーズ・ガイド』のBI Publisherのレイアウト・テンプレートの作成に関する項を参照してください。

DMSスパイでのパフォーマンス統計の表示

管理者権限を持つユーザーのみが、DMSスパイのサーブレットを使用して、レポート・イベント・モニター、ユーザー・イベント・モニターおよびサーバー・イベント・モニターによって収集されたパフォーマンス統計を表示できます。

DMSスパイでパフォーマンス統計を表示する手順は次のとおりです
  1. 管理者としてhttp://server_address:enterprise_manager_port/dms/Spyにログインします。
  2. パフォーマンス・データを表示するには、メトリック表からオプションを選択します。
    オプション 説明
    BIPUBLISHER サーバーのサマリー・パフォーマンス・データ
    BIPUBLISHER_Reports レポート別パフォーマンス・データ
    BIPUBLISHER_Users ユーザー別データ

MBeanブラウザでのパフォーマンス統計の表示

システムMBeanブラウザを使用して、レポート・イベント・モニター、サーバー・イベント・モニターおよびユーザー・イベント・モニターによって収集されたパフォーマンス統計を表示できます。

MBeanブラウザでパフォーマンス統計を表示する手順は次のとおりです
  1. Fusion Middleware Controlで「WebLogicドメイン」をクリックして、「システムMBeanブラウザ」を選択します。
  2. 「システムMBeanブラウザ」の「アプリケーション定義のMBean」で、oracle.xdoフォルダを開き、BI Publisher MBeanを表示します。リストを開き、Beanを選択して詳細を表示します。