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ć.
| Droga | Co zmienia się w aplikacji | Co Państwo zyskują |
|---|---|---|
| Dodanie mostu Dartastic Labs | Jeden 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 Sentry | Jeden ciąg znaków. SDK Sentry zostaje i wysyła dane do Dartastic. | Błędy, transakcje i sesje w Observatory. |
| Przejście na Native OTel | Zastą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.
dependencies:
otel_sentry:
hosted: https://pub.dartastic.ioSentry: 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ł.
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.
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żywany | Do dodania |
|---|---|
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 |
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.
- W Control Room należy otworzyć Sentry DSNs i utworzyć DSN. Wymaga to uprawnienia
keys.manage. - Ten DSN należy ustawić tam, gdzie aplikacja ustawia dziś swój DSN Sentry.
- Po uruchomieniu aplikacji błędy są widoczne w „Issues”.
await SentryFlutter.init(
(options) {
options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
},
appRunner: () => runApp(const MyApp()),
);Co zostaje przeniesione
| Z SDK Sentry | W Dartastic |
|---|---|
| Błędy i awarie | Issues, ze stosem wywołań wysłanym przez SDK |
| Transakcje i ich spany | Traces |
| Sesje kondycji wersji | Sesje 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.
// 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.
flutter build apk --release --obfuscate --split-debug-info=symbols/Gdzie znaleźć to, co już znane
| U dostawcy | W Dartastic |
|---|---|
| Sentry Issues, Datadog Error Tracking | Issues |
| Sentry Release Health | Sesje i odsetek sesji bez awarii dla każdego buildu |
| Datadog RUM Explorer | Sessions |
| Datadog RUM Views | Screens |
| Sentry Traces, Datadog APM | Traces |
| Sentry Session Replay, Datadog Session Replay | Odtwarzanie sesji, na wybranym poziomie |
| Sentry Seer, Bits AI | Dartastic AI |
| Sentry Alerts, Datadog Monitors | Alerts |
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.