Configura Feature Flag Tracking

Documentos > RUM y Session Replay > Seguimiento de indicadores de funciones > Configura Feature Flag Tracking

Los datos de Feature Flag proporcionan una mayor visibilidad sobre la experiencia del usuario y el seguimiento del rendimiento. Permite determinar qué usuarios están viendo una Feature Flag específica y evaluar si los cambios introducidos están impactando la experiencia del usuario o afectando negativamente el rendimiento.

Al enriquecer tus datos de RUM con datos de Feature Flag, puedes estar seguro de que tu funcionalidad se lanza con éxito sin causar accidentalmente un error o una regresión en el rendimiento. Con esta capa adicional de información, puedes correlacionar los lanzamientos con el rendimiento, identificar problemas en lanzamientos específicos y solucionar problemas más rápido.

Configura el seguimiento de RUM

Feature Flag Tracking está disponible en el SDK de RUM para explorador, iOS, Android, Flutter y React Native.

Para habilitar la recolección de datos de Feature Flag para el SDK del explorador:

Configura el seguimiento de RUM para explorador. Necesitas la versión del SDK de RUM del explorador >= 4.25.0.

Inicializa el SDK de RUM y configura el parámetro de inicialización enableExperimentalFeatures con ["feature_flags"].

npm

  import { datadogRum } from '@datadog/browser-rum';

  // Initialize Datadog Browser SDK
  datadogRum.init({
    ...
    enableExperimentalFeatures: ["feature_flags"],
    ...
});

CDN asíncrono

window.DD_RUM.onReady(function() {
    window.DD_RUM.init({
      ...
      enableExperimentalFeatures: ["feature_flags"],
      ...
    })
})

CDN síncrono

window.DD_RUM &&
    window.DD_RUM.init({
      ...
      enableExperimentalFeatures: ["feature_flags"],
      ...
    })

Para habilitar la recopilación de datos de Feature Flag para su aplicación iOS:

Configura el seguimiento de RUM para iOS. Necesita la versión del SDK de RUM para iOS >= 1.16.0.

Para habilitar la recopilación de datos de Feature Flag para su aplicación Android:

Configura el seguimiento de RUM para Android. Necesita la versión del SDK de RUM para Android >= 1.18.0.

Para habilitar la recopilación de datos de Feature Flag para su aplicación Flutter:

Configura el seguimiento de RUM para Flutter. Necesita la versión del Plugin de Flutter >= 1.3.2.

Para habilitar la recopilación de datos de Feature Flag para su aplicación React Native:

Configura el seguimiento de RUM para React Native. Necesita la versión del SDK de RUM para React Native >= 1.7.0.

Configura una integración de Feature Flag

Puede comenzar a recopilar datos de Feature Flag con soluciones personalizadas de gestión de Feature Flag, o utilizando uno de los socios de integración de Datadog que se enumeran a continuación.

Nota: Los siguientes caracteres especiales no son compatibles con el seguimiento de Feature Flag: ., :, +, -, =, &&, ||, >, <, !, (, ), {, }, [, ], ^, ", “, ”, ~, *, ?, \. Datadog recomienda evitar estos caracteres cuando sea posible en los nombres de sus Feature Flags. Si se requiere utilizar uno de estos caracteres, reemplace el carácter antes de enviar los datos a Datadog. Por ejemplo:

datadogRum.addFeatureFlagEvaluation(key.replaceAll(':', '_'), value);

Integración de Amplitude

Antes de inicializar esta integración de Feature Flag, asegúrese de haber configurado el seguimiento de RUM.

Inicialice el SDK de Amplitude y cree un oyente de exposición que informe las evaluaciones de Feature Flag a Datadog utilizando el siguiente fragmento de código:

Para más información sobre cómo inicializar el SDK de Amplitude, consulte la documentación del SDK de JavaScript de Amplitude.

  const experiment = Experiment.initialize("CLIENT_DEPLOYMENT_KEY", {
    exposureTrackingProvider: {
      track(exposure: Exposure)  {
        // Send the feature flag when Amplitude reports the exposure
        datadogRum.addFeatureFlagEvaluation(exposure.flag_key, exposure.variant);
      }
    }
  })

Inicialice el SDK de Amplitude y cree un inspector que informe las evaluaciones de Feature Flag a Datadog utilizando el fragmento de código a continuación.

Para más información sobre cómo inicializar el SDK de Amplitude, consulte la documentación del SDK de iOS de Amplitude.

  class DatadogExposureTrackingProvider : ExposureTrackingProvider {
    func track(exposure: Exposure) {
      // Send the feature flag when Amplitude reports the exposure
      if let variant = exposure.variant {
        RUMMonitor.shared().addFeatureFlagEvaluation(name: exposure.flagKey, value: variant)
      }
    }
  }

  // In initialization:
  ExperimentConfig config = ExperimentConfigBuilder()
    .exposureTrackingProvider(DatadogExposureTrackingProvider(analytics))
    .build()

Inicialice el SDK de Amplitude y cree un inspector que informe las evaluaciones de Feature Flag a Datadog utilizando el fragmento de código a continuación.

Para más información sobre cómo inicializar el SDK de Amplitude, consulte la documentación del SDK de Android de Amplitude.

internal class DatadogExposureTrackingProvider : ExposureTrackingProvider {
  override fun track(exposure: Exposure) {
      // Send the feature flag when Amplitude reports the exposure
      GlobalRumMonitor.get().addFeatureFlagEvaluation(
          exposure.flagKey,
          exposure.variant.orEmpty()
      )
  }
}

// In initialization:
val config = ExperimentConfig.Builder()
    .exposureTrackingProvider(DatadogExposureTrackingProvider())
    .build()

Amplitude no es compatible con esta integración. Cree un ticket con Amplitude para solicitar esta función.

Integración de ConfigCat

Antes de inicializar esta integración de Feature Flag, asegúrese de haber configurado el seguimiento de RUM.

Al inicializar el SDK de Javascript de ConfigCat, suscríbase al evento flagEvaluated e informe las evaluaciones de Feature Flag a Datadog:

const configCatClient = configcat.getClient(
  '#YOUR-SDK-KEY#',
  configcat.PollingMode.AutoPoll,
  {
    setupHooks: (hooks) =>
      hooks.on('flagEvaluated', (details) => {
        datadogRum.addFeatureFlagEvaluation(details.key, details.value);
      })
  }
);

Para más información sobre cómo inicializar el SDK de Javascript de ConfigCat, consulte la documentación del SDK de JavaScript de ConfigCat.

Al inicializar el SDK de ConfigCat Swift para iOS, suscríbase al evento flagEvaluated e informe las evaluaciones de Feature Flag a Datadog:

  let client = ConfigCatClient.get(sdkKey: "#YOUR-SDK-KEY#") { options in
    options.hooks.addOnFlagEvaluated { details in
        RUMMonitor.shared().addFeatureFlagEvaluation(featureFlag: details.key, variation: details.value)
    }
  }

Para más información sobre cómo inicializar el SDK de ConfigCat Swift (iOS), consulte la documentación del SDK de Swift para iOS de ConfigCat.

Al inicializar el SDK de ConfigCat para Android, suscríbase al evento flagEvaluated e informe las evaluaciones de Feature Flag a Datadog:

ConfigCatClient client = ConfigCatClient.get("#YOUR-SDK-KEY#", options -> {
  options.hooks().addOnFlagEvaluated(details -> {
      GlobalRumMonitor.get().addFeatureFlagEvaluation(details.key, details.value);
  });
});

Para más información sobre cómo inicializar el SDK de ConfigCat para Android, consulte la documentación del SDK de Android de ConfigCat.

Al inicializar el SDK de ConfigCat para Dart, suscríbase al evento flagEvaluated e informe las evaluaciones de Feature Flag a Datadog:

  final client = ConfigCatClient.get(
    sdkKey: '#YOUR-SDK-KEY#',
    options: ConfigCatOptions(
        pollingMode: PollingMode.autoPoll(),
        hooks: Hooks(
            onFlagEvaluated: (details) => {
              DatadogSdk.instance.rum?.addFeatureFlagEvaluation(details.key, details.value);
            }
        )
    )
  );

Para obtener más información sobre la inicialización del SDK de ConfigCat Dart (Flutter), consulte la documentación del SDK de Dart de ConfigCat.

Al inicializar el SDK de ConfigCat React, suscríbase al evento flagEvaluated y reporte las evaluaciones de Feature Flag a Datadog:

<ConfigCatProvider
  sdkKey="YOUR_SDK_KEY"
  pollingMode={PollingMode.AutoPoll}
  options={{
    setupHooks: (hooks) =>
      hooks.on('flagEvaluated', (details) => {
        DdRum.addFeatureFlagEvaluation(details.key, details.value);
      }),
  }}
>
  ...
</ConfigCatProvider>

Para obtener más información sobre la inicialización del SDK de ConfigCat React, consulte la documentación del SDK de React de ConfigCat.

Gestión de Feature Flag personalizada

Antes de inicializar una integración personalizada de Feature Flag, asegúrese de haber configurado el seguimiento de RUM.