查看谁改了什么
将日期范围设为 Last 7 days,然后点击任意一行,即可查看发生变化的具体字段及其变更前后的值。
本指南帮助你查明哪位员工进行了更改、何时进行,以及更改前的值是什么。可将其用于安全审查、交接争议,以及回答“这个设置是谁关掉的?”之类的问题。
查找位置
Audit Log 记录的是员工在 AVA 中执行的操作。若要追踪客人入住过程中发生了什么,请改用 Command Center 中的审计追踪。
谁可以打开
| 条件 | 说明 |
|---|---|
| 权限 | 你的角色需要具备审计访问权限。没有该权限时,菜单中不会显示 Audit Log |
| 套餐 | 需要有效订阅。免费套餐下菜单项会显示锁形图标,点击后会打开升级提示 |
前往 Settings → Billing & Subscription 升级。
快速参考
| 列 | 显示内容 |
|---|---|
| Timestamp | 发生时间,按你所在酒店的时区显示并标注时区,同时显示距今多久 |
| Actor | 操作人 —— 姓名、用户 ID,以及执行操作时使用的 IP 地址 |
| Action | 执行的操作、事件类型,以及受影响的记录 |
| Outcome | 操作成功、失败还是被拒绝 |
MCP 设置更新会使用 Action 字段标识所运行的工具。 如果工具已到达 Streamliner 后报告失败,Outcome 会显示 Failed。 展开事件即可查看工具的错误详情。
哪些内容会被记录
| 会记录 | 不会记录 |
|---|---|
| 员工登录,包括社交账号登录 | 仅查看或浏览页面 |
| 已登录员工执行的任何更改——新建、更新或删除 | 未登录状态下执行的任何操作 |
| 视频通话活动 | 健康检查和内部系统流量 |
| 钥匙遗失事件 | 少量高频后台调用(见下文) |
AVA 只记录会改变某些内容的操作。打开预订、运行报表或滚动仪表板都不会留下记录。如果你要寻找某人看过某条记录的证据,Audit Log 中不会有这类记录。
为保持日志可读,少量高频例行调用会被有意排除:推送通知的订阅与取消订阅、将所有通知标记为已读,以及后台的客房清洁状态和房间门禁信息刷新。
角色更新会显示角色记录
编辑角色会针对该角色的 ID 记录一个 UPDATE_ROLE 事件。 可通过该事件确认谁修改了角色名称、描述或权限。 成功更新后会显示该事件,包括对全局内置角色的编辑。
敏感值会被隐藏
密码、令牌、凭据、支付卡详情、证件标识符和门禁码会在审计详情中显示为 [REDACTED]。AVA 会在写入新条目时以及读取旧条目时对这些值进行遮蔽。端点查询字符串会被移除,纯文本、URL 和错误信息中的凭据也会被清理。你可以确认某个字段发生了变化,但看不到其中的秘密。超大的数据载荷会被缩短,因此较长的条目可能以截断提示结尾。
查找某一次改动
-
设置日期范围——Last 24 hours、Last 7 days、Last 30 days 或 All time
页面默认打开 Last 7 days
-
如果知道要查找的内容,可使用 All event types 或 All results 进一步缩小范围
-
在搜索框中输入内容,按操作缩小范围
✓ 停止输入片刻后,结果会自动更新
-
点击该行将其展开
结果每次显示 12 条——使用底部的分页器翻阅。
读懂变更详情
展开某行会显示 Field / Before / After 表格,发生变化的行会高亮。None 表示该侧原本没有值——因此 None → 18 表示首次设置某个值,而 18 → None 表示清除某个值。
如果 AVA 无法将条目拆分成字段,则会直接显示原始记录。这同样可读,也是技术支持会要求提供的内容。
读懂汇总卡片
| 卡片 | 统计内容 |
|---|---|
| Events (filtered) | 符合筛选条件的全部事件,跨越所有页面 |
| Security & access | 当前所查看页面上的登录、权限和设置类事件 |
| Failures | 当前所查看页面上标记为失败或错误的事件 |
| Unique actors | 当前所查看页面上的不同员工数 |
只有 Events (filtered) 统计整个筛选结果。另外三张卡片每翻一页都会重新计算。不要把“Failures: 2”理解为整周只有两次失败——它表示你眼前这 12 行中有两次失败。
值得了解的几点
- 筛选列表会自动生成。 All event types 和 All results 根据当前已加载的条目生成。昨天见过的某个类型今天可能不在下拉列表中,只是因为本页没有该类型的条目。放宽日期范围即可让它重新出现。
- 启用 Lost Key 筛选时会忽略搜索。 在事件类型列表中选择 Lost Key 只会返回钥匙遗失事件,搜索框中的内容会被暂时搁置,直到你切换回去。
- 时间戳以酒店为准,而非你的电脑。 时间按物业配置的时区显示,并在括号中标注时区,因此在其他国家查看的管理者与前台看到的时间一致。
- 列表不是实时的。 点击 Refresh 拉取新条目;页头会显示页面上次加载于多久之前。
故障排查
“Audit log API is not available here”
你看到的现象: 该消息取代了列表,没有事件加载出来。
原因: 当前环境无法连接审计服务。
处理方法: 点击 Refresh。若问题持续,请联系支持团队——这不是你能在设置中解决的问题。
“Staff activity history requires an active subscription”
你看到的现象: 菜单项上有锁形图标,或以该消息取代了结果。
处理方法: 在 Settings → Billing & Subscription 启用订阅。
完全没有任何条目
你看到的现象: 显示 “No audit entries yet”。
请检查:
- 日期范围是否足够宽——试试 All time
- 搜索框是否为空
- 两个下拉框是否都已恢复为 All event types 和 All results
找不到我要的那次改动
请按以下顺序检查:
- 日期范围是否覆盖了发生时间
- 该操作是否确实改动了内容——查看页面从不记录
- 是否属于哪些内容会被记录中列出的例行后台调用
- 改动是在 AVA 中进行的,而不是直接在 PMS 中——在 PMS 中直接进行的改动由 PMS 记录,不在这里
- 自动化 MCP 请求是否到达了 Streamliner——在调度前失败的请求不会留下记录
时间看起来不对
你看到的现象: 条目时间与你确知的发生时间相差数小时。
处理方法: 在 Settings → Essentials 检查物业时区。Audit Log 按该时区渲染所有时间戳,因此设置错误会导致整份列表整体偏移。
仍未解决?
遇到以下情况,请联系 success@vouch-technologies.com:
- ❌ 你能证明确实发生过的改动却没有对应条目
- ❌ 不加任何筛选、按 All time 查询时日志仍然为空
- ❌ 某条目中的操作人是你不认识的
建议一并提供:
- 改动发生的日期、时间和时区
- 该员工的姓名或邮箱
- 改了什么,从什么值改成了什么值