Migrare a Dartastic
Lasciare Sentry o Datadog non significa riscrivere tutto. Per le app Flutter e Dart ci sono tre percorsi, e può fermarsi a uno qualsiasi.
| Percorso | Cosa cambia nella sua app | Cosa ottiene |
|---|---|---|
| Aggiungere un bridge Dartastic Labs | Un pacchetto e una riga. L’SDK del fornitore resta e continua a inviare. | Ciò che il suo SDK cattura, come log e span OTel standard. |
| Cambiare il DSN di Sentry | Una stringa. Il suo SDK Sentry resta e invia a Dartastic. | Errori, transazioni e sessioni nel suo Observatory. |
| Passare a Native OTel | Sostituire l’SDK del fornitore. | Tutto: crash nativi, attribuzione del jank, ogni livello RUM. |
Vuole conoscere prima il costo? Il calcolatore stima il prezzo del suo carico di lavoro su Dartastic, Sentry e Datadog.
Aggiungere un bridge Dartastic Labs
Un bridge è un pacchetto Dart che copia ciò che l’SDK del fornitore cattura in OpenTelemetry standard, all’interno della sua app. Il fornitore continua a ricevere tutto ciò che riceve oggi, così può usare entrambi e confrontarli sulle sue sessioni. I pacchetti provengono da Dartastic Pub: dart pub token add https://pub.dartastic.io con un token Pub.
dependencies:
otel_sentry:
hosted: https://pub.dartastic.ioSentry: otel_sentry
Una riga all’interno di SentryFlutter.init. Ogni evento e breadcrumb catturato da Sentry diventa anche un record di log OpenTelemetry, sulla traccia e sullo span attivi nel momento in cui è avvenuto.
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()),
);
}I suoi beforeSend e beforeBreadcrumb esistenti continuano a funzionare, quindi mascheramento e campionamento restano come sono. Se i breadcrumb generano troppo traffico, passi bridgeBreadcrumbs: false.
Datadog: otel_datadog
Questo bridge avvolge l’SDK RUM di Datadog. Chiami rum dove oggi il suo codice chiama DatadogSdk.instance.rum. Ogni chiamata arriva comunque a Datadog ed emette anche OpenTelemetry: errori, azioni e tempi come log, e ogni vista come span. Configuri prima OTel con OTel.initialize, come nell’esempio 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;
}Altri fornitori
Dartastic Labs ha bridge per New Relic, Bugsnag, Embrace, Dynatrace, Honeycomb, Splunk e altri. Sono tutti nel catalogo Dartastic Labs.
Le integrazioni di librerie del suo fornitore
Ognuno di questi pacchetti del fornitore ha un pacchetto Dartastic Labs che fa lo stesso lavoro in OTel standard.
| Se usa | Aggiunga |
|---|---|
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 |
Cambiare il DSN di Sentry
Il suo SDK Sentry parla un protocollo, e Dartastic lo comprende. Indirizzi l’SDK a Dartastic con un nuovo DSN e i suoi errori, transazioni e sessioni arrivano nel suo Observatory. Nessun nuovo pacchetto e nessun codice oltre a quella stringa. Funziona qualsiasi SDK Sentry, in qualsiasi linguaggio.
- Nella Control Room, apra Sentry DSNs e crei un DSN. Richiede l’autorizzazione
keys.manage. - Imposti quel DSN dove oggi la sua app imposta il DSN di Sentry.
- Esegua la sua app e cerchi gli errori in « Issues ».
await SentryFlutter.init(
(options) {
options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
},
appRunner: () => runApp(const MyApp()),
);Cosa viene trasferito
| Dal suo SDK Sentry | In Dartastic |
|---|---|
| Errori e crash | Issues, con lo stack trace inviato dal suo SDK |
| Transazioni e i loro span | Traces |
| Sessioni di Release Health | Sessioni e percentuale di sessioni senza crash |
Cosa non viene trasferito
- Session Replay e profili. I livelli di replay arrivano con Native OTel.
- I caricamenti delle source map e la cronologia dei problemi in Sentry.
- Gli stati dei problemi propri di Sentry, le assegnazioni e le regole di avviso. Configuri gli avvisi in Dartastic.
Il traffico Sentry conta come traffico in ingresso, come ogni altro byte che invia. Veda i prezzi.
Passare a Native OTel
L’ultimo passo sostituisce l’SDK del fornitore con quello di Dartastic, scritto in Dart e Rust. Qui ottiene la cattura dei crash nativi, l’attribuzione del jank fino al widget, la registrazione mirata e ogni livello di replay. Aggiungere OpenTelemetry alla sua app contiene la configurazione 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() prende il posto di SentryNavigatorObserver() o DatadogNavigationObserver in navigatorObservers. Le sue integrazioni HTTP, gRPC, database e logging diventano i pacchetti Dartastic Labs indicati sopra.
Eliminare il passaggio di caricamento dei simboli
Rimuova sentry_dart_plugin o datadog-ci flutter-symbols upload dalla sua build. Esegua una build offuscata con i simboli e pubblichi la release sul suo Dartastic Pub privato con i suoi .symbols: Dartastic li legge da lì, senza alcun passaggio di caricamento.
flutter build apk --release --obfuscate --split-debug-info=symbols/Dove trovare ciò che già conosce
| Nel suo fornitore | In Dartastic |
|---|---|
| Sentry Issues, Datadog Error Tracking | Issues |
| Sentry Release Health | Sessioni e percentuale di sessioni senza crash per ogni build |
| Datadog RUM Explorer | Sessions |
| Datadog RUM Views | Screens |
| Sentry Traces, Datadog APM | Traces |
| Sentry Session Replay, Datadog Session Replay | Replay, al livello che sceglie |
| Sentry Seer, Bits AI | Dartastic AI |
| Sentry Alerts, Datadog Monitors | Alerts |
Sentry e Datadog sono marchi dei rispettivi proprietari, citati qui per aiutarla nella migrazione, non per suggerire un’affiliazione. Veda come si confronta Dartastic.