疑難排解工具參考資料

本頁目的是引導使用者使用可解決 Fuchsia 開發人員可能遇到的常見問題的工具。

問題

  • 我想瞭解元件在執行階段的運作情形。

  • 我想自動執行後續處理作業，找出值得注意的值或錯誤狀態

    • 分類

      • 分類作業會從診斷資料中選取及處理值，並產生有用的動作和洞察資料，無論是在裝置上或離線狀態皆然。分類作業可執行以下操作：顯示計算值、檔案快照 (當做為 Detect 引擎在裝置上執行時)，以及針對非標準值顯示警告。

  • 我想在特定條件下自動觸發快照功能

    • 偵測

      • 偵測掃描作業：檢查裝置上的資料，決定何時要提交當機報告。系統會使用 Triage 語言設定偵測掃描作業，並每隔幾分鐘執行一次。

  • 我想評估特定函式的執行時間

  • 我想收集使用者擁有的實地裝置指標

    • 鈷豔藍

      • Cobalt 是一種管道，可從使用者擁有的裝置收集指標資料，並產生匯總報表。Cobalt 包含一系列功能，可保護使用者隱私和匿名性，同時提供產品擁有者改善產品所需的資料。

工具

  • 公開元件狀態的結構化診斷資訊。這有助於監控元件在特定時間點的狀態。檢查工具可讓元件公開任意類型鍵/值組合的階層，並在執行期間更新該階層。在元件仍在執行時，您可以擷取快照並檢查這項資料。檢查通常用於呈現元件的工作集和近期記錄資訊，以利於偵錯。元件開發人員可以使用 Inspect，方法是依賴所選語言 (Rust、C++) 的程式庫，並呼叫適當的方法來變更已記錄的狀態。您可以使用 ffx inspect 工具或 ffx target snapshot 讀取檢查資料。

    Inspect 可解決的問題：

    • 我想瞭解元件在執行階段的運作情形。
    • 分類

  • 在元件執行期間列印字串記錄。與許多系統一樣，Fuchsia 支援字串的基本記錄功能，可在執行特定行原始碼時記錄某些資訊。記錄會由 Archivist 元件匯總。您可以使用 `ffx log` 讀取這些資訊。

    Logs 可解決的問題：

    • 我想瞭解元件在執行階段的運作情形。
    • 結構化記錄檔

  • 在記錄訊息中儲存結構化鍵/值組合。除了文字記錄外，Fuchsia 也支援以鍵/值型態編碼的完全結構化記錄。開發人員可以使用 Rust 中的 tracing Crate 巨集或 C++ 中的 FX_SLOG 巨集，編寫結構化記錄。

    結構化記錄可解決的問題：

    • 我想瞭解元件在執行階段的運作情形。

  • 持久性會儲存檢查資料，並在後續啟動時發布。有時，如果裝置發生網路問題，診斷資料可能需要重新啟動裝置才能匯出。持久性會將所選檢查資料寫入磁碟，然後在下次啟動時將其發布回檢查。

    Persistence 可解決的問題：

    • 檢查

  • Sampler 會讀取 Inspect 的資料，並轉送至 Cobalt。Sampler 可讓您輕鬆將資料傳送至 Cobalt。您不必將應用程式連結至 Cobalt 服務並直接使用，只要在 Inspect 中發布資料，並編寫簡單的設定檔項目，告知 Sampler 擷取資料並傳送至 Cobalt 即可。

    Sampler 可解決的問題：

    • 檢查

  • Fuchsia 的追蹤系統提供全面的方式，可從 Fuchsia 使用者空間程序和 Zircon 核心收集、匯總及視覺化診斷追蹤資訊。追蹤記錄與記錄一樣，代表 Fuchsia 系統的事件，但追蹤記錄更精細、頻率更高，且可供機器使用，用於計算其他深入分析資料和視覺化資料。

    追蹤功能可解決的問題：

    • 我想瞭解元件在執行階段的運作情形。
    • 我想評估特定函式的執行時間
    • 檢查
    • 記錄

  • 分類作業會從診斷資料中選取及處理值，並產生有用的動作和洞察資料，無論是在裝置上或離線狀態皆然。分類作業可執行以下操作：顯示計算值、檔案快照 (當做為 Detect 引擎在裝置上執行時)，以及針對非標準值顯示警告。

    Triage 可解決的問題：

    • 我想自動執行後續處理作業，找出值得注意的值或錯誤狀態
    • 檢查
    • 偵測

  • Cobalt 是一種管道，可從使用者擁有的裝置收集指標資料，並產生匯總報表。Cobalt 包含一系列功能，可保護使用者隱私和匿名性，同時提供產品擁有者改善產品所需的資料。

    Cobalt 可解決的問題：

    • 我想收集使用者擁有的實地裝置指標

  • 偵測掃描作業：檢查裝置上的資料，決定何時要提交當機報告。系統會使用 Triage 語言設定偵測掃描作業，並每隔幾分鐘執行一次。

    Detect 可解決的問題：

    • 我想在特定條件下自動觸發快照擷取作業
    • 檢查
    • 分類

  • zxdb 是主控台模式偵錯工具，適用於在 Fuchsia 上執行的原生程式碼。

    zxdb 可解決的問題：

    • 我想瞭解元件在執行階段的運作情形。