命令日志
CLI 机器的每项操作都会在其日志中留下记录:激活、主机列表、运行、代码片段、MCP 工具、确认、轮换、退出登录、撤销。可以在设置 › CLI 机器中打开该机器查看,也可以在 https://app.konsolity.com/cli-machines 上查看。
开始与结束
对于一次运行,CLI 会在启动命令之前写入一行,结束时再写入第二行,记录退出码和耗时。如果写入开始记录失败(网络中断、服务器无法访问),命令不会运行:没有记录就不会执行任何操作。
服务器自身会写入与其相关的事件:激活、令牌轮换、撤销、确认、因范围而拒绝。
每行的内容
- 时间:日期和时间;
- 工具:
hosts、run、snippet、sessions、mcp:<tool>、serve:<tool>、login、rotate、logout; - 主机:其标签;
- 命令:其文本,最多 4,000 个字符;
- 决定:已允许(附带允许它的规则)、已拒绝、在确认时已批准或已拒绝;
- 运行的退出码和耗时;
- CLI 会话,以及相关的确认请求(如有)。
日志不包含的内容
从不包含命令的输出。从不包含密码、密钥、令牌或机器密钥。
保留期限
各行内容会静态加密并保留 90 天,之后删除。撤销机器不会删除其日志:日志在 90 天期满前仍可查看。
筛选
可按机器(在机器页面)、时间段(起止日期)和决定(已允许、已拒绝、已确认、未确认)筛选:最新的记录显示在最前面,点击“更早的记录”加载其余内容。导出使用相同的筛选条件。
导出
导出会为所选时间段生成一个 CSV 文件(电子表格,英文表头)或一个 JSON 文件(工具、归档)。如果需要保留超过 90 天的记录,请每月导出一次。
最佳实践
- 扩大范围后请查看日志:拒绝记录会显示有哪些尝试。
- 合法命令反复被拒绝,说明需要添加一条规则;意外的拒绝则说明有需要调查的请求。
- 只有开始记录而没有结束记录,表示命令被中断(撤销、结束会话、故障)。