log stream 是 macOS 原生实时日志命令,毫秒级延迟直连 Unified Logging;支持 --predicate 精准过滤、--level 限定级别、--style json 导出结构化日志,并可后台持续写入文件。

用终端实时查看系统日志(log stream)
当你需要立刻看到 macOS 正在发生的系统事件、应用行为或权限请求时,log stream 是唯一能提供毫秒级延迟的原生命令,它不读取历史文件,而是直连 Unified Logging 的实时数据流。
打开“终端”(应用程序 → 实用工具),输入以下命令并回车:
log stream
这会立即开始滚动输出所有级别(info、debug、error)的日志,包括 kernel、tccd、sandboxd、backupd 等进程的实时动作。默认只显示当前会话之后的新日志,旧记录不会补出。
按 Ctrl + C 可随时中断流式输出。
按关键词精准过滤实时日志
全量日志噪音太大,必须加过滤条件才能聚焦问题。log stream 支持 --predicate 语法,比简单 grep 更可靠,因为它在日志写入前就完成匹配,不丢条目。
方法一:监控蓝牙守护进程异常
log stream --predicate 'process == "bluetoothd"'
方法二:抓取所有隐私授权请求(含用户点击“允许/拒绝”的瞬间)
log stream --predicate 'subsystem == "com.apple.tccd"'
方法三:同时监听沙盒拦截 + 内核拒绝(适合排查敏感目录访问失败)
log stream --predicate 'subsystem == "com.apple.sandboxd" OR process == "kernel"'
注意:使用 subsystem 或 process 匹配比用 eventMessage contains 更高效,因为前者走索引,后者需全文扫描——尤其在高负载时差异明显。
限定日志级别与输出格式
默认 log stream 会混杂 info 和 debug 级别日志,大量调试信息会掩盖真正的问题信号。你需要主动压制冗余内容。
第一步:只显示 error 和 fault 级别(最常用)
log stream --level error
第二步:叠加进程过滤,例如只看 Time Machine 备份失败
log stream --level error --predicate 'process == "backupd"'
第三步:导出为结构化 JSON 方便后续分析(Ctrl+C 中断后文件即生成)
log stream --level error --predicate 'eventMessage contains "disk space"' --style json > ~/Desktop/disk_alert.json
这一步导出的是完整 JSON 对象流,每行一个日志条目,可直接被 Python 或 jq 解析;【不要用 --info 或 --debug 同时开启,否则日志体积暴增且易卡死终端】
保存实时日志到文件持续监控
你可能需要后台运行日志捕获,比如让脚本每5分钟检查一次磁盘告警,或长期记录某服务行为。
在终端中执行:
log stream --predicate 'eventMessage contains "panic" OR eventMessage contains "kernel: panic"' --level error > ~/panic_monitor.log &
这个命令会在后台持续追加写入 panic 相关错误,& 符号使其不阻塞当前终端。
要停止该后台任务,先运行 jobs 查看作业编号,再执行 kill %1(把 1 换成对应编号)。
如果想让日志自动按日期轮转,需配合 shell 脚本和定时任务,log stream 本身不支持 rotate 功能。


















