跳到主要内容

日志

查询、跟踪和导出中继操作日志。日志包括中继原生事件、控制器事件和从浏览器流式传输的扩展节点事件。

otto logs list​

拉取有界的历史日志条目列表。

用法​

otto logs list [options]

标志​

标志简写必填类型默认值允许值描述
--source否stringallrelay、controller、node、all按日志来源过滤
--latest否number100返回最新的 N 条条目
--level否stringdebug、info、warn、error按日志级别过滤
--since否stringISO-8601 日期时间返回此时间戳之后的条目
--node-id否string按节点 ID 过滤
--request-id否string按 requestId 过滤
--json否booleanfalse以 NDJSON 格式输出

示例​

# 拉取所有来源的最新 100 条条目
otto logs list

# 拉取最新 200 条条目
otto logs list --latest 200

# 仅拉取扩展来源日志
otto logs list --source node --latest 50

# 拉取与特定请求关联的日志
otto logs list --request-id <requestId> --source all

# 机器可读输出
otto logs list --json

退出码​

码含义
0日志已返回
1中继错误或过滤器无效

otto logs follow​

从中继流式传输实时日志事件。持续运行直到 Ctrl+C。

用法​

otto logs follow [options]

标志​

标志简写必填类型默认值允许值描述
--source否stringallrelay、controller、node、all按日志来源过滤
--level否stringdebug、info、warn、error按级别过滤
--json否booleanfalse以 NDJSON 格式输出（每行一个信封）

示例​

# 实时跟踪所有来源
otto logs follow

# 仅跟踪扩展运行时日志
otto logs follow --source node

# 带完整 JSON 信封跟踪
otto logs follow --source all --json

# 仅跟踪中继事件
otto logs follow --source relay
备注

otto logs follow 是无界的。对于自动化，强制执行调用方超时窗口并管道输出到日志聚合器。

退出码​

码含义
0干净退出（Ctrl+C）
1连接错误

otto logs status​

报告中继操作日志文件的存储状态。

用法​

otto logs status [options]

标志​

标志简写必填类型默认值描述
--json否booleanfalse以 JSON 格式输出

示例​

otto logs status

otto logs status --json

输出包括所有操作日志文件的总字节数和活跃窗口设置。

退出码​

码含义
0状态已上报
1中继错误

otto logs export​

将操作日志切片以 NDJSON 格式导出到 stdout 或文件。

用法​

otto logs export [options]

标志​

标志简写必填类型默认值允许值描述
--source否stringallrelay、controller、node、all按来源过滤
--latest否number导出最新的 N 条条目
--since否stringISO-8601 日期时间导出此时间戳之后的条目
--level否stringdebug、info、warn、error按级别过滤
--node-id否string按节点 ID 过滤
--request-id否string按 requestId 过滤
--output-o否stringstdout输出文件路径

示例​

# 导出最新 500 条中继条目
otto logs export --source relay --latest 500

# 导出到文件
otto logs export --source all --latest 1000 --output ./logs.ndjson

# 导出事件关联日志
otto logs export --request-id <requestId> --source all

退出码​

码含义
0导出完成
1中继错误或写入失败

相关命令​