このヘルプにはCloudのURLが表示されています。Dedicatedでログインすると、お客様のサーバーのURLが表示されます。

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を実行してください。

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

Sentry:otel_sentry

SentryFlutter.initの中に1行追加します。Sentryが取得するすべてのイベントとブレッドクラムは、発生時にアクティブだったトレースとスパン上の、OpenTelemetryのログレコードにもなります。

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

このブリッジは、DatadogのRUM SDKをラップします。現在コードでDatadogSdk.instance.rumを呼び出している箇所で、rumを呼び出してください。各呼び出しは引き続きDatadogに送られ、同時にOpenTelemetryも出力します:エラー、アクション、タイミングはログとして、各ビューはスパンとして。まず、Sentryの例と同様に、OTel.initializeでOTelを設定してください。

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カタログに掲載されています。

ベンダーのライブラリ連携

これらのベンダーパッケージには、それぞれ標準のOTelで同じ役割を果たすDartastic Labsパッケージがあります。

使用中のパッケージ追加するパッケージ
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に届きます。新しいパッケージは不要で、コードの変更もその文字列1つだけです。どの言語のどの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が送信したスタックトレース付き)
トランザクションとそのスパンTraces
Release HealthのセッションSessionsとクラッシュフリー率

引き継がれないもの

  • Session Replayとプロファイル。リプレイレベルはNative OTelで利用できます。
  • ソースマップのアップロードと、Sentryの問題の履歴。
  • Sentry独自の問題のステータス、担当者の割り当て、アラートルール。アラートはDartasticで設定してください。

Sentryのトラフィックは、送信される他のすべてのバイトと同じく、受信データとして計上されます。詳しくは料金ページをご覧ください。

Native OTelに移行

最後のステップでは、ベンダーのSDKを、DartとRustで書かれたDartasticのSDKに置き換えます。ここで、ネイティブクラッシュの取得、ウィジェット単位までのジャンクの原因特定、対象を絞った記録、すべてのリプレイレベルが利用できるようになります。詳しい設定手順はアプリに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では、SentryNavigatorObserver()やDatadogNavigationObserverの代わりにDartasticViewObserver()を使います。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 TrackingIssues
Sentry Release HealthビルドごとのSessionsとクラッシュフリー率
Datadog RUM ExplorerSessions
Datadog RUM ViewsScreens
Sentry Traces、Datadog APMTraces
Sentry Session Replay、Datadog Session Replayリプレイ(レベルは選択可能)
Sentry Seer、Bits AIDartastic AI
Sentry Alerts、Datadog Monitorsアラート

SentryおよびDatadogは、各所有者の商標です。ここでは移行の参考として名前を挙げており、提携関係を示すものではありません。Dartasticとの比較もご覧ください。