这些页面显示的是Cloud的URL。在Dedicated上登录后,即显示您服务器的URL。

迁移到Dartastic

离开Sentry或Datadog不必重写代码。Flutter和Dart应用有三种迁移路线,您可以在任何一步停下。

路线应用中需要改动的内容您获得的功能
添加Dartastic Labs桥接package一个package加一行代码。厂商SDK保留不变,并继续发送数据。SDK采集的数据,以标准OTel日志和Span的形式呈现。
更换Sentry DSN一个字符串。Sentry SDK保留不变,改为发送到Dartastic。错误、事务和会话出现在您的Observatory中。
迁移到Native OTel替换厂商SDK。全部功能:原生崩溃、卡顿归因、所有RUM级别。

想先了解费用?费用计算器可按Dartastic、Sentry和Datadog分别估算您的工作负载费用。

添加Dartastic Labs桥接package

桥接package是一个Dart package,它在您的应用内把厂商SDK采集的数据复制为标准OpenTelemetry数据。厂商仍会收到它现在收到的全部数据,因此您可以同时运行两者,并在自己的会话上进行对比。这些package来自Dartastic Pub:使用Pub令牌执行dart pub token add https://pub.dartastic.io。

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

Sentry:otel_sentry

在SentryFlutter.init中加一行代码。Sentry采集的每个事件和面包屑也会成为一条OpenTelemetry日志记录,关联到事发时处于活动状态的链路和Span。

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

您现有的beforeSend和beforeBreadcrumb会继续运行,因此脱敏和采样逻辑保持不变。如果面包屑带来的流量过多,请传入bridgeBreadcrumbs: false。

Datadog:otel_datadog

此桥接package封装了Datadog的RUM SDK。在代码中目前调用DatadogSdk.instance.rum的地方改为调用rum。每次调用仍会发送到Datadog,同时生成OpenTelemetry数据:错误、操作和耗时记录为日志,每个视图记录为一个Span。请先用OTel.initialize设置OTel,方法与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;
}

其他厂商

Dartastic Labs为New Relic、Bugsnag、Embrace、Dynatrace、Honeycomb、Splunk等厂商提供桥接package。它们都在Dartastic Labs目录中。

厂商的库集成

以下每个厂商package都有一个对应的Dartastic Labs package,以标准OTel完成同样的工作。

如果您使用请添加
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

更换Sentry DSN

您的Sentry SDK使用一种协议通信,而Dartastic能理解这种协议。用新的DSN将SDK指向Dartastic,错误、事务和会话就会进入您的Observatory。无需新的package,除了这一个字符串之外也无需改动代码。任何语言的任何Sentry SDK都适用。

  1. 在Control Room中打开Sentry DSNs并生成一个DSN。这需要keys.manage权限。
  2. 在应用当前设置Sentry DSN的地方填入该DSN。
  3. 运行应用,然后在“Issues”下查看错误。
dart
await SentryFlutter.init(
  (options) {
    options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
  },
  appRunner: () => runApp(const MyApp()),
);

迁移过来的数据

来自您的Sentry SDK在Dartastic中
错误和崩溃“Issues”,附带SDK发送的堆栈
事务及其SpanTraces
版本健康度会话会话和无崩溃率

不会迁移的内容

  • Session Replay和性能剖析数据。回放级别随Native OTel提供。
  • Source Map上传和您在Sentry中的问题历史。
  • Sentry自有的问题状态、分配和告警规则。请在Dartastic中设置告警。

Sentry流量与您发送的其他所有字节一样计入入站流量。请参阅定价。

迁移到Native OTel

最后一步是用Dartastic的SDK(以Dart和Rust编写)替换厂商SDK。从这一步起,您将获得原生崩溃捕获、精确到widget的卡顿归因、定向录制和所有回放级别。完整设置请参阅为您的应用添加OpenTelemetry。

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

在navigatorObservers中,用DartasticViewObserver()替代SentryNavigatorObserver()或DatadogNavigationObserver。您的HTTP、gRPC、数据库和日志集成改用上文的Dartastic Labs package。

去掉符号上传步骤

从构建中移除sentry_dart_plugin或datadog-ci flutter-symbols upload。构建带符号的混淆版本,并将该版本连同其.symbols发布到您的私有Dartastic Pub:Dartastic直接从那里读取,无需上传步骤。

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

在哪里找到您熟悉的功能

在您的厂商中在Dartastic中
Sentry Issues、Datadog Error TrackingIssues
Sentry Release Health每个构建版本的会话和无崩溃率
Datadog RUM ExplorerSessions
Datadog RUM ViewsScreens
Sentry Traces、Datadog APMTraces
Sentry Session Replay、Datadog Session Replay回放,级别由您选择
Sentry Seer、Bits AIDartastic AI
Sentry Alerts、Datadog MonitorsAlerts

Sentry和Datadog是其各自所有者的商标,此处提及仅为帮助您迁移,并不暗示任何关联。请参阅Dartastic与其他产品的对比。