AEM as a Cloud Service の運用テレメトリサービス real-use-monitoring-service-for-aem-as-a-cloud-service

NOTE
クライアントサイドのデータ収集である運用テレメトリサービスは、自動化されたサービスです。お客様による設定は必要ありません。
INFO
クライアントサイドモニタリングは、AEM(Adobe Experience Manager)Cloud Service バージョン 2024.5.16461 以降を使用しているお客様に対してのみ機能します。

概要 overview

運用テレメトリサービスは、web サイトまたはアプリケーションのクライアントサイドトラフィックをリアルタイムで監視するパフォーマンスモニタリングテクノロジーです。このサービスは、ユーザー自身ではなく、web サイトのエンゲージメントを監視することで、パフォーマンスを最適化する重要な指標とデータを収集することに焦点を当てています。運用テレメトリを使用すると、URL の開始からリクエストがブラウザーに返されるまで、主要なパフォーマンス指標が追跡されます。

運用テレメトリサービスのメリットを享受できるユーザー who-can-benefit-from-operational-telemetry-service

運用テレメトリは、エンドユーザーが AEM サイトでどのようなやり取りを行っているかをお客様とアドビが理解するのに役立ちます。運用テレメトリは、限定的なデータ収集とサンプリングを通じて訪問者のプライバシーを保護します。つまり、すべてのページビューのうちのごく一部のみが監視されます。

運用テレメトリサービスのデータサンプリング operational-telemetry-service-data-sampling

従来の web 分析ソリューションでは、すべての訪問者に関するデータを収集しようとします。AEM の運用テレメトリサービスでは、ページビューのごく一部からの情報のみをキャプチャします。サービスは、分析の代替ではなく、サンプリングと匿名化を目的としています。デフォルトでは、ページのサンプリングレートは 1:100 です。現時点では、サイトオペレーターはサンプリングレートを増減できません。合計トラフィックを正確に推定するには、100 ページビューのうち 1 ページからのデータを収集し、全体のトラフィックの信頼できる近似値を提供します。

データが収集されるかどうかはページビューごとに決定されるので、複数のページ間のやり取りを追跡することは事実上不可能になります。運用テレメトリには、訪問者またはセッションの概念がなく、ページビューのみが含まれる設計となっています。

収集されるデータ what-data-is-being-collected

運用テレメトリサービスは、データ収集を最小限に抑えるように設計されています。運用テレメトリで収集される完全な情報セットを以下に示します。

  • 訪問しているサイトのホスト名(例:experienceleague.adobe.com
  • desktop:windowsmobile:ios など、ページの表示に使用される幅広いユーザーエージェントタイプとオペレーティングシステム
  • 2021-06-26 06:00:02.596000 UTC (in order to preserve privacy, we round all minutes to the previous hour, so that only seconds and milliseconds are tracked) など、データ収集の時間
  • 訪問しているページの URL(例:https://experienceleague.adobe.com/docs?lang=ja
  • リファラー URL(ユーザーがリンクをたどった場合、現在のページにリンクしているページの URL)
  • 2Ac6 のような形式で、ランダムに生成されたページビューの ID
  • 100 など、サンプリングレートの重み付けまたはその逆つまり、100 ページビューのうち 1 つしか記録されません。
  • チェックポイント(ページの読み込みシーケンスまたは訪問者としてのページとのやり取りのシーケンスにおける特定のイベントの名前)。
  • ソース(上記のチェックポイントでユーザーがやり取りする DOM 要素の識別子)。例えば、これは画像の可能性があります
  • ターゲット(上記のチェックポイントでユーザーがやり取りする外部ページまたはリソースへのリンク)。例:https://blog.adobe.com/jp/publish/2022/06/29/media_162fb947c7219d0537cce36adf22315d64fb86e94.png
  • 訪問者のエクスペリエンスの質を表すコア web バイタル(CWV)パフォーマンス指標、最大コンテンツの描画(LCP)次のペイントまでのインタラクション(INP)および累積レイアウトシフト(CLS)

お客様に対する運用テレメトリの仕組み how-operational-telemetry-works-for-a-customer

運用テレメトリは、クライアントサイドトラフィックを自動的に監視します。 アドビのお客様の場合、このサービスは既存の設定にシームレスに統合されるので、追加の手順を実行する必要はありません。運用テレメトリサービスが一般提供されると、この新しい機能のメリットが自動的に得られます。運用テレメトリサービスでは、現在、監視対象となるお客様向けの指標は公開されていません。アドビでは、この機能をできる限り早くお客様に提供できるように取り組んでいます。

アドビでの運用テレメトリの使用方法 how-operational-telemetry-data-is-being-used

運用テレメトリデータは、次の目的で使用されます。

  • お客様のサイトに対してパフォーマンスのボトルネックを特定および修正する
  • 互換性を高めることを目的に、AEM が同じページ上の他のスクリプト(分析、ターゲティング、外部ライブラリなど)とやり取りする方法を理解する

よくある質問 faq

  1. 「次のペイントまでのインタラクション(INP)」、「最初のバイトまでの時間(TTFB)」および「コンテンツの初回ペイント(FCP)」の指標を収集していますか?

    次のペイントまでのインタラクション(INP)と最初のバイトまでの時間(TTFB)を収集します。現時点では、コンテンツの初回ペイント(FCP)は収集しません。

  2. /.rum パスがサイトでブロックされています。どうすれば修正できますか?

    /.rum パスは、運用テレメトリ収集が機能するのに必要です。アドビの AEM as a Cloud Service の前で CDN を使用する場合は、/.rum パスが他の AEM コンテンツと同じ AEM 接触チャネルに転送されるようにします。また、どのような場合においても調整されないようにしてください。または、値 trueAEM_OPTEL_EXTERNAL という環境変数を Cloud Manager で設定することで、運用テレメトリに使用するホストを rum.hlx.page に変更できます。後で同じドメインリクエストに戻す場合は、その環境変数を再度削除するだけです。

  3. 運用テレメトリコレクションは、契約上の目的でコンテンツリクエストにカウントされますか?

    運用テレメトリライブラリと運用テレメトリコレクションはコンテンツリクエストとしてカウントされず、レポートされるページビュー数や API 呼び出し数は増加しません。さらに、AEM as a Cloud Service で標準の CDN を使用するお客様の場合、サーバーサイドのコレクションがコンテンツリクエストの基本となります。

  4. 運用テレメトリを無効にするにはどうすればよいですか?

    アドビでは、運用テレメトリの使用をお勧めします。これは、運用テレメトリには大きなメリットがあり、web サイトのパフォーマンスを改善することでデジタルエクスペリエンスを最適化できるようになるからです。このサービスは、シームレスに設計され、web サイトのパフォーマンスに影響を与えません。

    オプトアウトすると、web サイトのトラフィックエンゲージメントを向上させる機会を逃す可能性があります。ただし、問題が発生した場合は、値 trueAEM_OPTEL_DISABLED という環境変数を Cloud Manager で設定することで、運用テレメトリを無効にすることができます。後で運用テレメトリを再度有効にする場合は、その環境変数を再度削除するだけです。

  5. コンテンツセキュリティポリシーを Nonce で使用できますか?

    運用上のテレメトリのサポートには、コンテンツセキュリティポリシーを nonce でサポートする実験的機能が含まれています。 この機能を有効にするには、 という名前のCloud Managerの環境変数を AEM_OPTEL_NONCEtrue に設定します。 後で再度無効にする場合は、その環境変数を再度削除します。

    この機能で問題が発生した場合は、Adobe サポートにお問い合わせください。

  6. 特定のページに対してのみ運用上のテレメトリを有効にするにはどうすればよいですか?

    デフォルトでは、運用上のテレメトリは、リポジトリの /content フォルダーの下にあるすべてのページに対して有効になっています。 という名前のCloud Managerの環境変数を設定 AEM_OPTEL_INCLUDED_PATHS して、リポジトリ内のコンマ区切りのパスのリストを追加すると、オペレーショナルテレメトリはそれらのページに対してのみ有効になります。 さらに、除外するリポジトリ内のパスのリストに AEM_OPTEL_EXCLUDED_PATHS を設定できます。 これらの 2 つの設定の組み合わせにより、運用上のテレメトリを含めるかどうかを、要件に合わせて調整できます。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab