概要

Browser RUM アプリケーションをインスツルメントする場合、収集したいユーザーセッションの総量と、Browser RUM & セッションリプレイ機能を含むユーザーセッションの収集率に応じてサンプルレートを設定します。

このガイドでは、Datadog のユーザーセッションの総量から収集したい Browser RUM & セッションリプレイセッションの量をカスタマイズする方法を例として説明します。

セットアップ

sessionReplaySampleRate パラメーターには、sessionSampleRate に対するパーセンテージを指定します。

この機能を使用するには、Datadog ブラウザ SDK v3.0.0+ が必要です。

Datadog ブラウザ SDK v4.20.0 では、sessionReplaySampleRate 初期化パラメーターが導入され、premiumSampleRatereplaySampleRate 初期化パラメーターは非推奨となりました。
The Datadog Browser SDK v5.0.0 introduces two major behavior changes:
  • Only sessions that have recorded a replay are considered as Browser RUM & Session Replay
  • The sessionReplaySampleRate initialization parameter default value is 0 . Previous versions of the SDK use 100.
セッションが作成されると、RUM はそのセッションを次のいずれかとして追跡します。

セッションの追跡方法を制御するために、2 つの初期化パラメーターが利用可能です。

  • sessionSampleRate は、追跡されるセッション全体の割合を制御します。デフォルトは 100% で、すべてのセッションが追跡されます。
  • sessionReplaySampleRate is applied after the overall sample rate, and controls the percentage of sessions tracked as Browser RUM & Session Replay. From Datadog Browser SDK v5.0.0, it defaults to 0, so no session is tracked as Browser RUM & Session Replay by default.

セッションの 100% を Browser RUM として追跡する場合

最新バージョン
datadogRum.init({
    ....
    sessionSampleRate: 100,
    sessionReplaySampleRate: 0
});
v4.30.0 より前
datadogRum.init({
    ....
    sampleRate: 100,
    sessionReplaySampleRate: 0
});
v4.20.0 より前
datadogRum.init({
    ....
    sampleRate: 100,
    premiumSampleRate: 0
});
v4.10.2 より前
datadogRum.init({
    ....
    sampleRate: 100,
    replaySampleRate: 0
});

セッションの 100% を Browser RUM & セッションリプレイとして追跡する場合

最新バージョン
datadogRum.init({
    ....
    sessionSampleRate: 100,
    sessionReplaySampleRate: 100
});
v4.30.0 より前
datadogRum.init({
    ....
    sampleRate: 100,
    sessionReplaySampleRate: 100
});
v4.20.0 より前
datadogRum.init({
    ....
    sampleRate: 100,
    premiumSampleRate: 100
});
v4.10.2 より前
datadogRum.init({
    ....
    sampleRate: 100,
    replaySampleRate: 100
});

スライダーを使用して、アプリケーションで収集された総ユーザーセッションの割合から、収集された Browser RUM & セッションリプレイセッションの割合を設定します。

sessionSampleRate を 60、sessionReplaySampleRate を 50 に設定すると、40% のセッションがドロップされ、30% のセッションが Browser RUM として、30% のセッションが Browser RUM & セッションリプレイとして収集されるようになります。

最新バージョン
datadogRum.init({
    ....
    sessionSampleRate: 60,
    sessionReplaySampleRate: 50
});
v4.30.0 より前
datadogRum.init({
    ....
    sampleRate: 60,
    sessionReplaySampleRate: 50
});
v4.20.0 より前
datadogRum.init({
    ....
    sampleRate: 60,
    premiumSampleRate: 50
});
v4.10.2 より前
datadogRum.init({
    ....
    sampleRate: 60,
    replaySampleRate: 50
});

From v5.0.0, to track 100% of the sessions that reach a custom state as Browser RUM & Session Replay:

datadogRum.init({
    ....
    sessionSampleRate: 100,
    sessionReplaySampleRate: 100,
    startSessionReplayRecordingManually: true,
});

// when the custom state is reached
datadogRum.startSessionReplayRecording()

With the use of startSessionReplayRecordingManually: true, sessions that do not call startSessionReplayRecording() are considered as Browser RUM.

タグ付けや属性の確認については、ブラウザモニタリングを参照してください。

参考資料

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

PREVIEWING: may/unit-testing