命令
arc logs tail
实时跟随日志文件，行为类似 tail -F。启动时会先从文件尾部向前回溯 4MB，避免重复处理全量历史，再持续输出新增行。
遇到 EOF 后会 sleep 200ms 并重新打开文件。这个机制可以处理日志轮转：Arc 跟踪的是路径不是 inode，因此同一路径下新文件会被自动跟随。
arc logs query
从文件头（或 --last 时间截断点）扫描日志，输出匹配行后退出。
参数
通用参数（tail / query）
tail 独有参数
query 独有参数
时间格式
示例：
5m、1h、30s、200ms、3600（秒）。
日志文件解析顺序
CLI 按以下顺序确定日志文件路径：- 如果传了
--file，直接使用 - 读取 Arc 配置文件（
--config，默认/etc/arc/config.yaml） - 解析
logging.output.file - 未找到则返回配置错误并退出
过滤逻辑
所有过滤条件都在客户端执行，多个条件之间是逻辑 AND。无法解析为 JSON 的行会被静默跳过。--status 有两类匹配：
- 精确匹配：
502（按整数比较） - 通配匹配：
5xx、4xx（分别匹配 500–599、400–499）
ts 早于 now - duration 会被跳过；时间戳解析失败时按 fail-open 保留该行。
运维说明
仅本地。 CLI 只读取本机文件，不带 HTTP 客户端能力，不能直接查集群其他节点。 高吞吐建议。 在高 QPS 场景，建议加--last 收窄扫描范围。tail 无论如何都会从 EOF 前 4MB 开始。
日志轮转。 tail 在 EOF 会自动 reopen 路径，因此可跟随轮转后的新文件。
非 JSON 行。 不合法 JSON（例如轮转过程中的半行）会被静默忽略。
示例
故障排查
No log file found
No log file found
通常是没有传
--file，且配置文件中不存在 logging.output.file；或者 --config 指向了错误路径。请确认 --config /etc/arc/arc.json（或你的真实路径）并检查 logging.output.file。arc logs tail 没有输出
arc logs tail 没有输出
说明文件存在但没有新日志写入。先确认 Arc 正在运行且有流量；再确认
observability.access_log.enabled: true，并且采样率 sample 不为 0.0。出现非 JSON 行
出现非 JSON 行
Arc 产出的是 NDJSON。非 JSON 行（例如日志系统初始化前的启动输出）会被
arc logs 自动忽略。如果在原始文件里看到这类内容，通常可以忽略。--status 2xx 没有结果
--status 2xx 没有结果
通配状态码必须用
xx 后缀。合法示例：200、2xx、4xx、5xx。请确认当前流量里确实存在对应状态码。日志轮转时 tail 丢行
日志轮转时 tail 丢行
arc logs tail 在 EOF 后会等待 200ms 再 reopen。重命名到 reopen 之间极短窗口可能漏少量行。高吞吐排障建议使用 arc logs query 并配时间窗口补查。