Estas páginas mostram as URLs do Cloud. Faça login no Dedicated e elas passam a mostrar as do seu servidor.

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.

CaminhoO que muda no seu appO que você ganha
Adicionar uma ponte do Dartastic LabsUm 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 SentryUma 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 OTelSubstituir 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.

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

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

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

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.

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

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ê usaAdicione
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

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.

  1. No Control Room, abra Sentry DSNs e crie um DSN. É preciso ter a permissão keys.manage.
  2. Defina esse DSN onde seu app define o DSN do Sentry hoje.
  3. Rode seu app e procure seus erros em “Issues”.
dart
await SentryFlutter.init(
  (options) {
    options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
  },
  appRunner: () => runApp(const MyApp()),
);

O que vem junto

Do seu SDK do SentryNa Dartastic
Erros e crashes“Issues”, com o stack trace que seu SDK enviou
Transações e seus spansTraces
Sessões de saúde das versõesSessõ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.

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

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

Onde encontrar o que você já conhece

No seu fornecedorNa Dartastic
Sentry Issues, Datadog Error TrackingIssues
Sentry Release HealthSessões e taxa de sessões sem crash por build
Datadog RUM ExplorerSessions
Datadog RUM ViewsScreens
Sentry Traces, Datadog APMTraces
Sentry Session Replay, Datadog Session ReplayReplay, no nível que você escolher
Sentry Seer, Bits AIDartastic AI
Sentry Alerts, Datadog MonitorsAlerts

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.