EUM データ

このページでは、EUM データのタイプ、データの収集方法、データの保存場所、およびコントローラでのデータの表示場所について説明します。データの保持とライセンスの消費については、「2024-03-18_22-13-57_ライセンスの付与および制限事項」を参照してください。

警告: Splunk AppDynamics は、北朝鮮、スーダン、キューバ、イラン、シリア、ベラルーシ、ロシア、クリミア、ウクライナのドネツクおよびルハンスク地域からのすべての EUM トラフィックのフィルタリング(停止および拒否)を開始します。これは、2023 年 2 月 23 日に開始されます。ご質問やご不明な点がございましたら、アカウントマネージャ、カスタマー サクセス マネージャにお問い合わせいただくか、Splunk AppDynamics サポートにアクセスしてください。

Types of EUM Data

注: With the iOS 14 release (supported by iOS Agent 20.10.0), Apple introduced a new data collection policy. See iOS Data Collection Disclosure for details.

Metric Data

Metrics are data that reflect your application's performance. Browser RUM captures metrics from browser applications, such as timing and Ajax metrics. Mobile RUM captures metrics from mobile applications, such as crash metrics and network request metrics. You can view and analyze EUM metrics in the Metric Browser.

To learn more about EUM metrics, see:

Custom Data

Browser RUM

You can add specific user information from a browser snapshot of your application. The information is expressed as key-value pairs, appears in the User Data section of the snapshot, and is available for page snapshots, Ajax requests, and virtual pages. To learn how to set custom user data, see Add Custom User Data to a Page Browser Snapshot.

Mobile RUM

Mobile RUM custom data such as Info Points, Custom Timers, and Custom Metrics are considered metrics and stored as mobile request event data. User data is another type of Mobile RUM custom data. Custom user data can be reported through network request events because user data is attached to each network request.

To learn how to set user data, see User Data (iOS SDK) or User Data (Android SDK).

EUM Analytics Data

You can view EUM data in Analytics if you have a Real User Monitoring Peak license. The EUM Analytics data consists of event data and is stored in the Events Service and visualized in widgets. EUM Analytics provides data for these event types:

Cookies for Browser Applications

Browser RUM uses two different kinds of short-lived cookies for the JavaScript Agent to collect data and correlate events. Both types of cookies do not contain any personally identifiable information (PII) and are immediately deleted after being read.

  • ADRUM cookie: Written by the JavaScript Agent, this cookie contains the referral page URL and some timing information to assist in gathering First Byte Time for some browser types. When the agent loads on the subsequent page, it reads the information and then deletes the cookie. If there is no agent on that page, the cookie is deleted when the browser is closed. For privacy purposes, the URL of the referral page is hashed.
  • ADRUM_BT cookies: Written by the server-side agent when the page is served from an instrumented server. These cookies help correlate browser data with related server-side performance data (Business Transactions).
    • ADRUM_BTa : Contains the backend transaction ID as well as timing info and is used to correlates end-user experience with the health of the backend app.
    • ADRUM_BTg : Contains the backend transaction ID and is used as an alternative method to correlate end-user experience with the health of the backend app.
    • ADRUM_BT[1-5] : Contains the business transaction numbers as well as timing and error info for the first five business transactions, such as ADRUM_BT1 , ADRUM_BT2 , etc.
    • ADRUM_BTs : Contains a link from a browser snapshot to a server snapshot.
    • ADRUM_BTh

      注: If Browser RUM detects that the page is HTTPS, the Security attribute is set for cookies. The Security attribute is a flag that forbids a cookie from being transmitted via an unencrypted HTTP connection.
  • SameSite cookies: Provides the JavaScript Agent access to ADRUM_BT cookie to maintain Business Transaction correlation. When SameSite cookies are present, the agent has access to the ADRUM_BT cookie with Business Transaction data. Without SameSite cookies, the agent cannot parse Business Transaction data in the cookie sent from the application server. This is because the agent is loaded from a different domain than the browser website.

Web Storage

Browser RUM stores key-value pairs in web storage to associate page views with a particular session and browser. The value for each key is a randomly generated ID.

The following lists the keys and the expiration time for each key-value pair:

  • ADRUM_AGENT_INFO (never)
  • ADRUM_CLIENTINFO (never)
  • ADRUM_XD_AGENT_ID (never)
  • ADRUM_XD_AGENT_INFO (1 week)

Mobile Local Storage

Mobile agents use beacons to transmit metrics, app metadata, network requests, crashes, and custom data. When a beacon cannot be transmitted, the data is persisted in permanent storage within the container of the application and subject to the security configuration of the device and application. No encryption is currently being utilized. Once the network connection is restored, the beacons resume transmitting data. Because some of the data is provided by the developer's instrumentation of the app, such as breadcrumbs, user info, and the app (URLs, crash reports), some information is not explicitly collected by Splunk AppDynamics.

Mobile agents also locally store a randomly generated ID for tracking sessions and license usage. The ID is stored in the Events Service.

データの保存と取得

Splunk AppDynamics は、EUM サーバー、イベントサービス、メトリックサービス、およびコントローラの 4 つのデータ ストレージ コンポーネントを使用してブラウザ RUM およびモバイル RUM データを保存します。コントローラ UI はコントローラ API とのみやり取りするため、どのストレージコンポーネントがデータを保持しているかは表示しません。

ブラウザ RUM は JavaScript エージェントを使用し、モバイル RUM はモバイルエージェントを使用して raw データを EUM サーバーに送信します。 EUM サーバは、データを 1 分ごとに検証、集約、およびパッケージ化します。 EUM サーバーはデータをイベントサービスに送信し、コントローラに を送信します。 コントローラは、メトリックサービスにデータを送信します。 コントローラ API は、4 つのデータストアのいずれかからデータを取得し、 コントローラ UI がデータ要求を受信すると が配信します。

データストレージの詳細

ブラウザ RUM

次の表に、さまざまなブラウザ RUM データが格納されている場所を示します。データの保持期間を確認するには、「ライセンスの付与および制限事項」を参照してください。リソースの詳細は、リソースタイミングがあるブラウザスナップショットでのみ使用できます。

SaaS コントローラ 4.5.11 以降。 イベントサービス EUM サーバ(SaaS/オンプレミス)
ブラウザメトリック
ブラウザスナップショット
リソースの詳細 ✓(filesystem)
EUM ページ設定 ✓(filesystem)
ページビューイベント
Ajax イベント
セッションイベント
メタデータ ✓(MySQL)
ライセンス(SaaS) ✓(MySQL)
ライセンス(オンプレミス) ✓(MySQL)

アプリケーションキーごとのブラウザ RUM のデフォルトデータ制限

  • メトリック:10 万

  • ページ:500

  • Ajax リクエスト:500
  • 最大イベントサイズ:1 MB

モバイルRUM

次の表に、さまざまなモバイル RUM データが格納されている場所を示します。データの保持期間を確認するには、「ライセンスの付与および制限事項」を参照してください。

SaaS コントローラ 4.5.11 以降。 イベントサービス EUM サーバ(SaaS/オンプレミス)
モバイル RUM のメトリック
ネットワーク リクエスト スナップショット
カスタム データ
クラッシュ分析 ✓(filesystem)
イベント
セッションイベント
メタデータ ✓(MySQL)

ProGuard/dSYM ファイル

✓(filesystem)
スクリーンショットファイル ✓(SaaS の場合は S3、オンプレミスの場合はファイルシステム)
ライセンス(SaaS) ✓(MySQL)
ライセンス(オンプレミス) ✓(MySQL)

モバイルアプリケーションとアプリケーションキーごとのモバイル RUM のデフォルトデータ制限

ユニット(Units) メトリックの制限 ネットワーク要求 最大イベントサイズ
モバイル アプリケーション N/A 500 1 MB
アプリケーションキー 100,000 2000

データのコントローラマッピング

ブラウザ RUM

次の表に、コントローラ UI コンポーネントとそのデータソースとの関係を示します。

コントローラコンポーネント ストレージメカニズム
概要 SaaS コントローラ 4.5.11 以降。
Geo ダッシュボード SaaS コントローラ 4.5.11 以降。
ブラウザスナップショット コントローラ(リソースの詳細なし)/ EUM サーバ(SaaS/オンプレミス)(リソースの詳細)
使用状況統計 SaaS コントローラ 4.5.11 以降。
セッション EUM サーバ(SaaS/オンプレミス)、イベントサービス
ページおよび AJAX リクエスト コントローラ/イベントサービス(制限)
[分析(Analyze)] イベントサービス

モバイルRUM

次の表に、コントローラ UI コンポーネントとそのデータソースとの関係を示します。

コントローラコンポーネント ストレージメカニズム
概要 SaaS コントローラ 4.5.11 以降。
Geo ダッシュボード SaaS コントローラ 4.5.11 以降。
使用状況統計 SaaS コントローラ 4.5.11 以降。
セッション イベントサービス
ネットワーク要求 コントローラ、イベントサービス(制限)
ネットワーク リクエスト スナップショット SaaS コントローラ 4.5.11 以降。
クラッシュ イベントサービス、EUM サーバ(SaaS/オンプレミス)
クラッシュ分析 イベントサービス
カスタム データ SaaS コントローラ 4.5.11 以降。
イベント SaaS コントローラ 4.5.11 以降。

EUM データへのアクセス

コントローラ UI を介して EUM データにアクセスする方法に加えて、分析およびSplunk AppDynamics API を使用してイベントデータにアクセスすることもできます。Splunk AppDynamics API には、EUM メトリックデータにアクセスするために使用できる 分析イベント API および メトリックとスナップショット API が含まれています。

分析およびブラウザ RUM を有効にしている場合は、ブラウザ分析を使用して次のイベントタイプのデータを表示できます。

分析およびブラウザ合成モニタリングを有効にしている場合は、合成分析を使用して次のイベントタイプのデータを表示できます。

分析およびモバイル RUM を有効にしている場合は、モバイル分析を使用して次のイベントタイプのデータを表示できます。

IoT モニタリングを有効にしている場合は、コネクテッドデバイス分析を使用して以下のイベントタイプのデータを表示できます。IoT 分析を使用するために分析を有効にする必要はありません

データおよび導入モデル

Splunk AppDynamics は、SaaS とオンプレミスの導入モデルを提供しています。いずれの導入モデルからでもほとんどのブラウザおよびモバイル RUM データにアクセスできます。