Dartastic SymbolizerDartastic Symbolizer

從正式環境錯誤直達原始碼行。

Dartastic Symbolizer以私密的方式,將正式環境的錯誤轉換為可直接處理的原始碼行。

經過Dartastic Symbolizer處理的Flutter錯誤span:含有函式名稱和原始碼行的真實堆疊框架

運作方式

Native SDK偵測到錯誤時,可以呼叫Dartastic Symbolizer,為錯誤補上原始碼位置。您的可觀測性平台收到的錯誤,會自動指出確切的原始碼行。

偵錯符號(或source map)加上您的應用程式,就等於您的原始碼。將它們上傳到可觀測性廠商,不但增加智慧財產外洩的攻擊面,還徒增DevOps的負擔。

將符號保存在您發布套件的地方,也就是Dartastic Pub,由您掌控誰能看到您的智慧財產。

堆疊追蹤,迎刃而解。

送出經過模糊處理的正式環境堆疊追蹤,就能取回同一份追蹤,附上真實的函式名稱和原始碼行號。符號檔留在您的Dartastic Pub伺服器中,不必另外上傳給可觀測性廠商,減少智慧財產的攻擊面。

經過模糊處理 · 來自正式環境
Dartastic Observatory的span事件:一個未符號化的Flutter當機,只顯示build_id和_kDartIsolateInstructions中的原始指令位移
已符號化 · 透過Dartastic Symbolizer
經過Dartastic Symbolizer處理後的同一個span事件:含有函式名稱和原始碼行的真實堆疊框架,例如位於symbolizer_demo.dart:157:7的_SymbolizerDemoPageState._validateQuantity

適用於任何相容OTLP的平台。Dartastic Native OTel SDK會在span發生錯誤或當機後呼叫Dartastic Symbolizer,並在匯出工具的上游改寫追蹤,因此您的可觀測性平台看到的不再是天書,而是人類可讀、指向問題相關原始碼行的堆疊追蹤。

Dartastic Symbolizer如何將經過模糊處理的當機轉換為原始碼行 端對端,都在同一個追蹤span內完成。不需要第二套工具,也不必複製貼上。 Flutter應用程式OTel CollectorDartastic Pub私有符號儲存庫Dartastic SymbolizerWeb APIsymbolizer.dartastic.ioDartastic Observatory1. 錯誤span2. 錯誤、應用程式版本3. 建置資訊4. .symbols5. 原始碼堆疊追蹤 所有流量皆經TLS加密 · 依套件限定API金鑰範圍 · 符號檔始終屬於您
沒有使用Dartastic Observatory? 從您自己的整合呼叫同一個Web API。您的符號檔絕不會離開您的Pub。 您的整合例如錯誤追蹤工具Dartastic SymbolizerWeb APIsymbolizer.dartastic.ioDartastic Pub私有符號儲存庫1. 錯誤、應用程式版本2. 錯誤、建置資訊3. .symbols4. 原始碼堆疊追蹤 一次HTTPS呼叫 · 符號檔留在您的私有Pub

優勢

  • 可讀的錯誤,推動整個工作流程。 能指出檔案和行號的錯誤,就是一個午餐前就能分類、指派並修正的issue。符號化決定了您只是在看著正式環境,還是真正理解它。團隊一旦用上,就會納悶以前沒有它是怎麼發布的。
  • 全自動。發布即完成。 使用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 Symbolizer,作為封閉管控的Dartastic Dedicated平台的一部分。正式環境的追蹤永遠不會離開客戶的網路。

從Dartastic Pub自動擷取

使用flutter build apk --release --obfuscate --split-debug-info=symbols/將Flutter應用程式發布到pub.dartastic.io;Dartastic Symbolizer會在第一次快取未命中時下載封存檔。不需要第二次上傳步驟。

取得Dartastic Symbolizer

OTel Pro和Dartastic Observatory皆已包含Dartastic Symbolizer。選擇適合的方案,就會附帶Dartastic Symbolizer。