Dartasticへの移行
SentryやDatadogからの移行に、書き直しは必要ありません。FlutterとDartのアプリには3つの方法があり、どの段階で止めてもかまいません。
| 方法 | アプリで変わること | 得られるもの |
|---|---|---|
| Dartastic Labsのブリッジを追加 | パッケージ1つとコード1行。ベンダーのSDKはそのまま残り、送信も続けます。 | SDKが取得したデータを、標準のOTelのログとスパンで |
| Sentry DSNを変更 | 文字列1つ。Sentry SDKはそのままで、Dartasticに送信します。 | エラー、トランザクション、セッションをObservatoryで |
| Native OTelに移行 | ベンダーのSDKを置き換え | すべて:ネイティブクラッシュ、ジャンクの原因特定、すべてのRUMレベル |
まず費用を知りたい場合は、料金計算ツールで、お客様のワークロードに対するDartastic、Sentry、Datadogの費用を試算できます。
Dartastic Labsのブリッジを追加
ブリッジは、ベンダーのSDKが取得したデータを、アプリ内で標準のOpenTelemetryにコピーするDartパッケージです。ベンダーには今までどおりすべてのデータが届くため、両方を並行して動かし、実際のセッションで比較できます。パッケージはDartastic Pubから提供されます:Pubトークンでdart pub token add https://pub.dartastic.ioを実行してください。
dependencies:
otel_sentry:
hosted: https://pub.dartastic.ioSentry:otel_sentry
SentryFlutter.initの中に1行追加します。Sentryが取得するすべてのイベントとブレッドクラムは、発生時にアクティブだったトレースとスパン上の、OpenTelemetryのログレコードにもなります。
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
このブリッジは、DatadogのRUM SDKをラップします。現在コードでDatadogSdk.instance.rumを呼び出している箇所で、rumを呼び出してください。各呼び出しは引き続きDatadogに送られ、同時にOpenTelemetryも出力します:エラー、アクション、タイミングはログとして、各ビューはスパンとして。まず、Sentryの例と同様に、OTel.initializeでOTelを設定してください。
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カタログに掲載されています。
ベンダーのライブラリ連携
これらのベンダーパッケージには、それぞれ標準のOTelで同じ役割を果たすDartastic Labsパッケージがあります。
| 使用中のパッケージ | 追加するパッケージ |
|---|---|
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に届きます。新しいパッケージは不要で、コードの変更もその文字列1つだけです。どの言語のどの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が送信したスタックトレース付き) |
| トランザクションとそのスパン | Traces |
| Release Healthのセッション | Sessionsとクラッシュフリー率 |
引き継がれないもの
- Session Replayとプロファイル。リプレイレベルはNative OTelで利用できます。
- ソースマップのアップロードと、Sentryの問題の履歴。
- Sentry独自の問題のステータス、担当者の割り当て、アラートルール。アラートはDartasticで設定してください。
Sentryのトラフィックは、送信される他のすべてのバイトと同じく、受信データとして計上されます。詳しくは料金ページをご覧ください。
Native OTelに移行
最後のステップでは、ベンダーのSDKを、DartとRustで書かれたDartasticのSDKに置き換えます。ここで、ネイティブクラッシュの取得、ウィジェット単位までのジャンクの原因特定、対象を絞った記録、すべてのリプレイレベルが利用できるようになります。詳しい設定手順はアプリに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では、SentryNavigatorObserver()やDatadogNavigationObserverの代わりにDartasticViewObserver()を使います。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との比較もご覧ください。