疑難排解工具參考資料

本頁旨在引導使用者找出工具來解決 Fuchsia 開發人員可能遇到的常見問題。

錯誤

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

    • 檢查

      • 公開關於元件的結構化狀態。即時監控元件的狀態。檢查工具可讓元件公開特定類型鍵/值組合的階層，並在執行過程中進行更新。元件仍在執行期間，您可以針對這些資料建立快照和檢查。檢查經常用於呈現元件工作集的相關資訊，以及元件的近期歷史記錄，以便在偵錯期間提供協助。元件作者會根據自己選擇的語言程式庫使用 Inspect (目前支援 Rust、C++ 和 Dart)，並呼叫適當的方法來變更已記錄的狀態。系統可使用 ffx component inspect 工具或 ffx target snapshot 讀取資料。

    • 記錄

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

    • 結構化記錄

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

  • 我想自動觸發特定條件的快照建立作業

    • 偵測

      • 偵測掃描功能 在裝置端檢查資料，決定何時傳送當機報告。 系統會使用 Triage 語言設定掃描作業，並每幾分鐘執行一次。

    • 分類

      • 分類功能會從「診斷」資料中選取及處理值，並在裝置端和裝置外產生實用的動作和深入分析結果。分類：顯示計算結果值、檔案快照 (以偵測引擎在裝置端執行時)；以及列印離異常值的警告。

  • 我想自動處理後續的快照，找出重要的值或錯誤狀況

    • 分類

      • 分類功能會從「診斷」資料中選取及處理值，並在裝置端和裝置外產生實用的動作和深入分析結果。分類：顯示計算結果值、檔案快照 (以偵測引擎在裝置端執行時)；以及列印離異常值的警告。

工具

  • 公開關於元件的結構化狀態。即時監控元件的狀態。檢查工具可讓元件公開特定類型鍵/值組合的階層，並在執行過程中進行更新。元件仍在執行期間，您可以針對這些資料建立快照和檢查。檢查經常用於呈現元件工作集的相關資訊，以及元件的近期歷史記錄，以便在偵錯期間提供協助。元件作者會根據自己選擇的語言程式庫使用 Inspect (目前支援 Rust、C++ 和 Dart)，並呼叫適當的方法來變更已記錄的狀態。系統可使用 ffx component inspect 工具或 ffx target snapshot 讀取資料。

    檢查功能可解決的問題：

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

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

    記錄可解決的問題：

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

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

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

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

  • 持續性儲存 檢查資料，並在後續啟動時發布。有時必須等到裝置重新啟動後，才能匯出「診斷」資料 (例如網路發生問題時)。持續性會將所選的「檢查資料」寫入磁碟，然後在下次啟動時將其發布回「檢查」。

    持續存在的問題可解決的問題：

    • 檢查

  • Sampler 會從 Inspect 中讀取資料，再將資料轉送至 Cobalt。 取樣器可讓您輕鬆將資料傳送到 Cobalt。您不必將應用程式連結至 Cobalt 服務，只要在「Inspector」中發布資料，並編寫簡單的設定檔項目，即可讓 Sampler 擷取資料並傳送至 Cobalt。

    取樣器可解決的問題：

    • 檢查

  • 分類功能會從「診斷」資料中選取及處理值，並在裝置端和裝置外產生實用的動作和深入分析結果。分類：顯示計算結果值、檔案快照 (以偵測引擎在裝置端執行時)；以及列印離異常值的警告。

    分類可解決的問題：

    • 我想自動觸發特定條件的快照建立作業
    • 我想自動處理後續的快照，找出重要的值或錯誤狀況
    • 檢查
    • 偵測

  • 偵測掃描功能 在裝置端檢查資料，決定何時傳送當機報告。 系統會使用 Triage 語言設定掃描作業，並每幾分鐘執行一次。

    「偵測功能」可解決的問題：

    • 我想自動觸發特定條件的快照建立作業
    • 檢查
    • 分類