审计轨迹

对项目的更改会被记录下是谁做的、做了什么以及何时做的。拥有该权限的团队成员可以在控制台中读取这份轨迹。

条目包含什么

一条条目会指明操作者的类型和 id(团队成员、服务或你的某个用户)、操作、所触及的资源、提交时间,以及发出该更改的请求的 id。它记录的是某项更改发生了,不保存更改前后的值。

与更改一同写入

每条条目都与它所描述的更改在同一个数据库事务中写入,因此两者不会只存在其一。即使某项更改本身不产生事件,也仍然会有一条条目,以被调用的操作命名。

在控制台中查看

“审计日志”界面位于“访问”之下,可按操作、资源类型、资源 id、操作者和日期范围过滤。查看它需要 audit:read 权限。在两个现成的角色中,工作区管理员拥有该权限,项目管理员没有。

这份轨迹涵盖项目的事件和工作区自身的事件,例如成员的添加和移除。如果处于某个组织之中,它会显示该组织及其下属组织的内容。

你会在其中看到什么

已撤销的 API 密钥 会被记录,记录所有者的变更也会被记录,包含密码哈希的导出也会被记录,AI 助手所做的更改同样如此,并归属于它所代表的人。每一次支持访问请求、批准和拒绝也都在其中。

保留 90 天

这份轨迹背后的事件日志在每个套餐上都提供 90 天的窗口。如需查看项目更长时间的历史,请使用持有 events:list.project 的机密密钥,通过事件日志 API 向前读取日志,并自行存储。早于 90 天的游标会被拒绝,错误信息会指明从哪里继续。公开密钥或已登录用户的令牌无法读取该日志。

阅读详情

事件日志参考文档介绍了事件包含的内容、90 天的窗口,以及如何把日志向前读取到你自己的存储中。