Ces pages affichent les URL de Cloud. Connectez-vous sur Dedicated et elles affichent celles de votre serveur.

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.

VoieCe qui change dans votre applicationCe que vous obtenez
Ajouter un pont Dartastic LabsUn 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 SentryUne chaîne de caractères. Votre SDK Sentry reste en place et envoie à Dartastic.Erreurs, transactions et sessions dans votre Observatory.
Passer à Native OTelRemplacer 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.

yaml
dependencies:
  otel_sentry:
    hosted: https://pub.dartastic.io

Sentry : 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.

dart
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.

dart
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 utilisezAjoutez
sentry_diootel_dio
sentry_loggingotel_logging
sentry_sqfliteotel_sqflite
sentry_driftotel_drift
sentry_hiveotel_hive
sentry_isarotel_isar
sentry_linkotel_graphql
sentry_grpcotel_grpc
datadog_diootel_dio
datadog_tracking_http_clientotel_http
datadog_grpc_interceptorotel_grpc
datadog_gql_linkotel_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.

  1. Dans le Control Room, ouvrez Sentry DSNs et créez un DSN. Il faut la permission keys.manage.
  2. Placez ce DSN là où votre application définit aujourd’hui son DSN Sentry.
  3. Lancez votre application et cherchez vos erreurs sous « Issues ».
dart
await SentryFlutter.init(
  (options) {
    options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
  },
  appRunner: () => runApp(const MyApp()),
);

Ce qui est repris

Depuis votre SDK SentryDans Dartastic
Erreurs et crashsIssues, avec la pile d’appels envoyée par votre SDK
Transactions et leurs spansTraces
Sessions de santé des versionsSessions 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.

dart
// 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.

shell
flutter build apk --release --obfuscate --split-debug-info=symbols/

Où retrouver ce que vous connaissez

Chez votre fournisseurDans Dartastic
Sentry Issues, Datadog Error TrackingIssues
Sentry Release HealthSessions et taux de sessions sans crash pour chaque build
Datadog RUM ExplorerSessions
Datadog RUM ViewsScreens
Sentry Traces, Datadog APMTraces
Sentry Session Replay, Datadog Session ReplayReplay, au niveau de votre choix
Sentry Seer, Bits AIDartastic AI
Sentry Alerts, Datadog MonitorsAlerts

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.