Queste pagine mostrano gli URL di Cloud. Acceda su Dedicated e vedrà quelli del suo server.

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.

PercorsoCosa cambia nella sua appCosa ottiene
Aggiungere un bridge Dartastic LabsUn 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 SentryUna stringa. Il suo SDK Sentry resta e invia a Dartastic.Errori, transazioni e sessioni nel suo Observatory.
Passare a Native OTelSostituire 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.

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

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

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()),
  );
}

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.

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;
}

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 usaAggiunga
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

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.

  1. Nella Control Room, apra Sentry DSNs e crei un DSN. Richiede l’autorizzazione keys.manage.
  2. Imposti quel DSN dove oggi la sua app imposta il DSN di Sentry.
  3. Esegua la sua app e cerchi gli errori in « Issues ».
dart
await SentryFlutter.init(
  (options) {
    options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
  },
  appRunner: () => runApp(const MyApp()),
);

Cosa viene trasferito

Dal suo SDK SentryIn Dartastic
Errori e crashIssues, con lo stack trace inviato dal suo SDK
Transazioni e i loro spanTraces
Sessioni di Release HealthSessioni 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.

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() 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.

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

Dove trovare ciò che già conosce

Nel suo fornitoreIn Dartastic
Sentry Issues, Datadog Error TrackingIssues
Sentry Release HealthSessioni e percentuale di sessioni senza crash per ogni build
Datadog RUM ExplorerSessions
Datadog RUM ViewsScreens
Sentry Traces, Datadog APMTraces
Sentry Session Replay, Datadog Session ReplayReplay, al livello che sceglie
Sentry Seer, Bits AIDartastic AI
Sentry Alerts, Datadog MonitorsAlerts

Sentry e Datadog sono marchi dei rispettivi proprietari, citati qui per aiutarla nella migrazione, non per suggerire un’affiliazione. Veda come si confronta Dartastic.