Présentation

Lors de l’instrumentation d’une application RUM Browser, définissez la fréquence d’échantillonnage pour le nombre total de sessions utilisateur que vous souhaitez collecter et le pourcentage de sessions utilisateur collectées qui incluent les fonctionnalités RUM Browser & Session Replay.

Ce guide fournit un exemple de personnalisation du nombre de sessions Browser RUM & Session Replay que vous souhaitez collecter à partir du nombre total de sessions utilisateur dans Datadog.

Configuration

Le paramètre sessionReplaySampleRate est un pourcentage de sessionSampleRate.

Cette fonctionnalité nécessite le SDK Browser Datadog v3.0.0 ou ultérieur.

Le SDK Browser Datadog v4.20.0 introduit le paramètre d'initialisation sessionReplaySampleRate, supprimant les paramètres d'initialisation premiumSampleRate et replaySampleRate.

Le SDK Browser Datadog v5.0.0 introduit deux changements de comportement majeurs :

• Seules les sessions qui ont enregistré une rediffusion sont considérées comme étant Browser RUM & Session Replay.
• La valeur par défaut du paramètre d’initialisation sessionReplaySampleRate est 0. Les versions précédentes du SDK utilisent 100.

• RUM Browser : les sessions, les vues, les actions, les ressources, les tâches longues et les erreurs sont collectées.
• [RUM Browser & Session Replay]]2 : tout ce qui provient du RUM Browser est collecté, y compris les enregistrements de rediffusions.

Vous pouvez définir deux paramètres d’initialisation pour contrôler la façon dont les sessions sont surveillées :

• Le paramètre sessionSampleRate définit le pourcentage global des sessions surveillées. Par défaut, il prend pour valeur 100%, afin de surveiller toutes les sessions.
• Le paramètre sessionReplaySampleRate est appliqué après le taux d’échantillonnage global. Il définit le pourcentage de sessions surveillées en tant que données RUM Browser & Session Replay. Par défaut, il prend pour valeur 0, afin de ne pas surveiller chaque session en tant que données RUM Browser & Session Replay.

Pour surveiller toutes vos sessions en tant que données RUM Browser :

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

datadogRum.init({
    ....
    sampleRate: 100,
    sessionReplaySampleRate: 0
});

datadogRum.init({
    ....
    sampleRate: 100,
    premiumSampleRate: 0
});

datadogRum.init({
    ....
    sampleRate: 100,
    replaySampleRate: 0
});

Pour surveiller toutes vos sessions en tant que données RUM Browser & Session Replay :

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

datadogRum.init({
    ....
    sampleRate: 100,
    sessionReplaySampleRate: 100
});

datadogRum.init({
    ....
    sampleRate: 100,
    premiumSampleRate: 100
});

datadogRum.init({
    ....
    sampleRate: 100,
    replaySampleRate: 100
});

Utilisez le curseur pour définir le pourcentage de sessions RUM Browser & Session Replay collectées par rapport au pourcentage de sessions utilisateur totales collectées pour votre application.

Si vous définissez sessionSampleRate sur 60 et sessionReplaySampleRate sur 50, 40 % des sessions sont abandonnées, 30 % des sessions sont collectées en tant que RUM Browser et 30 % des sessions sont collectées en tant que RUM Browser & Session Replay.

datadogRum.init({
    ....
    sessionSampleRate: 60,
    sessionReplaySampleRate: 50
});

datadogRum.init({
    ....
    sampleRate: 60,
    sessionReplaySampleRate: 50
});

datadogRum.init({
    ....
    sampleRate: 60,
    premiumSampleRate: 50
});

datadogRum.init({
    ....
    sampleRate: 60,
    replaySampleRate: 50
});

À partir de la version 5.0.0, afin de suivre 100 % des sessions qui atteignent un état personnalisé en tant que RUM Browser & Session Replay :

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

// lorsque lʼétat personnalisé est atteint
datadogRum.startSessionReplayRecording()

Avec l’utilisation de startSessionReplayRecordingManually: true, les sessions qui n’appellent pas startSessionReplayRecording() sont considérées comme des RUM Browser.

Pour en savoir plus sur le tagging et l’exploration des attributs, référez-vous à la section Survellance Browser.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

En savoir plus sur la surveillance Browser RUMDOCUMENTATION