這些頁面顯示的是Cloud的URL。在Dedicated上登入後,就會顯示您伺服器的URL。

移轉到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。

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

Sentry:otel_sentry

在SentryFlutter.init中加入一行。Sentry擷取的每個事件和breadcrumb,也會成為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會繼續執行,因此您的遮蔽和取樣設定維持不變。若breadcrumb流量太大,請傳入bridgeBreadcrumbs: false。

Datadog:otel_datadog

這個橋接套件包裝了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等廠商提供橋接套件。全部列在Dartastic Labs目錄中。

廠商的程式庫整合

以下每個廠商套件都有對應的Dartastic Labs套件,以標準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。不需新增套件,除了那一個字串之外也不需改任何程式碼。任何語言的任何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傳送的堆疊追蹤
交易及其span「Traces」
版本健康狀態工作階段「Sessions」和無當機比率

不會轉移的內容

  • 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套件。

移除符號上傳步驟

從建置流程中移除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 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 AIDartastic AI
Sentry Alerts、Datadog Monitors警示

Sentry和Datadog是其各自擁有者的商標,在此提及是為了協助您移轉,並不表示有任何關聯。請參閱Dartastic的比較。