Descripción general

A medida que su aplicación evoluciona, es posible que necesite ajustar los datos que recopila el SDK de RUM y su frecuencia de recopilación. La configuración remota de RUM le permite actualizar los ajustes compatibles del SDK para navegador, iOS y Android desde Datadog sin necesidad de implementar una nueva versión de su aplicación.

Requisitos previos

Remote Configuration debe estar habilitada en su organización y requiere las siguientes versiones del SDK de RUM:

• Versión 7.13.0+ del SDK para navegador
• Versión 3.17.0+ del SDK para iOS
• Versión 3.14.1+ del SDK para Android

Cómo funciona

Cada aplicación de RUM tiene un ID de Remote Configuration que el SDK utiliza para recuperar sus ajustes remotos.

Cuando el SDK se inicializa, aplica los ajustes remotos almacenados en caché. Si no hay ajustes almacenados en caché disponibles, utiliza los ajustes definidos en su aplicación. El SDK verifica actualizaciones en segundo plano y almacena los cambios para la siguiente inicialización. Si la verificación falla, el SDK conserva su caché existente o continúa utilizando sus ajustes locales. La verificación no retrasa la inicialización del SDK ni interrumpe la recopilación de eventos de RUM.

Una Remote Configuration se aplica a todos los usuarios y sesiones inicializados con su ID. No puede dirigirse a usuarios o sesiones individuales. Si cambia el ID, el SDK lo trata como una nueva Remote Configuration y no utiliza los ajustes almacenados en caché con el ID anterior.

Permisos

La configuración remota utiliza los mismos permisos que las aplicaciones de RUM. Para habilitar, editar o publicar una configuración, necesita el permiso RUM Apps Write. Para obtener más información, consulte Real User Monitoring permissions.

Configuración

Para configurar los ajustes remotos de una aplicación:

1. Instale un SDK de RUM compatible en una aplicación nueva o actualice el SDK en una aplicación existente.

2. Vaya a RUM > Manage Applications, seleccione una aplicación y haga clic en SDK Configuration.

3. Habilite la configuración remota para generar un ID de configuración remota. Nota: Datadog guarda la configuración como borrador, por lo que sus valores no anulan los ajustes existentes del SDK antes de que usted la publique.

4. Agregue el ID de Remote Configuration a la inicialización de su SDK.

   Agregue un objeto remoteConfiguration a su llamada datadogRum.init() existente:

   remoteConfiguration: {
       id: '<REMOTE_CONFIGURATION_ID>',
   },
   

   Agregue remoteConfiguration a su Datadog.Configuration:

   remoteConfiguration: .init(id: "<REMOTE_CONFIGURATION_ID>")
   

   Llame a setRemoteConfigurationId() en su Configuration.Builder:

   .setRemoteConfigurationId("<REMOTE_CONFIGURATION_ID>")
   

5. Actualice la configuración como se describe en la sección Cambiar la configuración del SDK con Remote Configuration.

6. Publique la configuración para aplicar sus ajustes habilitados.

Cambiar la configuración del SDK con Remote Configuration

La Remote Configuration no anula ninguna configuración del SDK de forma predeterminada. Para administrar una configuración de forma remota, habilite explícitamente su anulación en Datadog y luego configure su valor. Las configuraciones sin una anulación habilitada continúan usando los valores configurados en el SDK.

1. Habilite la anulación para una configuración que desee administrar de forma remota. Elija entre las configuraciones enumeradas en la sección Configuraciones configurables para su plataforma.

   Ciertas configuraciones requieren las importaciones de módulos correspondientes en los SDK de iOS y Android. Si su aplicación no importa estos módulos, Remote Configuration no funcionará para Session Replay, la traza distribuida o la generación de perfiles.

2. Configure el ajuste seleccionando un estado, cambiando su tasa de muestreo o agregando datos.

3. Guarde sus cambios.

Configuraciones configurables

Lecturas adicionales

Documentación, enlaces y artículos útiles adicionales:

Real User MonitoringDOCUMENTACIÓN