Migrer vers Dartastic
Quitter Sentry ou Datadog n’oblige pas à tout réécrire. Pour les applications Flutter et Dart, il existe trois voies, et vous pouvez vous arrêter à n’importe laquelle.
| Voie | Ce qui change dans votre application | Ce que vous obtenez |
|---|---|---|
| Ajouter un pont Dartastic Labs | Un package et une ligne. Le SDK de votre fournisseur reste en place et continue d’envoyer ses données. | Ce que capture votre SDK, sous forme de logs et de spans OTel standard. |
| Changer votre DSN Sentry | Une chaîne de caractères. Votre SDK Sentry reste en place et envoie à Dartastic. | Erreurs, transactions et sessions dans votre Observatory. |
| Passer à Native OTel | Remplacer le SDK du fournisseur. | Tout : crashs natifs, attribution du jank, tous les niveaux RUM. |
Vous voulez d’abord connaître le coût ? Le calculateur chiffre votre charge sur Dartastic, Sentry et Datadog.
Ajouter un pont Dartastic Labs
Un pont est un package Dart qui copie ce que capture le SDK de votre fournisseur vers OpenTelemetry standard, à l’intérieur de votre application. Votre fournisseur continue de recevoir tout ce qu’il reçoit aujourd’hui : vous pouvez donc faire tourner les deux et comparer sur vos propres sessions. Les packages viennent de Dartastic Pub : dart pub token add https://pub.dartastic.io avec un jeton Pub.
dependencies:
otel_sentry:
hosted: https://pub.dartastic.ioSentry : otel_sentry
Une ligne dans SentryFlutter.init. Chaque événement et chaque breadcrumb capturé par Sentry devient aussi un enregistrement de log OpenTelemetry, rattaché à la trace et au span actifs au moment où il s’est produit.
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()),
);
}Vos beforeSend et beforeBreadcrumb existants continuent de s’exécuter : votre masquage et votre échantillonnage restent tels quels. Si les breadcrumbs génèrent trop de trafic, passez bridgeBreadcrumbs: false.
Datadog : otel_datadog
Ce pont enveloppe le SDK RUM de Datadog. Appelez rum là où votre code appelle DatadogSdk.instance.rum aujourd’hui. Chaque appel part toujours vers Datadog et émet aussi de l’OpenTelemetry : les erreurs, actions et durées sous forme de logs, et chaque vue sous forme de span. Configurez d’abord OTel avec OTel.initialize, comme dans l’exemple 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;
}Autres fournisseurs
Dartastic Labs propose des ponts pour New Relic, Bugsnag, Embrace, Dynatrace, Honeycomb, Splunk et d’autres. Ils figurent tous dans le catalogue Dartastic Labs.
Les intégrations de bibliothèques de votre fournisseur
Chacun de ces packages de fournisseur a un équivalent Dartastic Labs qui fait le même travail en OTel standard.
| Si vous utilisez | Ajoutez |
|---|---|
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 |
Changer votre DSN Sentry
Votre SDK Sentry parle un protocole, et Dartastic le comprend. Pointez le SDK vers Dartastic avec un nouveau DSN, et vos erreurs, transactions et sessions arrivent dans votre Observatory. Aucun nouveau package, et aucun code en dehors de cette chaîne. N’importe quel SDK Sentry fonctionne, dans n’importe quel langage.
- Dans le Control Room, ouvrez Sentry DSNs et créez un DSN. Il faut la permission
keys.manage. - Placez ce DSN là où votre application définit aujourd’hui son DSN Sentry.
- Lancez votre application et cherchez vos erreurs sous « Issues ».
await SentryFlutter.init(
(options) {
options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
},
appRunner: () => runApp(const MyApp()),
);Ce qui est repris
| Depuis votre SDK Sentry | Dans Dartastic |
|---|---|
| Erreurs et crashs | Issues, avec la pile d’appels envoyée par votre SDK |
| Transactions et leurs spans | Traces |
| Sessions de santé des versions | Sessions et taux de sessions sans crash |
Ce qui n’est pas repris
- Session Replay et les profils. Les niveaux de replay viennent avec Native OTel.
- Les envois de source maps et l’historique de vos issues Sentry.
- Les états d’issue propres à Sentry, les assignations et les règles d’alerte. Configurez vos alertes dans Dartastic.
Le trafic Sentry compte comme trafic entrant, comme chaque octet que vous envoyez. Voir les tarifs.
Passer à Native OTel
La dernière étape remplace le SDK du fournisseur par celui de Dartastic, écrit en Dart et en Rust. C’est là que vous obtenez la capture des crashs natifs, l’attribution du jank jusqu’au widget, l’enregistrement ciblé et tous les niveaux de replay. Ajouter OpenTelemetry à votre application détaille toute la configuration.
// 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() remplace SentryNavigatorObserver() ou DatadogNavigationObserver dans navigatorObservers. Vos intégrations HTTP, gRPC, base de données et logging deviennent les packages Dartastic Labs ci-dessus.
Supprimer votre étape d’envoi des symboles
Retirez sentry_dart_plugin ou datadog-ci flutter-symbols upload de votre build. Compilez en mode obfusqué avec les symboles, et publiez la version sur votre Dartastic Pub privé avec ses .symbols : Dartastic les lit depuis Pub, sans étape d’envoi.
flutter build apk --release --obfuscate --split-debug-info=symbols/Où retrouver ce que vous connaissez
| Chez votre fournisseur | Dans Dartastic |
|---|---|
| Sentry Issues, Datadog Error Tracking | Issues |
| Sentry Release Health | Sessions et taux de sessions sans crash pour chaque build |
| Datadog RUM Explorer | Sessions |
| Datadog RUM Views | Screens |
| Sentry Traces, Datadog APM | Traces |
| Sentry Session Replay, Datadog Session Replay | Replay, au niveau de votre choix |
| Sentry Seer, Bits AI | Dartastic AI |
| Sentry Alerts, Datadog Monitors | Alerts |
Sentry et Datadog sont des marques de leurs propriétaires respectifs, citées ici pour vous aider à migrer, sans suggérer aucune affiliation. Voir comment Dartastic se compare.