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

Dartastic OTel Reference Demo

一組可實際執行的Flutter應用程式,展示Dartastic的每項功能,設定都已完成。執行它們,從頭到尾看Dartastic如何運作,再閱讀並參考它們的程式碼。

它是開源Dart OTel Reference Demo的商業加強版,包含更多示範。每個應用程式都從您的Dartastic Pub解析套件,並傳送到您的Observatory,因此示範能順利執行,就證明您的帳戶運作正常。

建置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權杖傳送

下載

登入Control Room,按下每個畫面頂端、「Help」旁邊的Reference Demo:

Control Room的頁首,「Reference Demo」按鈕位於「Help」和「Sign Out」旁邊

這會下載dartastic-otel-reference-demo-<version>.tar.gz。將它解壓縮到您存放程式碼的任何位置:

shell
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*

最上層的README.md是完整指南。以下步驟帶您完成第一次執行。

使用Dedicated:指向您的伺服器

示範預設指向Dartastic Cloud,因此使用Cloud時這裡不需要做任何事。使用Dedicated時,請以您的子網域執行一次:

shell
tool/set-hosted-slug.sh <subdomain>

它會將您的子網域寫入.env(git會忽略此檔案),並更新各個pubspec。以另一個子網域再執行一次即可切換,以""執行則改回Cloud。

所需的權杖

請在Control Room的Tokens畫面建立每個權杖。每個權杖只會顯示一次,因此請在建立時複製。

權杖用途
Pub權杖
dart pub token add(一次)
所有示範:flutter pub get會從您的Dartastic Pub解析套件。
OTLP權杖
OTEL_EXPORTER_OTLP_HEADERS
所有示範:應用程式會將遙測資料傳送到您的Observatory。
Symbolizer權杖
DARTASTIC_SYMBOLIZER_TOKEN
僅限symbolizer_demo_flutter。

唯讀的Pub權杖足以執行所有示範,只有symbolizer_demo_flutter和crash_demo_flutter例外:它們會發布到您的Pub,需要讀寫權杖。開始使用會逐步說明如何加入Pub權杖並匯出其他權杖。

請在shell中匯出權杖,不要寫入.env:共用或提交到版本控制的.env是常見的機密外洩途徑。

執行示範

示範是單一Flutter工作區,因此請在最上層資料夾一次取得所有應用程式的套件:

shell
flutter pub get

如果成功,就表示您的Dartastic Pub和Pub權杖運作正常。接著啟動一個應用程式,tool/launch.sh會詢問要在哪個裝置上執行:

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • 只有weather_flutter和all_demos_flutter需要Docker:它們會在您的電腦上啟動天氣API,展示橫跨應用程式與伺服器的單一追蹤。
  • 示範可在Android、iOS、macOS、Windows和Linux的實體裝置與模擬器上執行,不支援網頁。

內容

應用程式展示內容
weather_flutter從頭到尾追蹤一次點擊:應用程式、天氣API、其快取和外部天氣服務,全在同一個追蹤中。
all_demos_flutter幾乎所有示範,各自作為同一個應用程式中的分頁。
rum_demo_flutter工作階段、畫面瀏覽、點擊和挫折訊號,以及工作階段重播。
crash_demo_flutter即使應用程式終止,當機仍會被記錄並送出。
symbolizer_demo_flutter經過模糊處理的發行建置版本,其堆疊追蹤會還原成您的檔案和行號,卡頓也會追溯到對應的widget。
anr_demo_flutter應用程式無回應(ANR)偵測。
pii_demo_flutter讓個人資料不進入您的遙測資料。
webview_demo_flutter來自應用程式內網頁的遙測資料,併入應用程式的追蹤。
平台關鍵指標版本健康狀態、Android Vitals、iOS MetricKit、應用程式啟動、裝置狀態、散熱狀態、網路不穩定、使用者體驗和Linux伺服器關鍵指標,各一個應用程式。

每個應用程式都連結到它在您Observatory中傳送的資料。想瞭解某項功能,就執行對應的應用程式,再閱讀其程式碼:那是該功能最精簡的可執行範例。也可以讓您的AI程式設計助理參考它。

在Observatory中看到的內容

以下畫面來自一次示範執行。您自己的執行會產生不同的數字,但每個畫面呈現的內容相同。

影格建置時間

all_demos_flutter在flutter.frame.build的「Metric」畫面上以熱度圖呈現:四分鐘的影格,p95線在執行期間逐漸上升。
all_demos_flutter在flutter.frame.build的「Metric」畫面上以熱度圖呈現:四分鐘的影格,p95線在執行期間逐漸上升。

版本健康狀態

篩選為版本健康狀態示範flutter.session span的追蹤,每個工作階段一個。紅色那一個是當機的工作階段。
篩選為版本健康狀態示範flutter.session span的追蹤,每個工作階段一個。紅色那一個是當機的工作階段。

應用程式啟動

flutter.app.startup.duration的「Metric」畫面以熱度圖呈現:三次約2.2秒的冷啟動,以及兩次分別為33和63毫秒的熱啟動。
flutter.app.startup.duration的「Metric」畫面以熱度圖呈現:三次約2.2秒的冷啟動,以及兩次分別為33和63毫秒的熱啟動。

網路不穩定

篩選為dartastic.network.flaky = true的追蹤:兩個不穩定的請求,一個耗時6.56秒,另一個耗時114毫秒並以錯誤結束。
篩選為dartastic.network.flaky = true的追蹤:兩個不穩定的請求,一個耗時6.56秒,另一個耗時114毫秒並以錯誤結束。

Interaction to Next Paint

flutter.experience.inp的「Metric」畫面以熱度圖呈現:八次互動,兩次低於16毫秒,六次介於200至250毫秒。
flutter.experience.inp的「Metric」畫面以熱度圖呈現:八次互動,兩次低於16毫秒,六次介於200至250毫秒。

First Contentful Paint

flutter.experience.fcp的「Metric」畫面:一次First Contentful Paint,為2.67秒。
flutter.experience.fcp的「Metric」畫面:一次First Contentful Paint,為2.67秒。

應用程式無回應:事件

篩選為anr_demo_flutter的dartastic.app.anr事件的記錄:三次ANR,因為事件不帶嚴重性而計入「Unspecified」,每一列都顯示其事件名稱。
篩選為anr_demo_flutter的dartastic.app.anr事件的記錄:三次ANR,因為事件不帶嚴重性而計入「Unspecified」,每一列都顯示其事件名稱。

應用程式無回應:持續時間

同樣三次ANR在flutter.anr.duration的「Metric」畫面上:每次6.0至6.6秒,標在匯出的時間點。
同樣三次ANR在flutter.anr.duration的「Metric」畫面上:每次6.0至6.6秒,標在匯出的時間點。

iOS MetricKit應用程式結束

dartastic.app.exit.count的「Metric」畫面以長條圖呈現:一個五分鐘區間內有50次結束,其中43次正常、3次記憶體不足、3次watchdog、1次逾時。
dartastic.app.exit.count的「Metric」畫面以長條圖呈現:一個五分鐘區間內有50次結束,其中43次正常、3次記憶體不足、3次watchdog、1次逾時。