审计日志
Audit Log
中级通用审计日志（Audit Log）是记录账号或系统身份对重要资源做了什么、何时做以及结果如何的记录。它帮你在权限变更、数据删除等事件发生后还原过程，例如查清是谁把某位成员设为管理员。
你可能会说：「帮我记下后台是谁改了成员权限，之后有人问起来能查到具体改动和结果。」
动手看看追查成员的管理员权限
切换操作结果，再按目标成员筛选日志、展开详情。上方是林晓的当前角色，下方是事件记录；筛选只改变可见记录，不会删除历史。
林晓现在是管理员，但当前角色不会告诉你是谁改的。日志补上了陈悦、10:42:16、角色变更和成功结果，才能还原这一步。
详情把操作者和目标账号分开，还展示变更前后值。按林晓筛选找到的是“涉及林晓”的事件，不代表这些操作都是林晓做的。
要点审计日志怎样帮你还原一次操作？
- 1
把操作者和操作对象记清楚
只写“权限已修改”，你还是不知道该找谁核实。记录里要能对应到操作者、被修改的成员或资源，以及具体动作；如果是系统任务代为执行，也要让你看得出执行来源。
- 2
记录时间结果和关键变化
你排查问题时，不仅想知道有人点过按钮，还想知道操作有没有成功、改动前后是什么。比如把成员角色从编辑者改成管理员，记录这两个值比只记“更新成员”更有用。
- 3
让记录能查又不轻易被改
审计日志通常要在事后供有权限的人检索，所以你会关心保存期限、查询权限，以及记录是否可能被随意修改或删除。同时别把密码、令牌等秘密直接写进去，否则排查入口反而会带来泄露风险。
容易混淆的地方
审计日志关注的是重要操作的责任与变化；服务端日志更多用来排查请求报错、程序运行问题，内容可能很杂。埋点则主要回答用户怎样使用产品，比如某个功能被点击了多少次。三者都可能记时间和事件，但你要追查“谁改了权限、改成什么、是否成功”时，审计日志更合适。
什么时候用
适合用
- 团队后台允许管理员调整成员角色，你需要在权限争议发生时查到是谁改的、改了什么。
- AI Agent 能替用户删除项目或修改共享设置，你想区分用户发起的请求和 Agent 实际执行的操作。
- 客服后台能查看或导出客户资料，你需要追查敏感数据曾被哪个账号访问或导出。
不适合用
- 你只想知道首页有多少人点击注册入口，用事件埋点和统计报表更直接。
- 你在排查接口为什么返回错误，先看服务端日志和报错信息，而不是把每条调试信息写进审计日志。
- 你想让用户找回自己草稿的上一版内容，用版本历史或撤销功能；审计日志不是草稿恢复工具。
练一练选一个答案，看看解释
团队成员说自己的管理员权限无故消失。你正在设计后台记录，哪种方案最能帮助事后查清这次变更？
让 AI 帮你做复制给 AI Agent 直接用
请为团队后台设计审计日志：记录成员权限变更的操作者、目标成员、时间、变更前后角色和执行结果。说明查询权限与保存方式，并避免在记录中写入密码或令牌。