Migrar a Dartastic
Dejar Sentry o Datadog no tiene por qué ser una reescritura. Para apps Flutter y Dart hay tres rutas, y puede detenerse en cualquiera de ellas.
| Ruta | Qué cambia en su app | Qué obtiene |
|---|---|---|
| Agregar un puente de Dartastic Labs | Un paquete y una línea. El SDK de su proveedor se queda y sigue enviando. | Lo que captura su SDK, como logs y spans OTel estándar. |
| Cambiar su DSN de Sentry | Una cadena. Su SDK de Sentry se queda y envía a Dartastic. | Errores, transacciones y sesiones en su Observatory. |
| Pasar a Native OTel | Reemplazar el SDK del proveedor. | Todo: crashes nativos, atribución del jank, todos los niveles de RUM. |
¿Quiere ver primero el costo? La calculadora calcula el precio de su carga de trabajo en Dartastic, Sentry y Datadog.
Agregar un puente de Dartastic Labs
Un puente es un paquete de Dart que copia lo que captura el SDK de su proveedor a OpenTelemetry estándar, dentro de su app. Su proveedor sigue recibiendo todo lo que recibe hoy, así que puede usar ambos y compararlos con sus propias sesiones. Los paquetes vienen de Dartastic Pub: dart pub token add https://pub.dartastic.io con un token de Pub.
dependencies:
otel_sentry:
hosted: https://pub.dartastic.ioSentry: otel_sentry
Una línea dentro de SentryFlutter.init. Cada evento y cada breadcrumb que captura Sentry se convierte también en un registro de log de OpenTelemetry, en la traza y el span que estaban activos cuando ocurrió.
import 'package:dartastic_opentelemetry/dartastic_opentelemetry.dart';
import 'package:flutter/material.dart';
import 'package:otel_sentry/otel_sentry.dart';
import 'package:sentry_flutter/sentry_flutter.dart';
Future<void> main() async {
await OTel.initialize(serviceName: 'my-app');
await SentryFlutter.init(
(options) {
options.dsn = const String.fromEnvironment('SENTRY_DSN');
installOTelSentryBridge(options); // the one new line
},
appRunner: () => runApp(const MyApp()),
);
}Sus beforeSend y beforeBreadcrumb actuales siguen ejecutándose, así que su enmascaramiento y su muestreo quedan como están. Si los breadcrumbs generan demasiado tráfico, pase bridgeBreadcrumbs: false.
Datadog: otel_datadog
Este puente envuelve el SDK de RUM de Datadog. Llame a rum donde su código llama hoy a DatadogSdk.instance.rum. Cada llamada sigue yendo a Datadog y además emite OpenTelemetry: errores, acciones y tiempos como logs, y cada vista como un span. Configure antes OTel con OTel.initialize, como en el ejemplo de Sentry.
import 'package:datadog_flutter_plugin/datadog_flutter_plugin.dart';
import 'package:otel_datadog/otel_datadog.dart';
final rum = OTelDatadogRum(DatadogSdk.instance.rum);
rum.addAction(RumActionType.tap, 'checkout');
try {
await checkout();
} catch (e, st) {
rum.addError(e, RumErrorSource.source, stackTrace: st);
rethrow;
}Otros proveedores
Dartastic Labs tiene puentes para New Relic, Bugsnag, Embrace, Dynatrace, Honeycomb, Splunk y más. Todos están en el catálogo de Dartastic Labs.
Las integraciones de bibliotecas de su proveedor
Cada uno de estos paquetes del proveedor tiene un paquete de Dartastic Labs que hace el mismo trabajo en OTel estándar.
| Si usa | Agregue |
|---|---|
sentry_dio | otel_dio |
sentry_logging | otel_logging |
sentry_sqflite | otel_sqflite |
sentry_drift | otel_drift |
sentry_hive | otel_hive |
sentry_isar | otel_isar |
sentry_link | otel_graphql |
sentry_grpc | otel_grpc |
datadog_dio | otel_dio |
datadog_tracking_http_client | otel_http |
datadog_grpc_interceptor | otel_grpc |
datadog_gql_link | otel_graphql_flutter |
Cambiar su DSN de Sentry
Su SDK de Sentry habla un protocolo, y Dartastic lo entiende. Apunte el SDK a Dartastic con un DSN nuevo y sus errores, transacciones y sesiones llegan a su Observatory. Ningún paquete nuevo, y ningún código más allá de esa cadena. Funciona cualquier SDK de Sentry, en cualquier lenguaje.
- En el Control Room, abra Sentry DSNs y cree un DSN. Requiere el permiso
keys.manage. - Ponga ese DSN donde su app configura hoy su DSN de Sentry.
- Ejecute su app y busque sus errores en “Issues”.
await SentryFlutter.init(
(options) {
options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
},
appRunner: () => runApp(const MyApp()),
);Qué se transfiere
| Desde su SDK de Sentry | En Dartastic |
|---|---|
| Errores y crashes | Issues, con la pila de llamadas que envió su SDK |
| Transacciones y sus spans | Traces |
| Sesiones de salud de las versiones | Sesiones y tasa de sesiones sin crashes |
Qué no se transfiere
- Session Replay y los perfiles. Los niveles de reproducción vienen con Native OTel.
- Las subidas de source maps y su historial de problemas de Sentry.
- Los estados de problemas, las asignaciones y las reglas de alerta propios de Sentry. Configure las alertas en Dartastic.
El tráfico de Sentry cuenta como tráfico de entrada, como cualquier otro byte que envíe. Consulte los precios.
Pasar a Native OTel
El último paso reemplaza el SDK del proveedor por el de Dartastic, escrito en Dart y Rust. Aquí es donde obtiene la captura de crashes nativos, la atribución del jank hasta el widget, la grabación selectiva y todos los niveles de reproducción. Agregar OpenTelemetry a su app tiene la configuración completa.
// Before, with Sentry
await SentryFlutter.init((options) => options.dsn = dsn, appRunner: start);
Sentry.captureException(e, stackTrace: st);
// Before, with Datadog
await DatadogSdk.instance.initialize(config, TrackingConsent.granted);
DatadogSdk.instance.rum?.addError(e, RumErrorSource.source, stackTrace: st);
// After
await DOTel.initialize(serviceName: 'my-app', serviceVersion: '1.0.0');
DartasticErrorTracker.recordError(e, st);DartasticViewObserver() ocupa el lugar de SentryNavigatorObserver() o DatadogNavigationObserver en navigatorObservers. Sus integraciones de HTTP, gRPC, bases de datos y logging pasan a ser los paquetes de Dartastic Labs de arriba.
Elimine su paso de subida de símbolos
Quite sentry_dart_plugin o datadog-ci flutter-symbols upload de su compilación. Compile ofuscado con símbolos y publique la versión en su Dartastic Pub privado con sus .symbols: Dartastic los lee desde ahí, sin ningún paso de subida.
flutter build apk --release --obfuscate --split-debug-info=symbols/Dónde encontrar lo que ya conoce
| En su proveedor | En Dartastic |
|---|---|
| Sentry Issues, Datadog Error Tracking | Issues |
| Sentry Release Health | Sesiones y tasa de sesiones sin crashes por compilación |
| Datadog RUM Explorer | Sessions |
| Datadog RUM Views | Screens |
| Sentry Traces, Datadog APM | Traces |
| Sentry Session Replay, Datadog Session Replay | Replay, al nivel que elija |
| Sentry Seer, Bits AI | Dartastic AI |
| Sentry Alerts, Datadog Monitors | Alerts |
Sentry y Datadog son marcas comerciales de sus respectivos propietarios, nombradas aquí para ayudarle a migrar, no para sugerir ninguna afiliación. Consulte cómo se compara Dartastic.