Solucionar problemas con el SDK de Flutter
Si experimentas un comportamiento inesperado con Datadog RUM, utiliza esta guía para solucionar los problemas rápidamente. Si sigues teniendo problemas, ponte en contacto con el Equipo de soporte técnico de Datadog para obtener más ayuda.
Interfaz duplicada (iOS)
Si aparece este error al compilar iOS después de actualizar a datadog_flutter_plugin v2.0:
Problema semántico (Xcode): Definición de interfaz duplicada de la clase 'DatadogSdkPlugin'
/Users/exampleuser/Projects/test_app/build/ios/Debug-iphonesimulator/datadog_flutter_plugin/datadog_flutter_plugin.framework/Headers/DatadogSdkPlugin.h:6:0
Prueba realizar flutter clean && flutter pub get y compilar nuevamente. Esto suele solucionar el problema.
Clases duplicadas (Android)
Si aparece este error al compilar Android después de actualizar a datadog_flutter_plugin v2.0:
FALLO: Ocurrió un fallo en la compilación con una excepción.
* What went wrong:
Falló la ejecución de la tarea ':app:checkDebugDuplicateClasses'.
> Ha ocurrido un fallo mientras se ejecutaba com.android.build.gradle.internal.tasks.CheckDuplicatesRunnable
Asegúrate de que hayas actualizado tu versión de Kotlin al menos a la 1.8 en tu archivo build.gradle.
Problemas con Cocoapods
Si tienes problemas para compilar tu aplicación iOS después de añadir el SDK de Datadog debido a errores lanzados por Cocoapods, check qué error estás recibiendo. El error más frecuente es un problema para obtener la biblioteca nativa más actualizada de Cocoapods, que puede resolverse ejecutando lo siguiente en tu directorio ios:
pod install --repo-update
Otro error frecuente es un problema al cargar la biblioteca FFI en Silicon Macs Si ves un error similar al siguiente:
LoadError - dlsym(0x7fbbeb6837d0, Init_ffi_c): symbol not found - /Library/Ruby/Gems/2.6.0/gems/ffi-1.13.1/lib/ffi_c.bundle
/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/core_ext/kernel_require.rb:54:in `require'
/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/core_ext/kernel_require.rb:54:in `require'
/Library/Ruby/Gems/2.6.0/gems/ffi-1.13.1/lib/ffi.rb:6:in `rescue in <top (required)>'
/Library/Ruby/Gems/2.6.0/gems/ffi-1.13.1/lib/ffi.rb:3:in `<top (required)>'
Sigue las instrucciones de la documentación de Flutter para trabajar con Flutter en Apple Silicon.
Símbolo indefinido (iOS)
Si utilizas el comando build ios-framework de Flutter, es posible que aparezcan errores similares a los siguientes:
Undefined symbol: _OBJC_CLASS_$_PLCrashReport
Undefined symbol: _OBJC_CLASS_$_PLCrashReportBinaryImageInfo
Undefined symbol: _OBJC_CLASS_$_PLCrashReportStackFrameInfo
...
Esto ocurre porque el comando build ios-framework no incluye correctamente PLCrashReporter, del que depende SDK de Datadog Flutter. Para resolver este problema, Datadog recomienda incluir manualmente la dependencia PLCrashReporter. El marco y las instrucciones para incluirlo están disponibles en su página de GitHub.
Configurar sdkVerbosity
Si puedes ejecutar tu aplicación, pero no ves los datos que esperas en el sitio Datadog, intenta añadir lo siguiente a tu código antes de llamar a DatadogSdk.initialize:
DatadogSdk.instance.sdkVerbosity = CoreLoggerLevel.debug;
Esto hace que el SDK genere información adicional sobre lo que está haciendo y los errores que está encontrando, lo que puede ayudarlos a ti y al equipo de soporte técnico de Datadog a reducir el problema.
No ver Errores
Si no ves ningún error en RUM, es probable que no se haya iniciado ninguna vista. Asegúrate de que hayas iniciado una vista con DatadogSdk.instance.rum?.startView o, si estás utilizando DatadogRouteObserver, asegúrate de que tu ruta actual tenga un nombre.
Problemas con el rastreo automático de recursos y el rastreo distribuido
El paquete de rastreo de Datadog del cliente HTTP funciona con los paquetes de red más frecuentes de Flutter que dependen de dart:io, incluidos http y Dio.
Si estás viendo recursos en tus sesiones de RUM, entonces el rastreo del cliente HTTP está funcionando, pero pueden ser necesarios otros pasos para utilizar el rastreo distribuido.
De modo predeterminado, las muestras del SDK de RUM Flutter de Datadog distribuyen trazas (traces) a solo el 20 % de las solicitudes de recursos. Mientras se determina si hay un problema con tu configuración, debes configurar este valor en el 100 % de las trazas modificando tu inicialización con las siguientes líneas:
configuración final = DdSdkConfiguration(
//
rumConfiguration: DatadogRumConfiguration(
applicationId: '<RUM_APPLICATION_ID>',
tracingSamplingRate: 100,0
),
);
Si sigues teniendo problemas, check que tu propiedad firstPartyHosts esté configurada correctamente. Solo deben ser hosts, sin esquemas ni rutas y no admiten expresiones regulares ni comodines. Por ejemplo:
✅ Bueno - 'example.com', 'api.example.com', 'us1.api.sample.com'
❌ Malo - 'https://example.com', '*.example.com', 'us1.sample.com/api/*', 'api.sample.com/api'
Advertencia “Deobfuscation failed”
Aparece una advertencia cuando falla el desenmascarado de un stack trace. Si el stack trace no está enmascarado para empezar, puedes ignorar esta advertencia. De lo contrario, utiliza la página de símbolos de depuración de RUM para ver todos los archivos de símbolos, dSYMs y archivos de asignación que hayas cargado. Consulta Investigate Obfuscated Stack Traces with RUM Debug Symbols.
Referencias adicionales
Más enlaces, artículos y documentación útiles:
