仕組み
Native SDKはエラーを検出すると、Dartastic Symbolizerを呼び出して、エラーにソースコードの位置情報を付加できます。オブザーバビリティプラットフォームには、ソースコードの該当行を指し示したエラーが自動で届きます。
デバッグシンボル(またはソースマップ)とアプリがあれば、ソースコードがわかります。それらをオブザーバビリティベンダーにアップロードすると、知的財産への攻撃対象が増えるうえ、DevOpsの手間もかかります。
シンボルは、パッケージを公開しているDartastic Pubに保管しましょう。知的財産を誰が見られるかを、お客様自身が管理できます。
スタックトレースの問題、解決。
難読化された本番環境のスタックトレースを送ると、実際の関数名とソースコードの行番号に置き換わった同じトレースが返ってきます。シンボルはDartastic Pubサーバーに置いたままで、オブザーバビリティベンダーに別途アップロードする必要がないため、知的財産に対する攻撃対象領域を減らせます。


OTLPに対応したあらゆるプラットフォームで使えます。Dartastic Native OTel SDKは、スパンのエラーやクラッシュの後にDartastic Symbolizerを呼び出し、エクスポーターの手前でトレースを書き換えます。そのため、オブザーバビリティプラットフォームに届くのは意味不明な文字列ではなく、問題に関わるソースコードの行を指す、人が読めるスタックトレースです。
メリット
- 読めるエラーが、ワークフロー全体を動かす。 ファイルと行を示すエラーは、トリアージして担当を割り当て、昼までに修正できるチケットになります。シンボル化は、本番環境を眺めるだけか、理解できるかの違いです。一度使えば、これなしでどう出荷していたのか不思議に思うはずです。
- 自動です。公開すれば完了。
flutter build apk --release --obfuscate --split-debug-info=symbols/でビルドし、.symbolsを添えてリリースをプライベートなDartastic Pubに公開します。Dartastic Symbolizerは、アプリ、バージョン、プラットフォームごとに正確なシンボルを自分で見つけます。バージョン1.4.0のエラーは、何年後でも読めるままです。 - SentryやCrashlyticsより簡単。 それらのプラットフォームでは、デバッグシンボルを、プラットフォームごとに、リリースのたびに、自分で構築して面倒を見るCIのステップとしてアップロードする必要があります。Dartasticなら、その手間がすべて不要です。シンボルはすでに手元にあります。
- しかも、より安全。 デバッグシンボルはソースコードへの地図であり、ベンダーにアップロードすると、知的財産に対する攻撃対象領域が広がります。Dartasticなら、シンボルはお客様のキーで守られたプライベートPubに置いたままです。オブザーバビリティベンダーが目にするのは、わかりやすく読めるテキストだけです。
- お気に入りのプラットフォームでそのまま動く。 OTLPに対応したあらゆるプラットフォームに、エラーがソースコードの行付きで届きます:Datadog、Honeycomb、Dartastic Dedicated、そしてSentry自体にも。ベンダー側にインストールするものはなく、連携の対応を待つ必要もありません。
- トレースの一部として、ミリ秒で。 シンプルなAPIが一つだけ。キャッシュされた検索はミリ秒で応答し、すべてのレスポンスに当月の利用量が含まれます。まるで、トレースが最初から難読化されていなかったかのようです。
シンボルはビルドシステムの一部のまま。
多くのチームは、.symbols / .dSYMを別のステップとしてDatadog、Sentryなどにアップロードしています。それは、ソースコードを再構築するための鍵をベンダーに渡すことです。Dartastic Symbolizerはシンボルファイルをpub.dartastic.ioの中に置いたまま、難読化を解除したテキストだけを下流に出力します。
オンプレミスの選択肢(コンプライアンス)
規制の厳しいワークフローでは、厳重に管理されたDartastic Dedicatedプラットフォームの一部として、Dartastic Symbolizerを自社の境界の内側で実行できます。本番環境のトレースが、お客様のネットワークの外に出ることはありません。
Dartastic Pubから自動取得
flutter build apk --release --obfuscate --split-debug-info=symbols/でFlutterアプリをpub.dartastic.ioに公開すると、Dartastic Symbolizerは最初のキャッシュミスのときにアーカイブをダウンロードします。2回目のアップロードの手順はありません。
Dartastic Symbolizerを入手
Dartastic Symbolizerは、OTel ProとDartastic Observatoryに含まれます。合ったプランを選べば、Dartastic Symbolizerが付いてきます。