Fonctionnalité avancée

Enregistrer manuellement la rediffusion de session

Si nécessaire, vous pouvez programmer force une relecture de session pour démarrer ou arrêter l'enregistrement à l'aide de méthodes API. Voici quelques cas d’utilisation :

• Autoriser l'utilisateur à accepter l'enregistrement interaction . Par exemple, si vous avez une fenêtre contextuelle demandant « Autoriser l'enregistrement de cette session à des fins d'analyse des performances ? » et un utilisateur consent :

  1. Appelez newrelic.recordReplay() pour lancer l'enregistrement.
  2. Une fois la session terminée ou le consentement retiré, utilisez newrelic.pauseReplay() pour arrêter la capture de données.

• Enregistrez des sessions en fonction de critères spécifiques, tels que :

  • Démarrez l'enregistrement uniquement pour les sessions sur des URL spécifiques telles qu'un flux de paiement de produit.
  • Arrêtez l'enregistrement pour les pages sensibles telles que /billing ou /health-records.

Reportez-vous à la documentation de l'API pour obtenir des instructions :

• newrelic.recordReplay
• newrelic.pauseReplay

Désactiver le suivi automatique de la relecture de session

Vous pouvez empêcher le démarrage automatique de Session Replay, même lorsqu'il est échantillonné, en définissant l'option configuration de l'API autoStart sur false. Cela est utile dans les scénarios où vous devez prioriser des actions spécifiques par rapport à l'échantillonnage automatique. Par exemple, vous ne souhaitez peut-être pas que Session Replay s'exécute automatiquement sur des pages sensibles, comme celles conformes à la loi HIPAA. Dans de tels cas, vous pouvez utiliser l'API .start() pour déclencher manuellement la fonctionnalité de relecture après l'obtention du consentement de l'utilisateur (et votre application appelle .start()).

Le paramètre autoStart: false indique à l'agent de différer son initialisation jusqu'à ce qu'il soit explicitement appelé à l'aide de .start(). Cela garantit que la relecture de session ne sera pas créée du tout, même si le backend échantillonne votre application pour l'enregistrement.

Pour commencer à utiliser cette API, reportez-vous newrelic.start.

Utilisez Nerdgraph pour configurer les paramètres de relecture

Vous pouvez configurer les paramètres de relecture de session à l'aide de notre API NerdGraph au lieu d'utiliser l'UI. Cette méthode est utile si vous devez effectuer des modifications en masse, comme l'application de taux d'échantillonnage à plusieurs entités de navigateur.

Voici un exemple de mutation et de variables pour créer une nouvelle application de navigateur avec des paramètres par défaut :

mutation SessionReplayConfigUpdate(
  $guid: EntityGuid!
  $settings: AgentApplicationSettingsUpdateInput!
) {
  agentApplicationSettingsUpdate(guid: $guid, settings: $settings) {
    browserSettings {
      sessionReplay {
        blockSelector
        errorSamplingRate
        maskTextSelector
        enabled
        collectFonts
        inlineImages
        inlineStylesheet
        samplingRate
        maskAllInputs
        maskInputOptions {
          color
          date
          datetimeLocal
          email
          month
          number
          range
          search
          select
          tel
          text
          textArea
          time
          url
          week
        }
      }
    }
    errors {
      field
      errorClass
      description
    }
  }
}

{
  "sessionReplay": {
    "enabled": true,
    "collectFonts": true,
    "blockSelector": ".private-fields",
    "maskTextSelector": "*",
    "inlineStylesheet": false,
    "maskAllInputs": true,
    "maskInputOptions": {
      "color": true,
      "date": true,
      "textArea": true
    },
    "samplingRate": 9.99,
    "errorSamplingRate": 1.11
  }
}