查看谁改了什么
把日期范围设为 Last 7 days,然后点击任意一行,即可看到变更前后的具体字段值。
本指南帮助你查明是哪位员工做了改动、什么时候做的,以及改动前的值是什么。适用于安全审查、交接争议,以及"这个设置是谁关掉的?"这类问题。
位置
Audit Log 记录的是员工在 AVA 中的操作。若要追踪客人入住过程中发生了什么,请使用 Command Center 中的审计追踪。
谁可以打开
| 条件 | 说明 |
|---|---|
| 权限 | 你的角色需要具备审计访问权限。没有权限时,菜单中不会出现 Audit Log |
| 套餐 | 需要有效订阅。免费套餐下菜单项会显示锁形图标,点击后打开升级提示 |
前往 Settings → Billing & Subscription 升级。
快速参考
| 列 | 显示内容 |
|---|---|
| Timestamp | 发生时间,按你所在酒店的时区显示并标注时区,同时显示距今多久 |
| Actor | 操作人 —— 姓名、用户 ID,以及操作时使用的 IP 地址 |
| Action | 做了什么、事件类型,以及受影响的记录 |
| Outcome | 成功、失败还是被拒绝 |
哪些内容会被记录
| 会记录 | 不会记录 |
|---|---|
| 员工登录,包括社交账号登录 | 仅仅查看或浏览页面 |
| 已登录员工做出的任何改动 —— 新建、修改或删除 | 未登录状态下的任何操作 |
| 视频通话活动 | 健康检查和内部系统流量 |
| 钥匙遗失事件 | 少量高频后台调用(见下文) |
AVA 只记录改变了某些内容的操作。打开预订、运行报表或滚动仪表板都不会留下记录。如果你要找的是某人看过某条记录的证据,Audit Log 中不会有。
为保持日志可读,少量高频例行调用被有意排除:推送通知的订阅与取消订阅、将所有通知标记为已读,以及后台的客房清洁状态和房间门禁信息刷新。
敏感值会被隐藏
密码、令牌和门禁码在写入记录前会被替换为 [REDACTED]。你可以看到门禁码被改过以及是谁改的,但看不到码本身。超大数据会被截断,因此较长的条目可能以截断提示结尾。
查找某一次改动
-
设置日期范围 —— 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 记录,不在这里
时间看起来不对
你看到的现象: 条目时间与你确知的发生时间相差数小时。
处理方法: 在 Settings → Essentials 检查物业时区。Audit Log 按该时区渲染所有时间戳,设置错误会导致整份列表整体偏移。
仍未解决?
遇到以下情况,请联系 success@vouch-technologies.com:
- ❌ 你能证明确实发生过的改动却没有对应条目
- ❌ 不加任何筛选、按 All time 查询日志仍然为空
- ❌ 某条目中的操作人是你不认识的
建议一并提供:
- 改动发生的日期、时间和时区
- 该员工的姓名或邮箱
- 改了什么,从什么值改成了什么值