這些頁面顯示的是Cloud的URL。在Dedicated上登入後,就會顯示您伺服器的URL。

總覽

Dartastic讓您看見Dart和Flutter應用程式在使用者手中的真實表現,並協助您修正出錯的地方。本頁是一張地圖。讀過一次後,再依照開始使用逐步進行。

平台

每個說明頁面都會顯示同一張圖,並標亮該頁涵蓋的部分,讓您隨時知道自己的位置。

建置DARTASTIC架構使用者權杖issuePub權杖pushCI交換應用程式交付給使用者:應用程式商店、Web、伺服器符號當機堆疊追蹤原始碼遙測開發者電腦flutter run · dart pub getCIGitHub Actions、GitLab…Control Room建立權杖 · 角色型存取控制控制平面組織 · 角色 · 權杖Dartastic Pub套件 · 原始碼Observatory工作階段 · 追蹤 · 記錄Symbolizer當機 → 原始碼行Dartastic AI綜合兩者作答Issue追蹤系統GitHub · Jira · Linear行動與桌面應用程式手機 · 平板 · 桌機以OTLP權杖傳送Web應用程式在瀏覽器中以Browser OTLP權杖傳送Dart伺服器後端 · 服務以OTLP權杖傳送
  1. 您在自己的電腦和CI中建置。您的應用程式從Dartastic Pub取得Dartastic套件,就像從pub.dev取得套件一樣。
  2. 應用程式執行時,無論是在手機、桌面裝置、瀏覽器中,或作為Dart伺服器,其中的Dartastic OTel套件都會記錄發生的事,並傳送到Observatory。
  3. 出問題時,Symbolizer會使用您隨應用程式發布到Pub的符號,將當機還原成您的檔案和行號。
  4. 想知道原因時,就詢問Dartastic AI。它會讀取遙測資料和您在Pub上的原始碼,回答原因並提出修正。
  5. Control Room是您設定這一切的地方:它建立的權杖,開啟圖中的每一個箭頭。

各個組成

組成用途在哪裡使用
Control Room您的帳戶。您在這裡建立權杖、邀請團隊成員、選擇方案,以及下載Reference Demo。登入後的dartastic.io/control-room
Dartastic Pub運作方式和pub.dev相同的私有套件登錄服務。您從這裡取得Dartastic套件、存放自己的私有套件,並將應用程式的原始碼發布到這裡。dart pub get, dart pub publish
Dartastic OTel您加入應用程式的套件。它們以OpenTelemetry記錄應用程式中發生的事(畫面、點擊、網路呼叫、錯誤、當機、效能),並傳送出去。您的pubspec.yaml和main()
Observatory您查看資料的地方。針對應用程式傳送的一切,提供含重播的工作階段、追蹤、記錄、指標、當機、儀表板和警示。從Control Room開啟
Symbolizer將經過模糊處理的發行建置版本中難以閱讀的堆疊追蹤,還原成您的檔案名稱和行號。當機資料抵達時,它會自動執行。無需呼叫:它會讀取您發布到Pub的符號
Dartastic AI以日常語言回答關於應用程式的問題。它會讀取您的遙測資料和Pub上的原始碼,找出原因並提出修正。Observatory和Control Room中的「Ask」按鈕

您會看到的內容

這就是Observatory。使用者的每個工作階段都會列出,並附上其畫面、點擊、錯誤和挫折訊號:

Observatory的「Sessions」清單,每個使用者工作階段一列

開啟其中一個並重播。在播放位置下方,您會看到當下的追蹤、記錄和錯誤,還能直接跳到對應的程式碼行:

工作階段重播,包含時間軸、播放位置下的追蹤及其記錄

權杖串連各個組成

圖中的每個箭頭都需要各自類型的權杖。權杖在Control Room中建立,每個權杖只會顯示一次,因此請在建立時複製。大多數開發者從未搭配dart pub使用過權杖;Pub頁面會逐步引導您。

權杖來源目的地用途
Pub權杖您的電腦Dartastic Pubdart pub get可下載Dartastic套件和您的私有套件;dart pub publish可上傳。
CI交換您的CIDartastic Pub您的CI不需儲存任何權杖,就能讀取及發布套件。
OTLP權杖手機或桌面裝置上的應用程式、您的Dart伺服器Observatory讓您的應用程式傳送遙測資料。
Browser OTLP權杖您的Flutter網頁應用程式Observatory讓您的網頁應用程式傳送遙測資料,且僅限您列出的網站。

您持有的所有權杖都列在同一個畫面上。權杖說明每種權杖,以及如何撤銷或更換。

執行位置:您的方案

  • Cloud在Dartastic與其他客戶共用的基礎架構上執行。您的Pub位於pub.dartastic.io。
  • Dedicated為您的組織提供專屬伺服器,位於您選擇的子網域:您的Pub位於pub.<subdomain>.dartastic.io。
  • Self-Hosted在您自己的網路內執行整個平台。

每個方案的步驟都相同。網址不同之處,這些頁面會同時列出兩者。比較方案。

需要準備的項目

  • 要使用所有功能,需要Flutter 3.44和Dart 3.12或更新版本;Flutter 3.22和Dart 3.4可使用Flutter指標以外的所有功能。各套件需要的版本。
  • Dartastic帳戶:免費註冊。註冊後,您的組織會從Cloud Free開始,不需要信用卡。
  • 僅Reference Demo的天氣後端需要:Docker。

學習方式

選擇適合您的方式;它們涵蓋相同的內容。

  • 依序閱讀這些頁面。每頁底部的「上一頁」和「下一頁」會帶您往下讀。
  • 執行Dartastic OTel Reference Demo。它是開源Dart OTel Reference Demo的商業加強版:包含更多示範,都是可實際執行的Flutter應用程式,展示Dartastic每項功能的用法,設定都已完成。閱讀它的程式碼、從中複製,或讓您的AI程式設計助理參考它。取得Reference Demo。
  • 提問:支援團隊會回答您的問題。

這些頁面使用的用語

OpenTelemetry(OTel)
記錄軟體行為的開放標準。Dartastic從頭到尾都採用它,因此您寫的任何程式碼都不會被Dartastic綁定。
OTLP
OpenTelemetry的傳輸格式:應用程式傳送所記錄資料的方式。
追蹤和span
span是一段計時的工作(一次點擊、一次網路呼叫、一次資料庫查詢)。追蹤是同一項作業的span所組成的樹,即使橫跨您的應用程式和伺服器也一樣。
記錄
應用程式寫下的一行文字,與其發生時所在的追蹤相連。
指標
隨時間量測的數值:影格時間、記憶體、請求數。
工作階段
一個人使用您應用程式的一次造訪,從啟動到離開,包含其中的每個畫面、點擊、錯誤和追蹤。
重播
回看一個工作階段。擷取多少內容由您決定:事件時間軸、線框,或真實像素。
RUM
真實使用者監控:來自真正在使用您應用程式的人的遙測資料,而非來自測試。
模糊處理和符號
發行建置版本可以打亂其名稱(flutter build --obfuscate)。它寫出的符號檔(--split-debug-info)就是還原名稱的鑰匙。
權杖
一串很長的機密字串,讓一個元件能與另一個元件溝通。每種權杖開啟上圖中的一條路徑。