log_listener CLI

log_listener 二進位檔包含在所有包含 pkgfs 的裝置版本中，目前是工程師用來讀取即時記錄串流的主要工具。樹狀結構開發人員通常會使用 ffx log 叫用。

標記 附註
--only <comma-separated-words> 加入至少含有一個指定字詞的行。如果未設定，這項設定就不會產生任何作用。
--suppress <comma-separated-words> 排除任何包含指定字詞的行。
--select <comma-separated-component-interests> 針對目標裝置上與選取條件相符的元件所發出的記錄，設定最低嚴重性等級。 使用格式 <component-selector>#<log-level> 指定，其中 log-level 必須是 FATAL|ERROR|WARN|INFO|DEBUG|TRACE 之一。

選取多個元件時，請以半形逗號分隔。

--begin <comma-separated-words> 加入以至少一個指定字詞開頭的區塊。與 --end 旗標配對。預設值為關閉。
--end <comma-separated-words> 排除以至少一個指定字詞開頭的區塊。與 --begin 旗標配對。預設值為關閉。
--tag <string> 要納入的標記。針對多個標記使用多次。根據預設，系統不會執行任何篩選程序，只有指定標記才能夠被指定。
--ignore-tag <string> 要忽略的標記。針對多個標記使用多次。
--pid <integer> 僅顯示指定程序 koid 的記錄檔。
--tid <integer> 僅顯示指定執行緒 koid 的記錄檔。
--pretty yes 啟用色彩。
--hide_metadata yes 在記錄檔輸出內容中隱藏多餘的中繼資料 (例如 PID、TID)。與 --pretty 配對時，線條會依照嚴重性進行顏色標示。
--severity <level> 要包含的嚴重性等級。這個變數預設為 INFO。

不會影響元件產生的記錄檔。

<level> 必須是 TRACE|DEBUG|INFO|WARN_ERROR|FATAL 的其中一項。

--file <string> 將寫入記錄的路徑。根據預設，系統會將記錄寫入 stdout。
--file_capacity <integer> 允許的磁碟空間上限。寫入的檔案達到容量的一半時，系統會將檔案移至 FILE.old，並建立新的記錄檔。

預設值為 64,000。如果未指定 --file，則不會有任何作用。

如果設為 0，這項功能就會停用。

--startup_sleep <integer> 程式啟動時的睡眠時間 (以毫秒為單位)。
--clock <Monotonic|UTC|Local> 列印時間戳記時使用的時鐘。

Monotonic (預設)：核心回報的單聲道時間。

UTC：執行階段回報的世界標準時間。

當地時間：本地化時間。

--time_format <format> 如果 --clock 不是 MONOTONIC，請指定時間戳記格式。

請參閱 Chrono crate 的說明文件，瞭解格式指定碼。

預設值為「%Y-%m-%d %H:%M:%S」。

--since_now yes 略過這個指令之前，請略過所有記錄檔。
--dump_logs yes 在輸出可用記錄後退出。
--help | -h 用於列印用量。