Installer et configurer Mobile Session Replay

Docs > RUM et Session Replay > Session Replay > Session Replay sur mobile > Installer et configurer Mobile Session Replay

Configuration

Toutes les versions du SDK Session Replay sont disponibles dans le référentiel de snapshots Maven.

Pour configurer Mobile Session Replay pour Android :

Assurez-vous d’avoir configuré et initialisé le SDK RUM Android de Datadog en ayant activé l’instrumentation des vues.
Déclarer Session Replay de Datadog comme dépendance :

build.gradle

    implementation("com.datadoghq:dd-sdk-android-rum:[datadog_version]")
    implementation("com.datadoghq:dd-sdk-android-session-replay:[datadog_version]")
    // en cas de besoin d'un soutien matériel
    implementation("com.datadoghq:dd-sdk-android-session-replay-material:[datadog_version]")
   

Activer Session Replay dans votre application :

Application.kt

   val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    // en cas de besoin d'un soutien dʼextension matérielle
    .addExtensionSupport(MaterialExtensionSupport()) 
    .build()
   SessionReplay.enable(sessionReplayConfig)
   

Pour configurer Mobile Session Replay pour iOS :

Assurez-vous d’avoir configuré et initialisé le SDK RUM iOS de Datadog en ayant activé l’instrumentation des vues.

Lier la bibliothèque Session Replay de Datadog à votre projet en vous basant sur votre gestionnaire de paquets :

Gestionnaire de paquets	Étape dʼinstallation
CocoaPods	Ajoutez `pod 'DatadogSessionReplay'` à votre `Podfile`.
Swift Package Manager	Ajoutez la bibliothèque `DatadogSessionReplay` en tant que dépendance à la cible de votre app.
Carthage	Ajoutez la bibliothèque `DatadogSessionReplay.xcframework` en tant que dépendance à la cible de votre app.

Activer Session Replay dans votre application :

AppDelegate.swift

   importer DatadogSessionReplay

   SessionReplay.enable(
       with: SessionReplay.Configuration(
           replaySampleRate: sampleRate
       )
   )
   

Le taux d’échantillonnage est un paramètre obligatoire lors de la configuration de Session Replay. Il doit être compris entre 0.0 et 100.0, où 0 signifie qu’aucun enregistrement ne sera effectué et 100 signifie que toutes les sessions du RUM contiendront des enregistrements.

Ce taux d’échantillonnage est appliqué en plus de celui du RUM. Par exemple, si le RUM utilise un taux d’échantillonnage de 80 % et si Session Replay utilise un taux d’échantillonnage de 20 %, cela signifie que, sur lʼensemble des sessions dʼutilisateurs, 80 % dʼentre elles seront incluses dans le RUM et que, parmi elles, seules 20 % possèderont des enregistrements.

Application.kt

val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
 ...
.build()

AppDelegate.swift

var sessionReplayConfig = SessionReplay.Configuration(
    replaySampleRate: sampleRate
)

Valider l’envoi de données de Session Replay

Pour valider ou non lʼenvoi des données de Session Replay par l’application, vous pouvez activer l’option de débogage dans le SDK Datadog :

Application.kt

Datadog.setVerbosity(Log.DEBUG)

AppDelegate.swift

Datadog.verbosityLevel = .debug

Si tout se passe correctement, les logs suivants doivent apparaître dans la console de débogage de Xcode environ 30 secondes après le lancement de l’application :

Xcode console

[DATADOG SDK] 🐶 → 10:21:29.812 ⏳ (session-replay) Uploading batch...
[DATADOG SDK] 🐶 → 10:21:30.442    → (session-replay) accepted, won't be retransmitted: [response code: 202 (accepted), request ID: BD445EA-...-8AFCD3F3D16]