開始使用
從初次認識OpenTelemetry,到在Observatory中看到您自己的追蹤。每個步驟都以前一步為基礎,請依序進行。
關於OpenTelemetry
從OpenTelemetry開始
Dartastic建立在OpenTelemetry(OTel)之上,這是記錄軟體行為的開放標準。Dartastic嚴格遵循OpenTelemetry規格:名稱、資料和傳送方式都是標準的。您對OpenTelemetry的瞭解都適用於Dartastic,而您用Dartastic打造的一切,仍然是標準的OpenTelemetry。
這份規格並不難懂。繼續之前,請花一小時閱讀OpenTelemetry文件,建立基本的瞭解:
- 什麼是OpenTelemetry?
- 可觀測性入門
- 訊號,也就是以下三種資料
三種訊號
OpenTelemetry記錄三種資料,稱為訊號:
- 追蹤
- 逐步記錄發生了什麼,以及每一步花了多久。追蹤是一棵由span組成的樹:一次點擊、它發出的網路呼叫、該呼叫背後的伺服器工作,以及其下的資料庫查詢。一個追蹤可以從您的應用程式延伸到您的伺服器。
- 指標
- 隨時間量測的數值:影格時間、記憶體、每分鐘請求數、每個版本的錯誤數。保留成本低,因此能呈現趨勢並觸發警示。
- 記錄
- 帶有時間和嚴重性等級的文字行。在OpenTelemetry中,記錄會帶有寫入時所在的追蹤,因此從一筆記錄就能開啟當下發生的其他一切。
三種訊號都帶有資源:哪個應用程式傳送、哪個版本、在哪個裝置上。Dartastic在此之上加入真實使用者監控(工作階段、畫面、點擊和重播),同樣以標準訊號記錄。總覽說明這些頁面使用的其他用語。
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套件及您的私有套件並存。
- 在Control Room中,前往Tokens:

- 建立Pub權杖:按下+ Pub。視窗隨即開啟:

- Name:任何能區分各個權杖的名稱,建議使用
pub-org-read-write。 - Organization:此權杖要讀取及發布哪個組織的套件。
- Allow write (publish) access:勾選後,即可使用此權杖發布到您的Dartastic Pub。未勾選時,權杖只能讀取,這已足以執行Reference Demo,只有
symbolizer_demo_flutter和crash_demo_flutter例外,因為它們會發布到您的Pub。
- Name:任何能區分各個權杖的名稱,建議使用
- 按一下Generate。權杖只會顯示一次:
請立即使用複製按鈕複製權杖:關閉這個視窗後,就無法再次顯示。Granted scopes: Pub表示此權杖僅適用於Pub:它無法傳送遙測資料,也無法呼叫任何其他服務。
- 在命令列中,將權杖交給
dart pub:出現shelldart pub token add https://pub.dartastic.ioEnter secret token:提示時,貼上權杖並按下Enter。貼上時提示不會顯示任何內容,這是正常的。它會回應:terminalEnter secret token: Requests to "https://pub.dartastic.io" will now be authenticated using the secret token. - 在Reference Demo的資料夾中,取得其套件: 如果成功,就表示您的Pub和權杖運作正常。shell
flutter pub get
dart pub會為該主機保存權杖,且只會將它傳送到該主機。Pub說明如何列出、取代和移除權杖,以及如何發布。
Pub權杖可存取哪些套件
Pub權杖可存取其擁有者能使用的套件,僅此而已。
- 組織管理員可使用組織中的所有套件,因此他們的權杖也可以。
- 其他團隊成員只能為已獲授予的套件建立權杖。由管理員將套件授予團隊成員。
4. 讓應用程式傳送遙測資料
在Tokens畫面建立OTLP權杖,然後以OpenTelemetry的標準形式在shell中匯出。authorization請保持小寫:
export OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer <your OTLP token>"5. 執行示範
確認Docker正在執行,然後從Reference Demo的資料夾啟動天氣示範並選擇裝置:
tool/launch.sh weather_flutter點擊以取得天氣。這次點擊會啟動一個追蹤,貫穿應用程式、天氣API、其快取和外部天氣服務。
6. 在Observatory中查看
您的點擊會在幾秒內抵達Observatory。應用程式會連結到它傳送的資料:點選連結開啟追蹤,查看每個步驟及其耗時。
下一步
- 建置您的第一個應用程式:每個套件需要的Flutter和Dart版本。
- 邀請團隊成員,在他們第一次登入之前。
- 在應用程式中加入OTel:將Dartastic加入您自己的應用程式。