Chuyển sang Dartastic
Rời Sentry hoặc Datadog không nhất thiết phải viết lại từ đầu. Với ứng dụng Flutter và Dart có ba cách, và bạn có thể dừng ở bất kỳ cách nào.
| Cách | Thay đổi trong ứng dụng | Bạn nhận được |
|---|---|---|
| Thêm một bridge Dartastic Labs | Một package và một dòng mã. SDK của nhà cung cấp vẫn giữ nguyên và tiếp tục gửi dữ liệu. | Những gì SDK của bạn thu thập, dưới dạng log và span OTel chuẩn. |
| Đổi Sentry DSN | Một chuỗi. Sentry SDK vẫn giữ nguyên và gửi đến Dartastic. | Lỗi, transaction và phiên trong Observatory của bạn. |
| Chuyển sang Native OTel | Thay SDK của nhà cung cấp. | Mọi thứ: crash native, xác định nguồn gây jank, mọi mức RUM. |
Muốn biết chi phí trước? Công cụ tính chi phí ước tính chi phí cho khối lượng sử dụng của bạn trên Dartastic, Sentry và Datadog.
Thêm một bridge Dartastic Labs
Bridge là một package Dart sao chép những gì SDK của nhà cung cấp thu thập sang OpenTelemetry chuẩn, ngay bên trong ứng dụng của bạn. Nhà cung cấp vẫn nhận đủ mọi thứ như hiện nay, nên bạn có thể chạy song song cả hai và so sánh trên chính các phiên của mình. Các package lấy từ Dartastic Pub: dart pub token add https://pub.dartastic.io với một token Pub.
dependencies:
otel_sentry:
hosted: https://pub.dartastic.ioSentry: otel_sentry
Một dòng bên trong SentryFlutter.init. Mọi event và breadcrumb mà Sentry thu thập cũng trở thành một bản ghi log OpenTelemetry, gắn với trace và span đang hoạt động lúc nó xảy ra.
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 và beforeBreadcrumb hiện có của bạn vẫn chạy, nên cách che dữ liệu và lấy mẫu của bạn giữ nguyên. Nếu breadcrumb tạo quá nhiều lưu lượng, truyền bridgeBreadcrumbs: false.
Datadog: otel_datadog
Bridge này bọc RUM SDK của Datadog. Gọi rum ở chỗ mã của bạn đang gọi DatadogSdk.instance.rum. Mỗi lệnh gọi vẫn đến Datadog, đồng thời phát ra OpenTelemetry: lỗi, hành động và số đo thời gian dưới dạng log, mỗi view là một span. Thiết lập OTel bằng OTel.initialize trước, như trong ví dụ 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;
}Các nhà cung cấp khác
Dartastic Labs có bridge cho New Relic, Bugsnag, Embrace, Dynatrace, Honeycomb, Splunk và nhiều nhà cung cấp khác. Tất cả đều có trong danh mục Dartastic Labs.
Các tích hợp thư viện của nhà cung cấp
Mỗi package này của nhà cung cấp đều có một package Dartastic Labs làm cùng việc đó bằng OTel chuẩn.
| Nếu bạn dùng | Thêm |
|---|---|
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 |
Đổi Sentry DSN
Sentry SDK của bạn dùng một giao thức, và Dartastic hiểu giao thức đó. Trỏ SDK đến Dartastic bằng một DSN mới, và lỗi, transaction, phiên của bạn xuất hiện trong Observatory. Không thêm package nào, và không thêm mã nào ngoài một chuỗi đó. Mọi Sentry SDK đều dùng được, bằng mọi ngôn ngữ.
- Trong Control Room, mở “Sentry DSNs” và tạo một DSN. DSN cần quyền
keys.manage. - Đặt DSN đó ở chỗ ứng dụng của bạn đang đặt Sentry DSN.
- Chạy ứng dụng và tìm lỗi trong “Issues”.
await SentryFlutter.init(
(options) {
options.dsn = const String.fromEnvironment('DARTASTIC_SENTRY_DSN');
},
appRunner: () => runApp(const MyApp()),
);Những gì được chuyển sang
| Từ Sentry SDK của bạn | Trong Dartastic |
|---|---|
| Lỗi và crash | Issues, kèm stack trace mà SDK của bạn gửi |
| Transaction và span của chúng | Traces |
| Phiên Release Health | Sessions và tỷ lệ phiên không crash |
Những gì ở lại
- Session Replay và profile. Các mức phát lại đi kèm Native OTel.
- Việc tải source map lên và lịch sử vấn đề trên Sentry.
- Trạng thái vấn đề, việc phân công và quy tắc cảnh báo riêng của Sentry. Thiết lập cảnh báo trong Dartastic.
Lưu lượng Sentry được tính là dữ liệu vào, như mọi byte khác bạn gửi. Xem bảng giá.
Chuyển sang Native OTel
Bước cuối thay SDK của nhà cung cấp bằng SDK của Dartastic, viết bằng Dart và Rust. Đây là lúc bạn có bắt crash native, xác định nguồn gây jank đến tận widget, ghi có chọn lọc và mọi mức phát lại. Thêm OTel vào ứng dụng của bạn có hướng dẫn thiết lập đầy đủ.
// 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);DartasticViewObserver() thay cho SentryNavigatorObserver() hoặc DatadogNavigationObserver trong navigatorObservers. Các tích hợp HTTP, gRPC, cơ sở dữ liệu và logging của bạn trở thành các package Dartastic Labs ở trên.
Bỏ bước tải symbol lên
Xóa sentry_dart_plugin hoặc datadog-ci flutter-symbols upload khỏi quy trình build. Build có làm rối mã và kèm symbol, rồi xuất bản bản phát hành lên Dartastic Pub riêng tư của bạn cùng .symbols: Dartastic đọc symbol từ đó, không cần bước tải lên.
flutter build apk --release --obfuscate --split-debug-info=symbols/Tìm những gì bạn đã quen
| Ở nhà cung cấp của bạn | Trong Dartastic |
|---|---|
| Sentry Issues, Datadog Error Tracking | Issues |
| Sentry Release Health | Sessions và tỷ lệ phiên không crash cho từng build |
| Datadog RUM Explorer | Sessions |
| Datadog RUM Views | Screens |
| Sentry Traces, Datadog APM | Traces |
| Sentry Session Replay, Datadog Session Replay | Phát lại phiên, ở mức bạn chọn |
| Sentry Seer, Bits AI | Dartastic AI |
| Sentry Alerts, Datadog Monitors | Alerts |
Sentry và Datadog là nhãn hiệu của chủ sở hữu tương ứng, được nêu ở đây để giúp bạn chuyển đổi, không hàm ý có liên kết. Xem Dartastic so sánh thế nào.