RUM Android の高度なコンフィギュレーション

Docs > RUM & セッションリプレイ > モバイルおよび TV モニタリング > 高度な構成 > RUM Android の高度なコンフィギュレーション

概要

まだ SDK をインストールしていない場合は、アプリ内セットアップ手順に従うか、Android RUM セットアップドキュメントを参照してください。

ユーザーセッションの充実

Android RUM は、ユーザーアクティビティ、画面、エラー、ネットワークリクエストなどの属性を自動的に追跡します。RUM イベントおよびデフォルト属性については、RUM データ収集ドキュメントをご参照ください。カスタムイベントを追跡することで、ユーザーセッション情報を充実させ、収集された属性をより細かく制御することが可能になります。

カスタムビュー

ビューを自動追跡するほかに、特定のさまざまなビュー（アクティビティやフラグメントなど）が onResume() ライフサイクルでインタラクティブに確認できるようになったら自動追跡することも可能です。ビューが確認できなくなったら追跡を停止します。ほとんどの場合、このメソッドは、最前面の Activity または Fragment で呼び出す必要があります。

    fun onResume() {
      GlobalRumMonitor.get().startView(viewKey, viewName, viewAttributes)
    }

    fun onPause() {
      GlobalRumMonitor.get().stopView(viewKey, viewAttributes)
    }

    public void onResume() {
         GlobalRumMonitor.get().startView(viewKey, viewName, viewAttributes);
    }

    public void onPause() {
         GlobalRumMonitor.get().stopView(viewKey, viewAttributes);
    }

独自のパフォーマンスタイミングを追加

RUM のデフォルト属性に加えて、addTiming API を使用して、アプリケーションが時間を費やしている場所を測定できます。タイミング測定は、現在の RUM ビューの開始を基準にしています。たとえば、ヒーロー画像が表示されるまでにかかる時間を計ることができます。

   fun onHeroImageLoaded() {
         GlobalRumMonitor.get().addTiming("hero_image")
   }

    public void onHeroImageLoaded() {
         GlobalRumMonitor.get().addTiming("hero_image");
    }

タイミングが送信されると、タイミングは @view.custom_timings.<timing_name> としてアクセス可能になります (例: @view.custom_timings.hero_image)。RUM 分析またはダッシュボードでグラフを作成する前に、メジャーを作成する必要があります。

カスタムアクション

アクションを自動追跡するほかに、RumMonitor#addAction で特定のカスタムユーザーアクション (タップ、クリック、スクロールなど) を追跡することも可能です。継続的なアクションの追跡 (リストをスクロールするユーザーの追跡) には、RumMonitor#startAction および RumMonitor#stopAction を使用します。

アクションタイプは、“カスタム”、“クリック”、“タップ”、“スクロール”、“スワイプ”、“戻る” のいずれかを指定する必要があることに注意してください。

    fun onUserInteraction() { 
         GlobalRumMonitor.get().addAction(actionType, name, actionAttributes)
    }

    public void onUserInteraction() {
         GlobalRumMonitor.get().addAction(actionType, name, actionAttributes);
    }

リソースの強化

リソースを自動的に追跡する場合、追跡する各ネットワークリクエストにカスタム属性を追加するために、カスタムの RumResourceAttributesProvider インスタンスを提供します。例えば、ネットワークリクエストのヘッダを追跡したい場合は、以下のような実装を作成し、DatadogInterceptor のコンストラクタに渡します。

class CustomRumResourceAttributesProvider : RumResourceAttributesProvider {
    override fun onProvideAttributes(
        request: Request,
        response: Response?,
        throwable: Throwable?
    ): Map<String, Any?> {
        val headers = request.headers
        return headers.names().associate {
            "headers.${it.lowercase(Locale.US)}" to headers.values(it).first()
        }
    }
}

public class CustomRumResourceAttributesProvider implements RumResourceAttributesProvider {
    @NonNull
    @Override
    public Map<String, Object> onProvideAttributes(
            @NonNull Request request,
            @Nullable Response response,
            @Nullable Throwable throwable
    ) {
        Map<String, Object> result = new HashMap<>();
        Headers headers = request.headers();

        for (String key : headers.names()) {
            String attrName = "headers." + key.toLowerCase(Locale.US);
            result.put(attrName, headers.values(key).get(0));
        }

        return result;
    }
}

カスタムリソース

リソースを自動追跡するほかに、メソッド（GET や POST など）を使用して、RumMonitor#startResource でリソースを読み込みながら特定のカスタムリソース（ネットワークリクエストやサードパーティプロバイダ API など）を追跡することも可能です。完全に読み込まれたら RumMonitor#stopResource で追跡を停止し、リソースの読み込み中にエラーが発生した場合は RumMonitor#stopResourceWithError で停止します。

    fun loadResource() {
         GlobalRumMonitor.get().startResource(resourceKey, method, url, resourceAttributes)
         try {
           // リソースをロードします
           GlobalRumMonitor.get().stopResource(resourceKey, resourceKind, additionalAttributes)
         } catch (e: Exception) {
           GlobalRumMonitor.get().stopResourceWithError(resourceKey, message, origin, e)
         } 
    }

    public void loadResource() {
         GlobalRumMonitor.get().startResource(resourceKey, method, url, resourceAttributes);
         try {
             // リソースをロードします
             GlobalRumMonitor.get().stopResource(resourceKey, resourceKind, additionalAttributes);
         } catch (Exception e) {
             GlobalRumMonitor.get().stopResourceWithError(resourceKey, message, origin, e);
         }
    }

カスタムエラー

特定のエラーを追跡するには、エラーが発生したときにメッセージ、ソース、例外、追加属性でモニターに通知します。エラー属性ドキュメントをご参照ください。

   GlobalRumMonitor.get().addError(message, source, throwable, attributes)

カスタムグローバル属性の追跡

RUM Android SDK により自動的に取得されるデフォルトの RUM 属性に加えて、カスタム属性などのコンテキスト情報を RUM イベントに追加し、Datadog 内の可観測性を強化することも可能です。カスタム属性により、コードレベルの情報（バックエンドサービス、セッションタイムライン、エラーログ、ネットワークの状態など）を利用して、観察されたユーザー行動（カート内の金額、マーチャントティア、広告キャンペーンなど）を分類することができます。

ユーザーセッションの追跡

RUM セッションにユーザー情報を追加すると、次のことが簡単になります。

特定のユーザーのジャーニーをたどる
エラーの影響を最も受けているユーザーを把握する
最も重要なユーザーのパフォーマンスを監視する

以下の属性は任意で、少なくとも 1 つ提供する必要があります。

属性	タイプ	説明
usr.id	文字列	一意のユーザー識別子。
usr.name	文字列	RUM UI にデフォルトで表示されるユーザーフレンドリーな名前。
usr.email	文字列	ユーザー名が存在しない場合に RUM UI に表示されるユーザーのメール。Gravatar をフェッチするためにも使用されます。

ユーザーセッションを識別するには、setUserInfo API を使用します。例:

Datadog.setUserInfo('1234', 'John Doe', 'john@doe.com')

属性の追跡

    // Adds an attribute to all future RUM events
    GlobalRumMonitor.get().addAttribute(key, value)

    // Removes an attribute to all future RUM events
    GlobalRumMonitor.get().removeAttribute(key)

ウィジェットの追跡

ウィジェットは、SDK で自動的に追跡されません。ウィジェットから手動で UI インタラクションを送信するには、Datadog API を呼び出します。例をご参照ください。

初期化パラメーター

ライブラリを初期化するよう Datadog のコンフィギュレーションを作成する際、Configuration.Builder で以下のメソッドを使用できます。

setFirstPartyHosts(): Defines hosts that have tracing enabled and have RUM resources categorized as first-party. Note: If you define custom tracing header types in the Datadog configuration and are using a tracer registered with GlobalTracer, make sure the same tracing header types are set for the tracer in use.
useSite(DatadogSite): ターゲットデータを EU1、US1、US3、US5、US1_FED、および AP1 のサイトに切り替えます。

RUM を有効にするよう RUM 構成を作成する際、RumConfiguration.Builder で以下のメソッドを使用できます。

trackUserInteractions(Array<ViewAttributesProvider>): ユーザーインタラクション (タップ、スクロール、スワイプなど) の追跡を有効にします。このパラメーターを使用すると、ユーザーが操作したウィジェットに基づいて、カスタム属性を RUM アクションイベントに追加できます。
useViewTrackingStrategy(strategy): ビューの追跡に使用される戦略を定義します。ご使用のアプリケーションのアーキテクチャにより、ViewTrackingStrategy の実装から 1 つを選択するか、独自のものを実装します。
trackLongTasks(durationThreshold): メインスレッドで durationThreshold より時間がかかっているタスクを Datadog でロングタスクとして追跡できます。
setBatchSize([SMALL|MEDIUM|LARGE]): Datadog に送信されるリクエストの個別のバッチサイズを定義します。
setUploadFrequency([FREQUENT|AVERAGE|RARE]): Datadog エンドポイントに対し作成されたリクエストの頻度を定義します (リクエストがある場合)。
setVitalsUpdateFrequency([FREQUENT|AVERAGE|RARE|NEVER]): モバイルバイタルを収集するための好ましい頻度を設定します。
setSessionSampleRate(<sampleRate>): RUM セッションのサンプルレートを設定します (0 の値は RUM イベントが送信されないことを意味し、100 の値はすべてのセッションが保持されることを意味します)。
setXxxEventMapper(): ビュー、アクション、リソース、エラーのデータスクラビングコールバックを設定します。

ビューの自動追跡

ビュー (アクティビティやフラグメントなど) を自動追跡するには、初期化時に追跡ストラテジーを提供する必要があります。ご使用のアプリケーションのアーキテクチャにより、以下のストラテジーから 1 つ選択します。

ActivityViewTrackingStrategy: アプリケーションの各アクティビティが個別のビューとみなされます。
FragmentViewTrackingStrategy: アプリケーションの各フラグメントが個別のビューとみなされます。
MixedViewTrackingStrategy: すべてのアクティビティまたはフラグメントが個別のビューとみなされます。
NavigationViewTrackingStrategy: Android Jetpack Navigation ライブラリのユーザーに推奨。各ナビゲーション先が個別のビューとみなされます。

たとえば、各フラグメントを個別のビューとして設定するには、セットアップで以下の構成を使用します。

    val rumConfig = RumConfiguration.Builder(applicationId)
     .useViewTrackingStrategy(FragmentViewTrackingStrategy(...))
     .build()

    RumConfiguration rumConfig = new RumConfiguration.Builder(applicationId)
     .useViewTrackingStrategy(new FragmentViewTrackingStrategy(...))
     .build();

ActivityViewTrackingStrategy、FragmentViewTrackingStrategy、MixedViewTrackingStrategy のいずれかを使用する場合、コンストラクターで ComponentPredicate の実装を提供することで、RUM View として追跡する Fragment または Activity を絞り込むことができます。

    val rumConfig = RumConfiguration.Builder(applicationId)
     .useViewTrackingStrategy(
     ActivityViewTrackingStrategy(
         trackExtras = true,
         componentPredicate = object : ComponentPredicate<Activity> {
             override fun accept(component: Activity): Boolean {
                 return true
             }

             override fun getViewName(component: Activity): String? = null
         })
     )
     .build()

     RumConfiguration rumConfig = new RumConfiguration.Builder(applicationId)
         .useViewTrackingStrategy(new ActivityViewTrackingStrategy(
             true,
             new ComponentPredicate<Activity>() {
                 @Override
                 public boolean accept(Activity component) {
                     return true;
                 }

                 @Override
                 public String getViewName(Activity component) {
                     return null;
                 }
             }
         ))
         .build();

注: デフォルトで、ライブラリは ActivityViewTrackingStrategy を使用しています。ビューの追跡ストラテジーを提供しないことにした場合は、自身で startView および stopView メソッドを呼び出してビューを手動で送信する必要があります。

ネットワークリクエストの自動追跡

リソース (サードパーティプロバイダー、ネットワークリクエストなど) で、最初の 1 バイトまで、または DNS 解決などのタイミング情報を取得するには、OkHttpClient をカスタマイズして EventListener ファクトリーを追加します。

モジュールレベルの build.gradle ファイルで、dd-sdk-android-okhttp ライブラリに Gradle 依存関係を追加します。
```
dependencies {
    implementation "com.datadoghq:dd-sdk-android-okhttp:x.x.x"
}
```
EventListener ファクトリーの追加

    val okHttpClient = OkHttpClient.Builder()
     .addInterceptor(DatadogInterceptor())
     .eventListenerFactory(DatadogEventListener.Factory())
     .build()

    OkHttpClient okHttpClient = new OkHttpClient.Builder()
     .addInterceptor(new DatadogInterceptor())
     .eventListenerFactory(new DatadogEventListener.Factory())
     .build();

ロングタスクの自動追跡

メインスレッドで長時間実行されるオペレーションは、アプリケーションの視覚的パフォーマンスとリアクティビティに影響を与えることがあります。このようなオペレーションを追跡するには、タスクを長すぎるとみなすための閾値を定義します。

    val rumConfig = RumConfiguration.Builder(applicationId)
     // ...
     .trackLongTasks(durationThreshold)
     .build()

たとえば、デフォルトの 100 ms の実行時間を置換するため、コンフィギュレーションでカスタム閾値を設定します。

   val rumConfig = RumConfiguration.Builder(applicationId)
     // ...
     .trackLongTasks(250L) // track tasks longer than 250ms as long tasks
     .build()

    RumConfiguration rumConfig = new RumConfiguration.Builder(applicationId)
      // ...
      .trackLongTasks(durationThreshold)
      .build();

たとえば、デフォルトの 100 ms の実行時間を置換するため、コンフィギュレーションでカスタム閾値を設定します。

   RumConfiguration rumConfig = new RumConfiguration.Builder(applicationId)
     // ...
     .trackLongTasks(250L) // track tasks longer than 250ms as long tasks
     .build();

RUM イベントの変更または削除

一括処理前に、RUM イベントの一部の属性を変更または一部のイベント全体を削除したりするには、RUM Android SDK を初期化する際に EventMapper<T> を実装します。

    val rumConfig = RumConfiguration.Builder(applicationId)
     // ...
     .setErrorEventMapper(rumErrorEventMapper)
     .setActionEventMapper(rumActionEventMapper)
     .setResourceEventMapper(rumResourceEventMapper)
     .setViewEventMapper(rumViewEventMapper)
     .setLongTaskEventMapper(rumLongTaskEventMapper)
     .build()

    RumConfiguration rumConfig = new RumConfiguration.Builder(applicationId)
      // ...
      .setErrorEventMapper(rumErrorEventMapper)
      .setActionEventMapper(rumActionEventMapper)
      .setResourceEventMapper(rumResourceEventMapper)
      .setViewEventMapper(rumViewEventMapper)
      .setLongTaskEventMapper(rumLongTaskEventMapper)
      .build();

EventMapper<T> インターフェースを実装する場合、各イベントタイプの属性は一部のみしか変更することができません。

イベントタイプ	属性キー	説明
ViewEvent	`view.referrer`	ページの初期ビューへのリンク URL。
	`view.url`	ビューの URL。
	`view.name`	ビューの名前。
ActionEvent
	`action.target.name`	ターゲット名。
	`view.referrer`	ページの初期ビューへのリンク URL。
	`view.url`	ビューの URL。
	`view.name`	ビューの名前。
ErrorEvent
	`error.message`	エラーメッセージ。
	`error.stack`	エラーのスタックトレース。
	`error.resource.url`	リソースの URL。
	`view.referrer`	ページの初期ビューへのリンク URL。
	`view.url`	ビューの URL。
	`view.name`	ビューの名前。
ResourceEvent
	`resource.url`	リソースの URL。
	`view.referrer`	ページの初期ビューへのリンク URL。
	`view.url`	ビューの URL。
	`view.name`	ビューの名前。
LongTaskEvent
	`view.referrer`	ページの初期ビューへのリンク URL。
	`view.url`	ビューの URL。
	`view.name`	ビューの名前。

注: EventMapper<T> の実装から null が返された場合、イベントは削除されます。

Retrieve the RUM session ID

Retrieving the RUM session ID can be helpful for troubleshooting. For example, you can attach the session ID to support requests, emails, or bug reports so that your support team can later find the user session in Datadog.

You can access the RUM session ID at runtime without waiting for the sessionStarted event:

GlobalRumMonitor.get().getCurrentSessionId { sessionId ->
  currentSessionId = sessionId
}

その他の参考資料

お役に立つドキュメント、リンクや記事:

dd-sdk-android のソースコードソースコード

Datadog RUM を探索するドキュメント