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

開始使用

從初次認識OpenTelemetry,到在Observatory中看到您自己的追蹤。每個步驟都以前一步為基礎,請依序進行。

關於OpenTelemetry

從OpenTelemetry開始

Dartastic建立在OpenTelemetry(OTel)之上,這是記錄軟體行為的開放標準。Dartastic嚴格遵循OpenTelemetry規格:名稱、資料和傳送方式都是標準的。您對OpenTelemetry的瞭解都適用於Dartastic,而您用Dartastic打造的一切,仍然是標準的OpenTelemetry。

這份規格並不難懂。繼續之前,請花一小時閱讀OpenTelemetry文件,建立基本的瞭解:

三種訊號

OpenTelemetry記錄三種資料,稱為訊號:

追蹤
逐步記錄發生了什麼,以及每一步花了多久。追蹤是一棵由span組成的樹:一次點擊、它發出的網路呼叫、該呼叫背後的伺服器工作,以及其下的資料庫查詢。一個追蹤可以從您的應用程式延伸到您的伺服器。
指標
隨時間量測的數值:影格時間、記憶體、每分鐘請求數、每個版本的錯誤數。保留成本低,因此能呈現趨勢並觸發警示。
記錄
帶有時間和嚴重性等級的文字行。在OpenTelemetry中,記錄會帶有寫入時所在的追蹤,因此從一筆記錄就能開啟當下發生的其他一切。

三種訊號都帶有資源:哪個應用程式傳送、哪個版本、在哪個裝置上。Dartastic在此之上加入真實使用者監控(工作階段、畫面、點擊和重播),同樣以標準訊號記錄。總覽說明這些頁面使用的其他用語。

建置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. 登入

登入dartastic.io。第一次登入時,您會設定您的組織:也就是您的權杖、團隊成員和方案所屬的帳戶。如果是團隊成員邀請您,請使用受邀的電子郵件地址登入,您就會加入對方的組織。

註冊後,您的組織會從Cloud Free開始,不需要信用卡。您需要提供:

  • 組織名稱和子網域:組織的名稱,以及您的應用程式傳送遙測資料的子網域。子網域永久歸您所有。
  • 區域:遙測資料的儲存位置。日後無法變更。
  • RUM上限:您的引擎可以錄製的最高重播等級。Cloud Free最高到Wireframe;Shadow和Pixel包含在付費方案中。我們會依您的選擇打造引擎,裝置上的任何設定都無法超過此上限。
  • Dartastic AI:使用您自己的模型金鑰運作,您可以當下新增,也可以日後再新增。

如果只使用Dartastic Pub,請在註冊前於定價頁面選擇Pub方案。您只需為組織命名並選擇區域,不需要提供其他資訊。

登入後會進入Control Room。Organization會顯示您組織的名稱和ID。

2. 下載Reference Demo

按下Control Room頂端的Reference Demo並解壓縮。您會在步驟5執行它:這是看到Dartastic運作的最快方式,而它的程式碼示範了每項功能的用法。進一步瞭解Reference Demo。

3. 將dart pub連接到您的Dartastic Pub

Dartastic套件來自您的Dartastic Pub,而不是pub.dev,dart pub需要權杖才能從中讀取。大多數開發者沒做過這項設定;只需一分鐘,每台電腦設定一次即可。

Dartastic Pub也能直通pub.dev。照常在pubspec.yaml中定義套件,來自pub.dev的套件會自動從pub.dev解析,與Dartastic套件及您的私有套件並存。

  1. 在Control Room中,前往Tokens:
    Control Room的「Tokens」畫面:「Generate Token」,以及「+ Pub」、「+ Symbolizer」、「+ OTLP」和「+ Browser OTLP」
  2. 建立Pub權杖:按下+ Pub。視窗隨即開啟:
    「Generate Pub Token」視窗:「Name」、權杖授予的權限、組織,以及「Allow write (publish) access」
    • Name:任何能區分各個權杖的名稱,建議使用pub-org-read-write。
    • Organization:此權杖要讀取及發布哪個組織的套件。
    • Allow write (publish) access:勾選後,即可使用此權杖發布到您的Dartastic Pub。未勾選時,權杖只能讀取,這已足以執行Reference Demo,只有symbolizer_demo_flutter和crash_demo_flutter例外,因為它們會發布到您的Pub。
  3. 按一下Generate。權杖只會顯示一次:
    新的Pub權杖:其「Token ID」、附有複製按鈕的機密權杖、dart pub token add命令,以及「Granted scopes: Pub」
    請立即使用複製按鈕複製權杖:關閉這個視窗後,就無法再次顯示。Granted scopes: Pub表示此權杖僅適用於Pub:它無法傳送遙測資料,也無法呼叫任何其他服務。
  4. 在命令列中,將權杖交給dart pub:
    shell
    dart pub token add https://pub.dartastic.io
    出現Enter secret token:提示時,貼上權杖並按下Enter。貼上時提示不會顯示任何內容,這是正常的。它會回應:
    terminal
    Enter secret token:
    Requests to "https://pub.dartastic.io" will now be authenticated using the secret token.
  5. 在Reference Demo的資料夾中,取得其套件:
    shell
    flutter pub get
    如果成功,就表示您的Pub和權杖運作正常。

dart pub會為該主機保存權杖,且只會將它傳送到該主機。Pub說明如何列出、取代和移除權杖,以及如何發布。

Pub權杖可存取哪些套件

Pub權杖可存取其擁有者能使用的套件,僅此而已。

  • 組織管理員可使用組織中的所有套件,因此他們的權杖也可以。
  • 其他團隊成員只能為已獲授予的套件建立權杖。由管理員將套件授予團隊成員。

角色請參閱邀請團隊成員,將套件授予組織成員請參閱Pub。

4. 讓應用程式傳送遙測資料

在Tokens畫面建立OTLP權杖,然後以OpenTelemetry的標準形式在shell中匯出。authorization請保持小寫:

shell
export OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer <your OTLP token>"

5. 執行示範

確認Docker正在執行,然後從Reference Demo的資料夾啟動天氣示範並選擇裝置:

shell
tool/launch.sh weather_flutter

點擊以取得天氣。這次點擊會啟動一個追蹤,貫穿應用程式、天氣API、其快取和外部天氣服務。

6. 在Observatory中查看

您的點擊會在幾秒內抵達Observatory。應用程式會連結到它傳送的資料:點選連結開啟追蹤,查看每個步驟及其耗時。

下一步