log_listener 二进制文件包含在所有包含 pkgfs 的设备 build 中，目前是工程师用来以交互方式读取实时日志流的主要工具。树内开发者通常使用 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。
对组件生成的日志没有任何影响。
|
--file <string>
|
将在其中写入日志的路径。默认情况下，日志会写入 stdout。 |
--file_capacity <integer>
|
允许使用的磁盘可用空间上限。当被写入的文件达到容量的一半后，该文件会被移至 FILE.old，并创建新的日志文件。默认值为 64,000。如果未指定 --file，则此参数无效。 如果设置为 0，系统会停用此功能。 |
--startup_sleep <integer>
|
程序启动时休眠此毫秒数。 |
--clock <Monotonic|UTC|Local>
|
输出时间戳时使用的时钟。
单调时间（默认）：内核报告的单调时间。 UTC：运行时报告的世界协调时间 (UTC)。 当地时间：本地化的实际用时。 |
--time_format <format>
|
如果 --clock 不是 MONOTONIC，请指定时间戳格式。
如需了解格式说明符，请参阅时序 crate 的文档。 默认值为“%Y-%m-%d %H:%M:%S”。 |
--since_now yes
|
忽略在调用此命令之前的所有日志。 |
--dump_logs yes
|
请在输出可用的日志后退出。 |
--help | -h
|
输出使用情况。 |