Te strony pokazują adresy URL Cloud. Po zalogowaniu się na Dedicated pokazują adresy własnego serwera: Zaloguj się.

Migracja do Dartastic

Odejście od Sentry lub Datadoga nie wymaga przepisywania aplikacji. Dla aplikacji Flutter i Dart są trzy drogi, a na każdej z nich można się zatrzymać.

DrogaCo zmienia się w aplikacjiCo Państwo zyskują
Dodanie mostu Dartastic LabsJeden pakiet i jedna linia. SDK dotychczasowego dostawcy zostaje i nadal wysyła dane.To, co rejestruje SDK, w postaci standardowych logów i spanów OTel.
Zmiana DSN SentryJeden ciąg znaków. SDK Sentry zostaje i wysyła dane do Dartastic.Błędy, transakcje i sesje w Observatory.
Przejście na Native OTelZastąpienie SDK dostawcy.Wszystko: awarie natywne, przypisanie janku, każdy poziom RUM.

Najpierw koszty? Kalkulator wycenia obciążenie w Dartastic, Sentry i Datadog.

Dodanie mostu Dartastic Labs

Most to pakiet Dart, który wewnątrz aplikacji kopiuje to, co rejestruje SDK dostawcy, do standardowego OpenTelemetry. Dostawca nadal dostaje wszystko, co dostaje dziś, więc można korzystać z obu i porównać je na własnych sesjach. Pakiety pochodzą z Dartastic Pub: dart pub token add https://pub.dartastic.io z tokenem Pub.

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

Sentry: otel_sentry

Jedna linia w SentryFlutter.init. Każde zdarzenie i każdy breadcrumb rejestrowany przez Sentry staje się też rekordem logu OpenTelemetry, przypiętym do trasy i spanu aktywnych w chwili, gdy wystąpił.

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

Istniejące beforeSend i beforeBreadcrumb nadal działają, więc maskowanie i próbkowanie pozostają bez zmian. Jeśli breadcrumby generują zbyt duży ruch, wystarczy przekazać bridgeBreadcrumbs: false.

Datadog: otel_datadog

Ten most opakowuje SDK RUM Datadog. Należy wywoływać rum tam, gdzie kod wywołuje dziś DatadogSdk.instance.rum. Każde wywołanie nadal trafia do Datadog i dodatkowo emituje OpenTelemetry: błędy, akcje i pomiary czasu jako logi, a każdy widok jako span. Najpierw należy skonfigurować OTel za pomocą OTel.initialize, jak w przykładzie dla 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;
}

Inni dostawcy

Dartastic Labs ma mosty dla New Relic, Bugsnag, Embrace, Dynatrace, Honeycomb, Splunk i innych. Wszystkie są w katalogu Dartastic Labs.

Integracje bibliotek dostawcy

Każdy z tych pakietów dostawcy ma odpowiednik w Dartastic Labs, który robi to samo w standardowym OTel.

Obecnie używanyDo dodania
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

Zmiana DSN Sentry

SDK Sentry mówi pewnym protokołem, a Dartastic go rozumie. Wystarczy skierować SDK do Dartastic nowym DSN, a błędy, transakcje i sesje trafią do Observatory. Bez nowego pakietu i bez kodu poza tym jednym ciągiem znaków. Działa każde SDK Sentry, w dowolnym języku.

  1. W Control Room należy otworzyć Sentry DSNs i utworzyć DSN. Wymaga to uprawnienia keys.manage.
  2. Ten DSN należy ustawić tam, gdzie aplikacja ustawia dziś swój DSN Sentry.
  3. Po uruchomieniu aplikacji błędy są widoczne w „Issues”.
dart
await SentryFlutter.init(
  (options) {
    options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
  },
  appRunner: () => runApp(const MyApp()),
);

Co zostaje przeniesione

Z SDK SentryW Dartastic
Błędy i awarieIssues, ze stosem wywołań wysłanym przez SDK
Transakcje i ich spanyTraces
Sesje kondycji wersjiSesje i odsetek sesji bez awarii

Co nie zostaje przeniesione

  • Session Replay i profile. Poziomy odtwarzania sesji są dostępne w Native OTel.
  • Przesyłanie map źródeł i historia problemów w Sentry.
  • Stany problemów, przypisania i reguły alertów samego Sentry. Alerty należy skonfigurować w Dartastic.

Ruch z Sentry liczy się jako ruch przychodzący, jak każdy inny wysłany bajt. Szczegóły: cennik.

Przejście na Native OTel

Ostatni krok zastępuje SDK dostawcy SDK Dartastic, napisanym w Darcie i Ruście. Dopiero tu pojawia się rejestrowanie awarii natywnych, przypisanie janku aż do widgetu, nagrywanie celowane i każdy poziom odtwarzania sesji. Pełna konfiguracja: Dodawanie OpenTelemetry do aplikacji.

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() zastępuje SentryNavigatorObserver() lub DatadogNavigationObserver w navigatorObservers. W miejsce integracji HTTP, gRPC, bazy danych i logowania wchodzą pakiety Dartastic Labs wymienione wyżej.

Rezygnacja z kroku przesyłania symboli

Z buildu należy usunąć sentry_dart_plugin lub datadog-ci flutter-symbols upload. Build powinien być obfuskowany z symbolami, a wersję należy opublikować w prywatnym Dartastic Pub razem z jej .symbols: Dartastic odczytuje je stamtąd, bez kroku przesyłania.

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

Gdzie znaleźć to, co już znane

U dostawcyW Dartastic
Sentry Issues, Datadog Error TrackingIssues
Sentry Release HealthSesje i odsetek sesji bez awarii dla każdego buildu
Datadog RUM ExplorerSessions
Datadog RUM ViewsScreens
Sentry Traces, Datadog APMTraces
Sentry Session Replay, Datadog Session ReplayOdtwarzanie sesji, na wybranym poziomie
Sentry Seer, Bits AIDartastic AI
Sentry Alerts, Datadog MonitorsAlerts

Sentry i Datadog są znakami towarowymi swoich właścicieli, wymienionymi tu, aby ułatwić migrację, a nie sugerować powiązania. Więcej: porównanie Dartastic.