fuchsia.diagnostics

比對要求感興趣的元件。

要傳送到與選取條件相符的元件的興趣層級。

StringSelector 的向量，可做為已命名節點階層中路徑的模式比對器。向量中的每個項目都是資料階層中單一已命名節點的選取器。已命名節點的選取器向量，接著定義資料階層路徑上的選取器。

節點路徑支援萬用字元，這樣會畫出節點階層的單一層級。例如：root/a/b//d 會比對出位於節點 b. root/a/b/c 以下所有子項下方的 d 節點，將會符合 b 以下開頭為「c」字元的所有節點。

StringSelector，能做為資料階層中節點名稱字串的模式比對器。

target_properties 支援萬用字元，這會比對任何節點上按 node_path 比對的所有屬性。

StringSelector 的向量，可做為已命名節點階層中路徑的模式比對器。向量中的每個項目都是資料階層中單一已命名節點的選取器。已命名節點的選取器向量，接著定義資料階層路徑上的選取器。

節點路徑支援萬用字元，這樣會畫出節點階層的單一層級。例如：root/a/b//d 會比對出位於節點 b. root/a/b/c 以下所有子項下方的 d 節點，將會符合 b 以下開頭為「c」字元的所有節點。

檢查

完成系統中的檢查階層。

記錄檔

系統上的記錄串流。

JSON

依照 診斷 Json 結構定義規格轉儲讀取結果。

TEXT

根據 Iquery 文字規格傾印讀取結果。

商務人士

依照診斷 CBOR 結構定義規格傾印讀取結果。

IO

追蹤

追蹤記錄包含程式執行的詳細資訊。

偵錯

偵錯記錄包括與程式執行相關的開發資訊。

資訊

資訊記錄包含有關程式執行的一般資訊。(預設)

警告

警告記錄包含可能發生問題作業的相關資訊。

錯誤

錯誤記錄包含失敗作業的相關資訊，

嚴重

嚴重記錄會指出導致程式終止的作業相關資訊。

快照

串流將在連線時提供診斷資料的快照，然後隨即結束。

SNAPSHOT_THEN_SUBSCRIBE

串流將在連線時提供診斷資料的快照，然後系統會停止對串流發出的後續呼叫，直到有新的診斷資料可用。

訂閱

在有新的診斷資料可用前，向串流發出的呼叫會暫停。在呼叫串流之間，新抵達的資料都會經過緩衝處理。

1

Vector 會將所選元件的分子模式編碼。這些猴子是和原住民所察覺的「根」階層相對的子項動物。

必須提供至少一個 StringSelector，用來指定與目前選取器相符的元件名稱。

1

最低所需嚴重性。元件應包含達到這個嚴重性或高於這個嚴重性的記錄。

如果不是，則解讀為 Severity.INFO。

1

用於診斷串流的批次疊代器傳回所有格式化內容的最大匯總大小。如果針對在訂閱模式下設定的串流設定這個值，當串流達到大小上限時，串流就會終止。附註：選用

2

設定可指定等待單一元件「充飽」的診斷資料秒數上限。這個值可用於測試，或是如果您知道所需元件的負載負擔過重。如未提供，系統將使用 https://fuchsia.googlesource.com/fuchsia/+/refs/heads/master/src/diagnostics/archivist/src/constants.rs 中定義的 PER_COMPONENT_ASYNC_TIMEOUT_SECONDS。 附註：選用

1

定義元件工程師模式要比對的選取器。

2

用於定義資料階層屬性的選取器，在由 component_selector 比對的元件擁有的資料階層中比對。

1

一個 [fuchsia.diagnostics/DataType]，用於指定要串流至用戶端的診斷資料類型。附註：必填

2

指定串流伺服器如何提供串流結果的 [fuchsia.diagnostics/StreamMode]。 附註：必填

3

一個 [fuchsia.diagnostics/Format]，指定傳回的診斷資料的格式。附註：必填

4

設定指定用戶端希望透過連線傳回哪些結果的設定。用戶端可以使用提供的選取器向量來要求特定的資料子集，或指定想要所有可用資料。附註：必填

5

設定可指定等待單一元件「充飽」的診斷資料秒數上限。這個值可用於測試，或是如果您知道所需元件的負載負擔過重。如未提供，系統將使用 https://fuchsia.googlesource.com/fuchsia/+/refs/heads/master/src/diagnostics/archivist/src/constants.rs 中定義的 PER_COMPONENT_ASYNC_TIMEOUT_SECONDS。 附註：選用

6

設定診斷串流效能屬性的參數。 附註：選用

1

2

3

1

3

1

[fuchsia.diagnostics/SelectorArgument] 的向量，可提供額外的篩選器來界定資料串流的範圍。空白向量視為設定錯誤，進而導致代表錯誤參數的稱呼。

2

如果已設定，則 select_all 必須是 true，並指定用戶端想擷取其連線能夠公開的所有資料。

1

編碼為 JSON 的診斷結構定義。 VMO 最多可包含 1MB 的診斷資料。

2

編碼為文字的診斷結構定義。 VMO 最多可包含 1MB 的診斷資料。

3

編碼為 cbor 的診斷結構定義。 VMO 最多可包含 1MB 的診斷資料。大小為 ZX_PROP_VMO_CONTENT_SIZE。

1

用於定義模式比對器的選取器，該選取器會針對元件所在的資料階層命名空間，選取階層中的元件和屬性。

2

代表 [fuchsia.diagnostics/Selector] 的原始字串。選取器會定義模式比對器，這項功能會依照元件，在資料階層命名空間中的階層和屬性選取元件。注意：所有從 raw_selector 剖析的 StringSelectors 都會以 string_pattern 模式解譯，為特殊字元的重要性。詳情請參閱 https://fuchsia.dev/fuchsia-src/reference/diagnostics/selectors

1

這是提供的字串，會定義要比對的模式。剖析器會將星號 ()、冒號 (:) 和反斜線 () 視為特殊字元。

如要比對常值星號 ()，則必須逸出。如要比對常值反斜線 ()，則必須逸出。如要比對常值冒號 (:)，則必須逸出。

例如：abc 會比對任何名稱是「a」的字串，例如「a*」會比對任何開頭為「a」的字串。例如：a* 會比對任何開頭為「a」的字串。例如： 會比對任何開頭為「a」的字串。例如：b 會比對開頭為「a」且以「b」為結尾的任何字串，例如：b.cb

此外，「*」常值會視為特殊順序，但只能符合元件選取器中的多個層級。詳情請參閱 |ComponentSelector|。

2

這是提供的字串，可定義要比對的確切字串。系統不會將任何字元視為特殊或含有特殊語法。

1

定義一組節點要比對的選取器，系統會選取整個子樹狀結構 (包括這些節點)。

2

這個選取器會定義一組要比對的節點，並在這些比對符合的節點上，提供一組要比對的已命名授權。

選擇大小為 64，因為批次項目會處理 VMO，且每個 fidl 訊息最多只能有 64 個處理。

大小限制為 1024 是一種合理的低尺寸限制，符合我們遇到的大部分標準選取器。

可透過事件監聽器指定的 LogInterestSelector 數量上限。