跳到内容
ClickHouse Loom
Esc
↑↓导航↵打开⌘J预览
本页内容

`audit` 操作

本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.

每个 audit.* 操作接受和返回的确切字段。

每个 op 都是 HTTP 上的 POST /v1/<op>,也是 MCP 工具 loom_<op>。身份字段(org、namespace、agent、user_id、session_id)在传输层能够提供时,由令牌和 MCP 会话填充;对于单用户服务器上不带令牌的 HTTP 调用,除 code.* 和 tracker.*(它们保留各自平面的 org)之外,所有 op 都使用该安装的 org,并且在部分 op 上还会填充其命名空间和 agent;参见身份与命名空间。操作索引解释了角色、类型以及 MCP 的 all 列表。未知的输入字段仍会被处理,并在 ignored_args 中列出。

audit.list

查询审计日志(每行带有防篡改哈希)。

POST /v1/audit.list · MCP loom_audit_list · 角色 viewer · 读取 · 未列在 MCP all 工具集中

输入字段 类型 默认值 含义
org str 必填 租户(身份元组的第一个元素)。
namespace str | None None None:调用方可读取的所有命名空间;指定一个其无权读取的命名空间会返回空页。
event_type str | None None 精确匹配
since datetime | None None 仅返回 ts >= since 的行
limit int 50 每页最多返回的行数,按最新优先;范围 1 到 500。
cursor str | None None 来自上一页的不透明令牌
fields list[str] | None None 调用方要读取的输出字段(白名单,依据行模型解析;未知名称会返回 422);未设置时返回所有字段。
输出字段 类型 含义
rows list[AuditListRow] 审计行的一页,按最新优先(相同时间按 request_id 排序)。
next_cursor str | None 作为 cursor 传回以获取下一页(更早的一页);当前页为最后一页时为 None。

这个页面有帮助吗?