7 分析の管理
WebCenter Portalのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後に行ったすべての構成変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。分析コレクタ構成に対するすべての変更は、分析データベースに格納されます。
ノート:
Fusion Middleware ControlまたはWLSTを使用して分析の構成に対して加えた変更は動的ではないため、変更を有効にするには、分析コレクタまたはポータル・アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。
権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdmin
ロール、WebCenter Portal管理を使用して付与されるAdministrator
ロールが付与されている必要があります。
ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。
WebCenter Portalの分析について
WebCenter Portal管理者およびビジネス・ユーザーは、分析を使用することによって、ポータルの使用状況を追跡および分析できます。分析では、次の基本機能が提供されます。
-
使用状況トラッキング・メトリック: 分析は、コミュニティ、ページおよびポートレットの訪問を含む、一般的なポータル機能のメトリックを収集し、レポートします。
-
動作トラッキング: ユーザーはポータル・メトリックを分析して、ポータル訪問期間や、一定期間の使用状況などの使用パターンを特定できます。
-
ユーザー・プロファイルの相関: ユーザーは、メトリック情報をユーザー・プロファイル情報と関係付けることができます。国、会社、都道府県などのユーザー・プロファイル・データを基準に、使用状況トラッキング・レポートを表示およびフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の問合せオプションに関する項を参照してください。
次の各項では、分析のコンポーネントと、すぐに使用可能なタスク・フローの概要を説明します。
分析のコンポーネント
次の図は、WebCenter Portalにおける分析のコンポーネントを示しています。
-
WC_Portal
– Oracle WebCenter Portalおよび分析コレクタがデプロイされている管理対象サーバー。 -
イベント・データ
– 定義されたイベント・セットが分析によって追跡および収集されます。すぐに使用可能な最多発イベントの包括的なセットが付属しています。 -
Open Usage API – OpenUsage APIによって、UDP (ユーザー・データグラム・プロトコル)を使用して分析コレクタにメトリックが送信されます。
-
分析コレクタ – 分析コレクタ・コンポーネントによって、イベント・データが収集されます。
分析コレクタをクラスタ化して、スケーラビリティと信頼性を高めることができます。
-
分析データベース – 分析データベース(ACTIVITIES)には、ポータル・イベントおよび非ポータル・イベントから収集されたメトリックが格納されます。
-
分析タスク・フロー – 分析によって、一般的なポータル機能のメトリックを報告する一連のタスク・フローが提供されます。
-
MDS – タスク・フローのカスタマイズを格納するMetadata Service (MDS)リポジトリ。
図7-1 分析のコンポーネント
![分析のコンポーネント 分析のコンポーネント](img/wcadm_analy_over.gif)
分析タスク・フロー
表7-1は、WebCenter Portalで使用可能な分析タスク・フローを示しています。これらのタスク・フローの詳細および使用方法は、『Oracle WebCenter Portalでのポータルの構築』の分析についてに関する項を参照してください。
表7-1 WebCenter Portalでの分析タスク・フロー
分析タスク・フロー | 説明 |
---|---|
WebCenter Portalトラフィック |
ポータル内の一般的なイベントのサマリー・ビュー。 |
ページ・トラフィック |
ポータル内のページへのアクセス数と、いずれかのページにアクセスした一意のユーザー数が表示されます。 |
ログイン・メトリック |
ポータルへのログインについて報告されます。 |
ポートレット・トラフィック |
ポートレットの使用状況データが表示されます。 |
ポートレット・レスポンス時間 |
ポートレットのパフォーマンス・データが表示されます。 |
ポートレット・インスタンス・トラフィック |
ポートレット・インスタンスの使用状況データが表示されます。 同じポートレットが複数のページに表示される場合は、各配置がポートレット・インスタンスとして考慮されます。 |
ポートレット・インスタンス・レスポンス時間 |
ポートレット・インスタンスのパフォーマンス・データが表示されます。 |
検索メトリック |
ポータルの検索が追跡されます。 |
Wikiメトリック |
最も人気が高い/低いwikiが追跡されます。 |
ブログ・メトリック |
最も人気が高い/低いブログが追跡されます。 |
ディスカッション・メトリック |
最も人気が高い/低いディスカッションが追跡されます。 ノート: Oracle WebCenter Portalでは、Jive機能(お知らせおよびディスカッション)のサポートが非推奨となりました。リリース12c (12.2.1.4.0)より前のリリースからアップグレードした場合、アップグレードしたインスタンスでJive機能は使用可能なままですが、これらの機能にOracleサポートは提供されません。次のリリースでは、アップグレードしたインスタンスでもJive機能は使用できなくなります。 |
ポータル・トラフィック |
ポータルの使用状況データが表示されます。 |
ポータル・レスポンス時間 |
ポータルのページ・パフォーマンス・データが表示されます。 |
分析の構成ロードマップ
図7-2のフロー・チャートと表7-2のタスクは、WebCenter Portalで分析を動作させるための前提条件と必要なタスクの概要を示しています。
図7-2 WebCenter Portalで分析を使用するための構成
![WebCenter Portalに対する分析サービスの構成 WebCenter Portalに対する分析サービスの構成](img/wcadm_dt_016_flow_an_wcs.gif)
表7-2 WebCenter Portalで分析を使用するための構成
担当者 | タスク | リンク |
---|---|---|
管理者 |
1.Oracle WebCenter PortalおよびOracle WebCenter Portal Analytics Collectorコンポーネントをインストールします |
『Oracle WebCenter Portalのインストールと構成』の「Oracle WebCenter Portalのインストールについて」を参照してください |
管理者 |
2.(オプション)次のツールのいずれかを使用して、分析コレクタ設定を構成します。
|
「分析コレクタ設定の構成」を参照してください |
管理者 |
3.次のツールのいずれかを使用して、Oracle WebCenter Portalと分析コレクタ間の接続を構成します。
|
「アプリケーション用の分析コレクタの登録」を参照してください |
WebCenter Portal管理者 |
4.分析データがWebCenter Portalで使用可能なことをテストします
|
分析の前提条件
この項には次のトピックが含まれます:
分析 – インストール
分析コレクタはOracle WebCenter Portalのオプションのインストール・オプションです。この製品をインストールするには、Fusion Middleware構成ウィザードで「Oracle WebCenter Portal Analytics Collector」を選択します。インストール手順の詳細は、『Oracle WebCenter Portalのインストールと構成』の「Oracle WebCenter Portalのインストールについて」を参照してください。
分析スキーマ(ACTIVITIES
)とWebCenter Portalスキーマ(WEBCENTER
)は、同じデータベースにインストールすることも、別々のデータベースにインストールすることもできます。
分析 – 構成
分析コレクタは、インストールのデフォルトを使用して、初期設定でイベントを受信するように構成されています。デフォルト値がインストール環境に適さない場合や、クラスタを使用している場合は、WLSTまたはMBeanブラウザを使用して別の値を構成できます。詳細は、 「分析コレクタ設定の構成」を参照してください。
ただし、初期設定では、WebCenter Portalは、分析コレクタにイベントを送信するようには構成されていません。WebCenter Portalの使用状況とパフォーマンス・メトリックを収集する場合は、分析コレクタを登録してイベント収集を有効にする必要があります。詳細は、「アプリケーション用の分析コレクタの登録」を参照してください。接続されると、分析データが収集され、それ以上の構成なしに(分析タスク・フローを介して)アプリケーションに表示されます。
分析 – セキュリティに関する考慮事項
WebCenter Portalのリソース・カタログでは、適切な権限を持つユーザーにのみ分析タスク・フローが表示されます。
-
管理者 –
Administrator
ロールを持つユーザーはすべての分析タスク・フローにアクセスできます -
ポータル・マネージャ – 特定のポータル内で
Portal Manager
ロールを持つメンバーは、そのポータルの使用状況データを表示する分析タスク・フローにアクセスできます
分析の使用状況データは、ポータル分析には有益ですが、ポータル・ユーザーの個人データまたは機密データとみなされる場合があります。WebCenter Portalの管理者および個別のポータル・マネージャは、使用状況メトリックに関連するセキュリティとプライバシの権利を保護するために、ページのセキュリティを管理し、分析データを公開するページにアクセスできるユーザーを、指定された適切なユーザーのみに制限する必要があります。『Oracle WebCenter Portalでのポータルの構築』の分析についてに関する項を参照してください。
分析コレクタ設定の構成
分析コレクタは、インストール時に、次のデフォルト値を使用してイベントを受信するように構成されます。
-
コレクタ・ホスト名 - localhost
-
デフォルト・ポート - 31314
-
最大ポート番号 - 31314
-
ブロードキャスト・タイプ - ユニキャスト
-
クラスタリング - クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。
ノート:
WebCenter Portalで使用されているデータベースがAL16UTF16以外に設定されている各国語文字セットを使用する場合、分析起動リスナーは起動に失敗する可能性があります。「各国語文字セット」オプションは、データベースの作成時にDatabase Configuration Assistantで構成します。発生する可能性のある問題を回避するために、「各国語文字セット」の設定をデフォルト値AL16UTF16のままにすることをお薦めします。
これらのデフォルト値がインストール環境に適さない場合や、クラスタを使用している場合は、WLSTを使用するか、またはFusion Middleware ControlでMBeanブラウザを使用して、適切な値を構成できます。
これらの分析コレクタ構成設定は分析データベース(ACTIVITIES
)に格納されます。
WLSTを使用した分析コレクタ・プロパティの設定
WLSTコマンドのsetAnalyticsCollectorConfig
を使用して、分析コレクタのイベント収集プロパティを設定します。コマンドの構文と例は、『WebCenter WLSTコマンド・リファレンス』のsetAnalyticsCollectorConfigに関する項を参照してください。
ノート:
プロパティ値の使用を開始するには、分析コレクタ・アプリケーションがデプロイされている管理対象サーバー(WC_Portal
)を再起動する必要があります。
アプリケーション用の分析コレクタの登録
OpenUsage APIを使用してWebCenter Portalで発生したイベントを分析コレクタに送信できます。送信したイベントは、分析で使用されます。これらのツールが提供するいずれかの機能またはタスク・フローを使用する場合は、WebCenter Portalを分析コレクタに接続する必要があります。
WebCenter Portalに対して複数の分析コレクタ接続を登録できますが、使用される分析コレクタは1つ(つまり、デフォルト(またはアクティブな)接続)のみです。
新しい構成の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。
この項では、次の内容について説明します。
WLSTを使用した分析コレクタの登録
WLSTコマンドのcreateAnalyticsCollectorConnection
を使用して、WebCenter Portal用に分析コレクタ接続を作成します。既存の接続を更新するには、setAnalyticsCollectorConnection
を使用します。コマンドの構文と例は、『WebCenter WLSTコマンド・リファレンス』のcreateAnalyticsCollectorConnectionおよびsetAnalyticsCollectorConnectionに関する項を参照してください。
ノート:
新しい接続の使用を開始するには、isEnabled=1
およびdefault=1
であることを確認してから、WebCenter Portalがデプロイされている管理対象サーバーを再起動します。
WebCenter Portalイベント収集の無効化
OpenUsage APIによって生成されるイベントを収集しない場合は、イベント送信を一時的または永続的に停止できます。
この項では、次の内容について説明します。
WLSTを使用したWebCenter Portalイベント収集の無効化
WLSTを使用してイベントの収集を無効化するには、isEnabled
引数を0 (false)
に設定したsetAnalyticsCollectorConnection
コマンドを実行します。コマンドの構文と例は、『WebCenter WLSTコマンド・リファレンス』のsetAnalyticsCollectorConnectionに関する項を参照してください。
分析イベント収集の検証
- ロガー
com.plumtree.analytics
のログ・レベルをFINESTに設定します。 - この変更後、分析コレクタに到達するイベントはサービス・ログ・ファイル
[DOMAIN_HOME]/servers/WC_Portal/logs/analytics-collector/service.log
になります。イベント・メッセージは次のようなものです。[2021-02-26T02:27:44.327-08:00] [WC_Portal] [TRACE] [] [com.plumtree.analytics.collector.AnalyticsPmbListenerWrapper.eventDump] [tid: PMB Message Processor] [ecid: d7eccb85-4094-4782-9a7d-6c74f7d96574-00000095,0] [APP: analytics-collector] [partition-name: DOMAIN] [tenant-name: GLOBAL] [SRC_CLASS: com.plumtree.analytics.logging.Log] [SRC_METHOD: fine] Event = [[ EVENT_TYPE: {HTTP://WWW.ORACLE.COM/ANALYTICS/WC}LOGINS VERSION: 3.0.XXXX AS_DIMENSION_USER.USERID: monty CLIENT_IP.IP: 10.191.255.82 USER_AGENT.AGENT: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Firefox/78.0 APPLICATION.NAME: webcenter PROPERTY_VERSION: 3.0.XXXX REFERRER.URL: http://den00stq.us.oracle.com:8888/webcenter/system/welcome.jsp?wc.contentSource= SESSION_ID: 376590077 ]]
分析コレクタの構成情報を表示するには、次のURLを入力します。
http://hostname:WC_Portal
_port/collector
このページに表示される内容は次のとおりです。
-
コレクタのデフォルト・ポート
-
コレクタの最大ポート
-
コレクタのサーバー名
-
ブロードキャスト・タイプ
-
クラスタ有効
-
クラスタ名
-
パーティショニング有効
-
今年の時間ディメンション
-
スペース・ディメンションが存在(WebCenter Portalの場合)
現在のWebCenter Portalの分析イベント・リストの表示
分析コレクタが収集を行うよう構成されているイベントを表示するには、Fusion Middleware ControlでシステムMBeanブラウザを使用します。
分析イベントの現在のリストを表示するには:
または、WLSTコマンドlistAnalyticsEventTypes
を使用します。コマンドの構文と例は、『WebCenter WLSTコマンド・リファレンス』のlistAnalyticsEventTypesに関する項を参照してください。
分析データのパージ
分析データのパージの詳細は、『Oracle Fusion Middlewareの管理』のOracle WebCenter Portal分析データのパージに関する項を参照してください。
分析データのパーティション化
分析データのパーティション化の詳細は、『Oracle Fusion Middlewareの管理』のOracle WebCenter Portal分析データのパーティション化に関する項を参照してください。