Como migrar para a Dartastic
Sair do Sentry ou do Datadog não exige reescrever nada. Para apps Flutter e Dart há três caminhos, e você pode parar em qualquer um deles.
| Caminho | O que muda no seu app | O que você ganha |
|---|---|---|
| Adicionar uma ponte do Dartastic Labs | Um package e uma linha. O SDK do seu fornecedor continua lá, e continua enviando. | O que seu SDK captura, como logs e spans OTel padrão. |
| Trocar seu DSN do Sentry | Uma string. Seu SDK do Sentry continua lá e passa a enviar para a Dartastic. | Erros, transações e sessões no seu Observatory. |
| Migrar para o Native OTel | Substituir o SDK do fornecedor. | Tudo: crashes nativos, atribuição de jank, todos os níveis do RUM. |
Quer ver o custo primeiro? A calculadora calcula o preço da sua carga de trabalho na Dartastic, no Sentry e no Datadog.
Adicionar uma ponte do Dartastic Labs
Uma ponte é um package Dart que copia para o OpenTelemetry padrão, dentro do seu app, o que o SDK do seu fornecedor captura. Seu fornecedor continua recebendo tudo o que recebe hoje, então você pode rodar os dois e comparar com as suas próprias sessões. Os packages vêm do Dartastic Pub: dart pub token add https://pub.dartastic.io com um token do Pub.
dependencies:
otel_sentry:
hosted: https://pub.dartastic.ioSentry: otel_sentry
Uma linha dentro de SentryFlutter.init. Cada evento e breadcrumb que o Sentry captura também vira um registro de log do OpenTelemetry, no trace e no span que estavam ativos quando aconteceu.
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()),
);
}Seus beforeSend e beforeBreadcrumb atuais continuam rodando, então seu mascaramento e sua amostragem ficam como estão. Se os breadcrumbs gerarem tráfego demais, passe bridgeBreadcrumbs: false.
Datadog: otel_datadog
Esta ponte envolve o SDK de RUM do Datadog. Chame rum onde seu código chama DatadogSdk.instance.rum hoje. Cada chamada continua indo para o Datadog e também emite OpenTelemetry: erros, ações e tempos como logs, e cada view como um span. Configure o OTel primeiro com OTel.initialize, como no exemplo do 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;
}Outros fornecedores
O Dartastic Labs tem pontes para New Relic, Bugsnag, Embrace, Dynatrace, Honeycomb, Splunk e outros. Todas estão no catálogo do Dartastic Labs.
As integrações de bibliotecas do seu fornecedor
Cada um destes packages de fornecedor tem um package do Dartastic Labs que faz o mesmo trabalho em OTel padrão.
| Se você usa | Adicione |
|---|---|
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 |
Trocar seu DSN do Sentry
Seu SDK do Sentry fala um protocolo, e a Dartastic o entende. Aponte o SDK para a Dartastic com um novo DSN, e seus erros, transações e sessões chegam ao seu Observatory. Nenhum package novo e nenhum código além dessa única string. Qualquer SDK do Sentry funciona, em qualquer linguagem.
- No Control Room, abra Sentry DSNs e crie um DSN. É preciso ter a permissão
keys.manage. - Defina esse DSN onde seu app define o DSN do Sentry hoje.
- Rode seu app e procure seus erros em “Issues”.
await SentryFlutter.init(
(options) {
options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
},
appRunner: () => runApp(const MyApp()),
);O que vem junto
| Do seu SDK do Sentry | Na Dartastic |
|---|---|
| Erros e crashes | “Issues”, com o stack trace que seu SDK enviou |
| Transações e seus spans | Traces |
| Sessões de saúde das versões | Sessões e taxa de sessões sem crash |
O que fica para trás
- O Session Replay e o profiling. Os níveis de replay vêm com o Native OTel.
- Os uploads de source maps e o histórico de problemas do Sentry.
- Os estados, as atribuições e as regras de alerta dos problemas no próprio Sentry. Configure os alertas na Dartastic.
O tráfego do Sentry conta como tráfego de entrada, como qualquer outro byte que você envia. Veja os preços.
Migrar para o Native OTel
O último passo substitui o SDK do fornecedor pelo da Dartastic, escrito em Dart e Rust. É aqui que você ganha captura de crashes nativos, atribuição de jank até o widget, gravação direcionada e todos os níveis de replay. Como adicionar o OpenTelemetry ao seu app traz a configuração 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() substitui SentryNavigatorObserver() ou DatadogNavigationObserver em navigatorObservers. Suas integrações de HTTP, gRPC, banco de dados e logging passam a ser os packages do Dartastic Labs acima.
Remova sua etapa de upload de símbolos
Tire sentry_dart_plugin ou datadog-ci flutter-symbols upload do seu build. Faça o build ofuscado com símbolos e publique a versão no seu Dartastic Pub privado junto com .symbols: a Dartastic os lê de lá, sem etapa de upload.
flutter build apk --release --obfuscate --split-debug-info=symbols/Onde encontrar o que você já conhece
| No seu fornecedor | Na Dartastic |
|---|---|
| Sentry Issues, Datadog Error Tracking | Issues |
| Sentry Release Health | Sessões e taxa de sessões sem crash por build |
| Datadog RUM Explorer | Sessions |
| Datadog RUM Views | Screens |
| Sentry Traces, Datadog APM | Traces |
| Sentry Session Replay, Datadog Session Replay | Replay, no nível que você escolher |
| Sentry Seer, Bits AI | Dartastic AI |
| Sentry Alerts, Datadog Monitors | Alerts |
Sentry e Datadog são marcas registradas de seus respectivos proprietários, citadas aqui para ajudar na sua migração, sem implicar nenhuma afiliação. Veja como a Dartastic se compara.