跳到主内容
版本: 1.x

日志

POS 有两个日志界面：应用内日志屏幕（POS 应用程序内部）和 WP Admin 日志页面（WordPress 内部）。它们一起为您提供 POS 活动的完整图景，用于调试和审计。

POS 应用程序日志​

访问日志​

从左侧导航抽屉（心跳图标）打开日志屏幕。

界面概述​

搜索和过滤​

  • 搜索日志 - 通过消息内容查找特定日志条目
  • 日志级别过滤器 - 按日志级别过滤（info、warn、error）
  • 显示设置 - 配置可见列

日志表​

每个日志条目显示：

列描述
时间事件发生的时间
级别严重性：info（灰色）、warn（橙色）、error（红色）
消息人类可读的事件描述
上下文可展开的 JSON 附加详细信息
代码错误代码（链接到文档）

日志级别​

Info（灰色）​

正常操作和成功事件：

  • “获取了所有产品的 ID”
  • “同步了新客户”
  • “获取了所有税收的 ID”

Warning（橙色）​

可能需要注意的非关键问题：

  • “无法刷新会话”
  • “同步重试尝试”

Error（红色）​

需要解决的问题：

  • “对不起，您无法列出资源”（权限问题）
  • “API 请求失败”
  • “数据库同步错误”

Audit（蓝色）​

审计日志级别记录 POS 对数据库所做的更改，捕获每次修改前后的完整状态。这对于精确跟踪何时更改了什么很有用，例如在创建订单、库存调整或客户更新期间。

审计条目包括：

  • 实体类型 - 被修改的资源（例如订单、产品、客户）
  • 操作 - 更改类型（创建、更新、删除）
  • 更改前状态 - 更改前的先前值
  • 更改后状态 - 更改后的新值

上下文数据​

点击任何日志条目的展开箭头以查看详细的 JSON 上下文：

{
  "total": "6",
  "execution_time": "54.79 ms",
  "server_load": "[10.51, 10.42, 9.98]"
}

这些数据包括：

  • 项目计数 - 受影响的记录数量
  • 执行时间 - 操作耗时
  • 服务器负载 - 服务器性能指标
  • 请求/响应详细信息 - 供 API 问题调试使用

错误代码​

许多日志条目包含 错误代码（例如，API02004、DB01001）。这些代码直接链接到 错误代码 文档，该文档提供：

  • 错误的详细解释
  • 常见原因
  • 故障排除步骤

常见日志条目​

同步操作​

[info] Fetched all IDs for products    {...} 3 items
[info] Synced new customers            {...} 1 item
[info] Fetched all IDs for taxes       {...} 3 items

这些指示正常的同步活动。上下文显示同步了多少项目。

权限错误​

[error] Sorry, you cannot list resources    {...} API02004

这通常意味着用户没有权限访问资源。检查 WP Admin > POS > Settings > Access 中的用户角色。

会话问题​

[warn] Unable to refresh session    {...} API02007

POS 无法刷新身份验证会话。这可能需要注销并重新登录。

WP Admin 日志页面​

POS 插件还在 WordPress 管理区域提供了一个服务器端日志页面。此页面显示在服务器上记录的 POS 特定警告和错误，这有助于诊断可能不会出现在 POS 应用程序本身中的问题。

访问 WP Admin 日志页面​

导航到 WP Admin > POS > Settings，然后选择 Tools 选项卡并点击 Logs。

未读徽章​

Logs 菜单项显示一个指示未读日志条目的徽章：

  • 红色徽章 - 有未读的 error 级别条目
  • 琥珀色徽章 - 有未读的 warning 级别条目（但没有错误）

访问 Logs 页面会重置未读计数。计数按用户跟踪，因此每位管理员都看到自己的未读状态。

过滤条目​

使用级别过滤器缩小日志条目范围：

  • All - 显示所有日志条目
  • Errors - 仅显示 error 级别条目
  • Warnings - 仅显示 warning 级别条目

可展开条目​

较长的日志消息会在大约 100 个字符处被截断。点击某个条目以将其展开，查看完整消息以及任何附加上下文数据。

分页​

日志条目在服务器端分页。使用分页控件浏览较早的条目。

致命错误横幅​

如果服务器上有 fatal-errors-*.log 文件，Logs 页面会在顶部显示一个警告横幅。此横幅链接到 WooCommerce > Status > Logs，您可以在那里查看完整的致命错误日志。致命错误通常是阻止 POS API 响应的 PHP 级崩溃。

使用日志进行支持​

请求支持时：

  1. 重现问题 - 执行导致问题的操作
  2. 检查日志 - 查找错误（红色）或警告（橙色）
  3. 展开上下文 - 获取完整的 JSON 详细信息
  4. 记录错误代码 - 在支持请求中包含此项
  5. 复制相关条目 - 与上下文共享日志消息

性能监控​

日志包括执行时间和服务器负载指标。如果您注意到：

  • 高执行时间 - 服务器可能过载或缓慢
  • 高服务器负载值 - 考虑服务器优化
  • 频繁超时 - 检查网络连接
错误代码详细的错误解释
故障排除常见问题和解决方案
支持获得帮助