跳到主内容
版本: 1.x

商店健康

v1.10.0 新增

商店健康在 WCPOS v1.10.0 中引入。它取代了原来独立的日志屏幕,并新增了对同步状况、本地数据覆盖情况和服务器负载的实时可见性。

商店健康 是 POS 的仪表板,展示您的设备与 WooCommerce 商店之间发生的一切。请从导航抽屉(心跳图标)中打开它。它包含三个选项卡:性能数据库日志

性能

性能选项卡回答的问题是“POS 给我的服务器带来了多少开销,同步是否健康?”

  • 状态行——✓ 正常⚠ 需要关注,依据引擎的当前状态判断(已经恢复的短暂故障不会连续一天向您报警)。
  • 实测活动——过去 24 小时内发出的请求数和典型响应时间,是本收银台的实际测量值,而非估算值。传输数据量是一个下限,因为未声明大小的响应计为零。
  • 运行状况条——过去 24 小时中每小时一格。绿色表示该小时内的请求均无错误完成;琥珀色表示至少有一个请求失败(哪怕只有一个——没有阈值);空白表示应用当时未运行。
  • 下次检查倒计时——距离下一次变更检查还有多久。在空闲的收银台上,它显示的时间可能合理地长于所配置的间隔,因为检查带有抖动,并且在空闲 10 分钟后会放慢。安静的收银台上倒计时较长是正常现象,并不代表同步停滞。

同步预设

三张预设卡片通过两个调节项设定本设备的同步积极程度——POS 检查变更的频率,以及每次请求获取的记录数:

预设检查间隔每次请求的记录数
节能5 分钟25
均衡(默认)60 秒50
实时10 秒75

共享主机或经济型主机请选择 节能;当多台收银台需要快速看到彼此的更改且服务器负担得起时,请选择 实时自定义 滑块会开放完整范围(5 秒–5 分钟,10–100 条记录)。

有两点需要了解:

  • 设置按设备生效。 调整一台收银台不会影响其他任何设备——您想调整的每台收银台都需要重复该更改。
  • 调节项旁显示的 约 N 次请求/天 是根据所配置间隔推导出的名义检查频率,既不是上限也不是预测值。抖动可能使实际数量上下浮动;无变更的 304 开销很低,但仍计为一次请求。空闲衰减只会降低快于其 60 秒下限的预设的请求量,因此不会让均衡预设变得更慢。

更改立即生效,无需重启。有关这些数字背后的工程原理,请参见 同步性能

数据库

数据库选项卡回答的问题是“这台设备上有什么,以及是否所有内容都已送达我的服务器?”

顶部有四个磁贴:可开始销售 里程碑、本设备上的记录数、已用存储空间,以及等待发送的更改数。

“可开始销售”是一个里程碑,而不是完整下载的门槛

只要设备上有了第一件产品,它就会翻转为已达成。离线并不会阻止它——设备上已有产品的收银台就可以离线销售。这正是本地优先 POS 的意义所在。

覆盖表

每个同步的集合都有一行:设备上服务器上 以及一根覆盖率条。这些数字遵循严格的诚实原则——服务器上 的总数始终是服务器真实上报的数字,绝不是猜测:

  • 正在检查…——POS 还没有获得最新的服务器总数。如果某一行保持这个状态超过约 15 分钟,说明该集合的 REST 路由可能出现故障;请查看 日志
  • 覆盖率条不满通常是正常的。 客户会在空闲时间逐步下载,分类和优惠券在首次打开时下载,而 订单 条是相对于您的整个订单历史来衡量的,而收银台有意只保留未结和最近的订单——因此在完全健康的收银台上,订单也会显示为部分覆盖。
  • 在执行“清除并重新下载”之后,计数为空或偏低是设计使然的结果,而不是同步停滞——按需下载的集合会在使用过程中重新填充,每一行的说明文字都会告诉您该集合是如何重新填充的。

从未送达服务器的更改

如果您的服务器永久性地拒绝了某项更改(例如,某笔销售创建时站点认为该请求无效而拒绝了它),POS 不会 无声地永远重试,也不会把它藏起来。该更改会被搁置并在此列出,同时附带服务器给出的原因、发生时间以及两个操作:

  • 重新发送——根据记录 当前 的状态重新构建请求并再次排队。如果同一字段再次被拒绝,尝试次数会明显增加,而不会假装成功。
  • 放弃——丢弃该更改。确认对话框会准确告诉您放弃对该记录意味着什么(包括当该记录只存在于本设备上时,放弃就等于删除它)。

恢复始终是一次刻意且可见的操作——这里没有任何自动行为。

清除并重新下载

每个集合行都提供 清除并重新下载,它会移除该集合的本地副本并重新获取。确认框会说明将移除多少条记录、大约多少存储空间,以及哪些内容会安全地留在服务器上。请优先使用它,而不是清除全部本地数据——它是有针对性的,而且不会让您退出登录。清除所有本地数据 仍然是彻底的重置手段。

日志

日志选项卡是本设备上同步活动的流水账:每行包含 时间、级别、事件、时长、状态,保留 30 天。

  • 预设筛选器——全部 / 操作 / 错误 / 同步,另有一个 详细诊断 开关,可捕获 24 小时的额外细节,然后自动关闭。
  • 行详情——错误和警告可展开,显示通俗易懂的原因、一行数据安全说明、建议的下一步操作,以及指向 错误代码 的帮助链接。每个详情视图都带有可复制的事件代码——联系支持团队时请附上它。
  • 日志条目在显示时会被翻译,因此几个月前写入的一行会以收银台今天所用的语言呈现;事件代码才是稳定的标识符。
两个选项卡,两个计数

日志选项卡仅根据日志条目推导其卡住记录的计数;数据库选项卡还会计入被搁置的、遭拒绝的更改。当两者不一致时,以数据库选项卡为准,它才是判断哪些内容尚未送达服务器的权威。