迁移到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。
dependencies:
otel_sentry:
hosted: https://pub.dartastic.ioSentry:otel_sentry
在SentryFlutter.init中加一行代码。Sentry采集的每个事件和面包屑也会成为一条OpenTelemetry日志记录,关联到事发时处于活动状态的链路和Span。
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示例相同。
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_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 |
更换Sentry DSN
您的Sentry SDK使用一种协议通信,而Dartastic能理解这种协议。用新的DSN将SDK指向Dartastic,错误、事务和会话就会进入您的Observatory。无需新的package,除了这一个字符串之外也无需改动代码。任何语言的任何Sentry SDK都适用。
- 在Control Room中打开Sentry DSNs并生成一个DSN。这需要
keys.manage权限。 - 在应用当前设置Sentry DSN的地方填入该DSN。
- 运行应用,然后在“Issues”下查看错误。
await SentryFlutter.init(
(options) {
options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
},
appRunner: () => runApp(const MyApp()),
);迁移过来的数据
| 来自您的Sentry SDK | 在Dartastic中 |
|---|---|
| 错误和崩溃 | “Issues”,附带SDK发送的堆栈 |
| 事务及其Span | Traces |
| 版本健康度会话 | 会话和无崩溃率 |
不会迁移的内容
- Session Replay和性能剖析数据。回放级别随Native OTel提供。
- Source Map上传和您在Sentry中的问题历史。
- Sentry自有的问题状态、分配和告警规则。请在Dartastic中设置告警。
Sentry流量与您发送的其他所有字节一样计入入站流量。请参阅定价。
迁移到Native OTel
最后一步是用Dartastic的SDK(以Dart和Rust编写)替换厂商SDK。从这一步起,您将获得原生崩溃捕获、精确到widget的卡顿归因、定向录制和所有回放级别。完整设置请参阅为您的应用添加OpenTelemetry。
// 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直接从那里读取,无需上传步骤。
flutter build apk --release --obfuscate --split-debug-info=symbols/在哪里找到您熟悉的功能
| 在您的厂商中 | 在Dartastic中 |
|---|---|
| Sentry Issues、Datadog Error Tracking | Issues |
| Sentry Release Health | 每个构建版本的会话和无崩溃率 |
| Datadog RUM Explorer | Sessions |
| Datadog RUM Views | Screens |
| Sentry Traces、Datadog APM | Traces |
| Sentry Session Replay、Datadog Session Replay | 回放,级别由您选择 |
| Sentry Seer、Bits AI | Dartastic AI |
| Sentry Alerts、Datadog Monitors | Alerts |
Sentry和Datadog是其各自所有者的商标,此处提及仅为帮助您迁移,并不暗示任何关联。请参阅Dartastic与其他产品的对比。