跳到主要内容

查看谁改了什么

快速检查

将日期范围设为 Last 7 days,然后点击任意一行,即可查看发生变化的具体字段及其变更前后的值。

本指南帮助你查明哪位员工进行了更改、何时进行,以及更改前的值是什么。可将其用于安全审查、交接争议,以及回答“这个设置是谁关掉的?”之类的问题。

查找位置​

前往: Main Menu → Audit Log

这不是入住事件日志

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 和错误信息中的凭据也会被清理。你可以确认某个字段发生了变化,但看不到其中的秘密。超大的数据载荷会被缩短,因此较长的条目可能以截断提示结尾。

查找某一次改动​

  1. 前往 Main Menu → Audit Log

  2. 设置日期范围——Last 24 hours、Last 7 days、Last 30 days 或 All time

    页面默认打开 Last 7 days

  3. 如果知道要查找的内容,可使用 All event types 或 All results 进一步缩小范围

  4. 在搜索框中输入内容,按操作缩小范围

    ✓ 停止输入片刻后,结果会自动更新

  5. 点击该行将其展开

结果每次显示 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 查询时日志仍然为空
  • ❌ 某条目中的操作人是你不认识的

建议一并提供:

  • 改动发生的日期、时间和时区
  • 该员工的姓名或邮箱
  • 改了什么,从什么值改成了什么值