审计日志
查看组织中所有改变状态的操作历史:谁在何时、从何处执行了什么操作。记录仅可追加,任何篡改均可检测。
审计日志以可搜索、可筛选的时间线,展示组织中支持记录的管理操作,包括角色分配、引擎编辑和 API 密钥签发。详见覆盖范围限制。审计日志和角色与权限均需 Enterprise 套餐才能使用。
日志在数据库层面仅允许追加:应用程序的数据库连接无法更新、删除或清空审计记录。一经写入,记录便会原样保留。
记录哪些信息 #
每个事件都会记录操作者、操作、目标,以及接收请求时的 HTTP 上下文。
| 字段 | 说明 |
|---|---|
| 操作者 | 执行操作的用户或 API 密钥 |
| 操作 | 表示操作类型的值,例如 engine.created 或 member.role_changed |
| 目标 | 操作涉及的实体(例如引擎、角色或术语表条目) |
| 元数据 | 相关实体的 ID,绝不记录名称、电子邮件地址或内容片段 |
| 请求上下文 | request_id、IP 地址、用户代理,在通过 HTTP 接收到调用时记录 |
| 时间戳 | UTC 时间,以及用于检测序列缺口的单调递增序号 |
仅存储 ID,是刻意的设计
元数据列只存储 ID,不存储可直接阅读的值。界面在读取时关联当前名称,因此重命名引擎或用户不会改写历史记录。这也避免了审计记录与 GDPR 删除权发生冲突,因为记录中没有需要删除或遮蔽的内容。
覆盖哪些操作 #
事件按类别分组,与仪表板中的筛选类别一致。
| 类别 | 目前已接入的操作 |
|---|---|
| 组织 | org.created, org.settings_updated, org.deleted |
| 成员 | member.invited, member.removed, member.role_changed |
| 角色 | role.created, role.updated, role.deleted |
| 引擎 | engine.created, engine.updated, engine.deleted |
| API 密钥 | api_key.created, api_key.revoked |
| 内容 | glossary_item.*, instruction.*, brand_voice.*(仅限单项操作) |
访问日志 #
审计日志入口始终显示在设置的管理下。未开通此功能时,页面会显示“你的套餐不支持审计日志”,而不是时间线。进入页面后,你会看到:
- 可筛选列表 — 按操作、操作者和时间段缩小范围(可选择最近 7 天等预设,或设置开始日期 / 结束日期范围)。无法选择未来日期。
- 加载更早的事件 — 事件按从新到旧的顺序排列;点击列表底部的加载更早的事件即可加载下一页。
- 事件详情 — 点击任意行即可原位展开,查看完整的元数据、请求 ID、IP 地址和用户代理。
- 可分享的视图 — 筛选条件和已展开的事件都会体现在 URL 中,因此任何视图都可以分享。
谁可以查看 #
访问此页面需要满足两个条件:
- 功能开通 — 组织必须已启用审计日志功能(需要 Enterprise 套餐)。
- 权限 — 查看者的角色必须包含
org:view_audit_logs。预置的完全访问角色默认包含此权限;所有者始终拥有此权限。
没有此权限的成员会看到“无权访问”页面,而不是时间线。组织未开通此功能时,其成员会看到付费提示页面。
如果你的 Enterprise 套餐失效
审计日志与 RBAC 受同一套餐级别的功能授权控制。历史事件仍会保留在数据库中,但页面会显示“你的套餐不支持审计日志”,读取端点会返回 403,直到套餐恢复。
篡改检测 #
审计日志不只是留存记录,还能切实增加事后篡改的难度。
- 数据库层面仅允许追加。 创建表的数据库迁移会对 API 角色执行
REVOKE UPDATE, DELETE, TRUNCATE。此后,任何试图更改记录的代码路径,无论是漏洞、新端点,甚至 SQL 注入,都会在改动发生前被 Postgres 拒绝。 - 单调递增序列。 每条记录都有一个严格递增的
seq列。审计人员检查序列时,可以通过序号缺口发现删除行为。
这些措施足以满足 SOC 2 一类的控制要求,但无法防御持有生产数据库直接访问凭据的攻击者。如有需要,可提供更强的防护方案(独立的所有者角色、WORM 镜像)。
保留期限 #
审计事件默认永久保留。自定义保留期限(通常为 1 年、3 年或 7 年)需使用 Enterprise 套餐。如果你需要特定的保留策略来满足合规要求或填写安全问卷,请联系我们。
未覆盖的范围 #
第一版有几项刻意设置的限制,请留意:
- 尽力写入,不保证事务性。 事务性写入已列入近期开发计划。审计事件在其描述的操作完成后写入,不与该操作处于同一个数据库事务中。在少数故障情况下(操作成功,但随后插入审计记录失败),操作可能已发生,却没有对应的事件记录。
- 部分操作类型尚未接入。 引擎成员变更、集成连接 / 更新 / 断开连接、模型配置编辑、计费订阅变更,以及批量内容操作(CSV 上传、
createMany/updateMany/deleteMany)目前还不会生成事件。相关操作标识已预留,接入后便会出现在现有的筛选类别下。 - 不审计读取操作。 查看审计日志本身、浏览引擎请求日志或下载术语表都不会生成事件。只有改变状态的操作才会生成事件。
- 暂不支持导出。 审计数据通过仪表板展示。CSV 导出、SIEM Webhook 和 S3 镜像已列入开发计划,如有需要,请告诉我们。
- 没有按引擎划分的视图。 组织的所有审计事件都显示在同一条时间线上。可按操作或操作者筛选,缩小查看范围。
- 不支持实时追踪。 没有刷新按钮,也没有 WebSocket 数据流;请重新加载页面以获取最新事件。