Troubleshooting
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

データソースのトラブルシューティング

環境やデータソースが誤って設定されていると、Liferay DXPのデータソースへのアクセスを妨げたり、中断させたりすることがあります。 ここでは、DXPデータソースの問題をトラブルシューティングする方法をご紹介します。

Analytics Cloudへのネットワークアクセスがない

次のURLを許可リストに追加して、DXPのインストールで弊社のAnalytics Cloudサーバーへのインターネットアクセスが可能であることを確認してください。

  • https://analytics.liferay.com
  • https://osbasahpublisher-{regionKey}.lfr.cloud
  • https://osbasahbackend-{regionKey}.lfr.cloud
  • https://analytics-js-cdn.liferay.com

{regionKey} は、ワークスペースのセットアップ時の初期選択 (ac-southamericaeast1、ac-europewest2、ac-europewest3、ac-uswest1、または ac-asiasouth1) に基づいています。

重要

企業のイントラネットの使用状況を分析するなどの一部のユースケースでは、訪問者のブラウザもファイアウォールの背後にあります。 このシナリオでは、企業のオフィスネットワークが上記のURLのアウトバウンドアクセスも許可していることを確認する必要があります。

Analytics Cloudへの接続を検証する

データがAnalytics Cloudに送信されているかどうかを検証するのに役立つヒントをご紹介します。

アナリティクスのイベント

アナリティクスのイベントは、クライアントのブラウザから直接送信されます。 データがAnalytics Cloudに送信されていることを確認するには、次の手順を実行します。

  1. 追跡されているDXPのWebサイトのページをご覧ください。

  2. ブラウザのインスペクタを開き、[ネットワーク]タブに移動します。

  3. ネットワーク タブを XHR でフィルタリングします。

  4. ページを更新します。

  5. osbasahpublisherから始まるリクエストが出ていることを確認します。 リクエストは以下のスクリーンショットのようなものになります。

    Analytics Cloudへの接続を検証します。

    このリクエストが表示される場合、Web サイトは分析データを Analytics Cloud ワークスペースに送信しています。 リクエストペイロードをチェックして、 channelIdという変数があることを確認してください。

連絡先データ

DXP は、ログインしたユーザーの連絡先情報を個別のプロファイル データとして Analytics Cloud に送信します。 このデータはDXPサーバーから直接送信されます。

連絡先データが送信されていることを確認するには、DXP サーバー ログで次のようなメッセージを確認します。

INFO  [liferay/analytics_messages_processor-1][AddAnalyticsMessagesMessageListener:70] Added 500 analytics messages

INFO  [liferay/analytics_messages_processor-1][AddAnalyticsMessagesMessageListener:70] Added 500 analytics messages

INFO  [liferay/scheduler_dispatch-3][SendAnalyticsMessagesMessageListener:149] Sent 100 analytics messages

INFO  [liferay/scheduler_dispatch-3][SendAnalyticsMessagesMessageListener:164] Deleted 100 analytics messages

これらのサーバーログが表示されている場合は、連絡先データが正常にACに送信されていることを示しています。

データ処理時間

データが Analytics Cloud に到着すると、ワークスペース ダッシュボードに表示される前に、処理にさらに時間がかかります。

アナリティクス イベントの場合は、サイト ダッシュボードの 24 時間フィルターの訪問者メトリクスを 10 分から 15 分以内に表示できるようにする必要があります。

アナリティクス データが一定期間で入ってくる。

セッション期間や直帰率などのその他のセッション関連データは、訪問者のセッションが終了するまで待機する必要があります。 訪問者のセッションは、非アクティブな状態が 30 分間続いた場合、または 00:00:00 UTC – のいずれか早い方に達した時点で終了したとみなされます。

訪問者プロフィールは、処理に時間がかかり、時間の経過とともに利用可能になります。

サポート対象外のバージョン

エラー メッセージ: サポートされていないバージョンです。 この接続方法は、データソースのLiferayバージョンをサポートしていません。 Liferay 7.0/7.1インスタンスに接続していることを確認するか、別の接続方法を試してみてください。

重要

Liferay DXPのインストールは、以下のフィックスパックの最小要件を満たしている必要があります:

  • 7.4 2024年第1四半期以降
  • 7.3 U30+ (修正プログラムが必要)

解決策:

  1. [Liferay DXP 7.3 または 7.4 インスタンスと接続] していることを確認してください。

  2. Liferay DXPデータソースを追加するの手順に従います。

  3. エラーが続く場合は、DXPインスタンスでJSONウェブサービスが有効になっていることを確認してください。 デフォルトで有効になっています。 ポータル プロパティ 設定 json.web.service.enabled=false (たとえば、 portal-ext.properties ファイルで設定) を使用して無効にした場合は、設定を削除するか、プロパティ値を true に設定します。

ログインしているユーザーが匿名で表示される

連絡先を同期する場合、Analytics Cloud は Liferay DXP 内に存在するユーザーレコードに依存します。 したがって、 SSO または LDAPを使用している場合は、連絡先を Analytics Cloud と同期する前に、すべてのユーザーを Liferay DXP にインポートまたはマッピングしてください。

ユーザーの同期に時間がかかる

Liferay DXP のバッチ エンジンは、ユーザーの同期に使用されます。 多数のユーザーを同期する場合はバッチ サイズを増やします。 Liferay DXPで、 グローバルメニューインスタンス設定バッチエンジンに移動します。 エクスポート バッチ サイズインポート バッチ サイズ1000に設定します。

Liferay DXP でバッチ サイズを増やします。

サイトページのローカライズされた URL を有効にする

デフォルトでは、Liferay DXP は、選択した言語に関係なく、サイト ページに同じ URL を使用します。 Analytics Cloud のローカライズされた URL を有効にして、各言語を個別のサイト ページとして追跡します。

  1. Liferay DXPで、 コントロールパネルインスタンス設定コンテンツ & データページに移動します。

  2. 左側のナビゲーションで SEO をクリックします。

    正規 URL の選択で、ローカライズされた URL の使用を選択します。

  3. 正規 URL の下のドロップダウン メニューをクリックし、 ローカライズされた URL を使用するを選択します。 [保存]をクリックします。