移轉到Dartastic
離開Sentry或Datadog不必重寫程式。Flutter和Dart應用程式有三種移轉途徑,您可以停在其中任何一步。
| 途徑 | 應用程式中需變更的部分 | 您會得到 |
|---|---|---|
| 加入Dartastic Labs橋接套件 | 一個套件、一行程式碼。廠商SDK保持不變,並繼續傳送資料。 | SDK擷取的內容,以標準OTel記錄和span呈現。 |
| 變更您的Sentry DSN | 一個字串。Sentry SDK保持不變,改為傳送到Dartastic。 | 錯誤、交易和工作階段會出現在您的Observatory中。 |
| 改用Native OTel | 取代廠商SDK。 | 全部功能:原生當機、卡頓歸因、每個RUM等級。 |
想先瞭解費用嗎?費用試算工具會試算您的工作負載在Dartastic、Sentry和Datadog上的價格。
加入Dartastic Labs橋接套件
橋接套件是一個Dart套件,會在您的應用程式內,將廠商SDK擷取的內容複製為標準OpenTelemetry。廠商仍會收到目前收到的所有資料,因此您可以同時執行兩者,並以您自己的工作階段進行比較。這些套件來自Dartastic Pub:使用Pub權杖執行dart pub token add https://pub.dartastic.io。
dependencies:
otel_sentry:
hosted: https://pub.dartastic.ioSentry:otel_sentry
在SentryFlutter.init中加入一行。Sentry擷取的每個事件和breadcrumb,也會成為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會繼續執行,因此您的遮蔽和取樣設定維持不變。若breadcrumb流量太大,請傳入bridgeBreadcrumbs: false。
Datadog:otel_datadog
這個橋接套件包裝了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等廠商提供橋接套件。全部列在Dartastic Labs目錄中。
廠商的程式庫整合
以下每個廠商套件都有對應的Dartastic Labs套件,以標準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。不需新增套件,除了那一個字串之外也不需改任何程式碼。任何語言的任何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」 |
| 版本健康狀態工作階段 | 「Sessions」和無當機比率 |
不會轉移的內容
- 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套件。
移除符號上傳步驟
從建置流程中移除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 | 每個建置版本的「Sessions」和無當機比率 |
| 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 | 警示 |
Sentry和Datadog是其各自擁有者的商標,在此提及是為了協助您移轉,並不表示有任何關聯。請參閱Dartastic的比較。