# 日志

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

<!-- -->

## POS 应用程序日志[​](#pos-application-logs "直接链接到 POS 应用程序日志")

### 访问日志[​](#accessing-logs "直接链接到 访问日志")

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

### 界面概述[​](#interface-overview "直接链接到 界面概述")

#### 搜索和过滤[​](#search--filter "直接链接到 搜索和过滤")

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

#### 日志表[​](#log-table "直接链接到 日志表")

每个日志条目显示：

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

### 日志级别[​](#log-levels "直接链接到 日志级别")

#### Info（灰色）[​](#info-grey "直接链接到 Info（灰色）")

正常操作和成功事件：

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

#### Warning（橙色）[​](#warning-orange "直接链接到 Warning（橙色）")

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

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

#### Error（红色）[​](#error-red "直接链接到 Error（红色）")

需要解决的问题：

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

#### Audit（蓝色）[​](#audit-blue "直接链接到 Audit（蓝色）")

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

审计条目包括：

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

### 上下文数据[​](#context-data "直接链接到 上下文数据")

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

```
{

  "total": "6",

  "execution_time": "54.79 ms",

  "server_load": "[10.51, 10.42, 9.98]"

}
```

这些数据包括：

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

### 错误代码[​](#error-codes "直接链接到 错误代码")

许多日志条目包含 **错误代码**（例如，`API02004`、`DB01001`）。这些代码直接链接到 [错误代码](/zh-CN/error-codes/.md) 文档，该文档提供：

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

### 常见日志条目[​](#common-log-entries "直接链接到 常见日志条目")

#### 同步操作[​](#sync-operations "直接链接到 同步操作")

```
[info] Fetched all IDs for products    {...} 3 items

[info] Synced new customers            {...} 1 item

[info] Fetched all IDs for taxes       {...} 3 items
```

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

#### 权限错误[​](#permission-errors "直接链接到 权限错误")

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

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

#### 会话问题[​](#session-issues "直接链接到 会话问题")

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

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

## WP Admin 日志页面[​](#wp-admin-logs-page "直接链接到 WP Admin 日志页面")

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

### 访问 WP Admin 日志页面[​](#accessing-the-wp-admin-logs-page "直接链接到 访问 WP Admin 日志页面")

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

### 未读徽章[​](#unread-badge "直接链接到 未读徽章")

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

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

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

### 过滤条目[​](#filtering-entries "直接链接到 过滤条目")

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

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

### 可展开条目[​](#expandable-entries "直接链接到 可展开条目")

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

### 分页[​](#pagination "直接链接到 分页")

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

### 致命错误横幅[​](#fatal-errors-banner "直接链接到 致命错误横幅")

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

## 使用日志进行支持[​](#using-logs-for-support "直接链接到 使用日志进行支持")

请求支持时：

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

## 性能监控[​](#performance-monitoring "直接链接到 性能监控")

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

* **高执行时间** - 服务器可能过载或缓慢
* **高服务器负载值** - 考虑服务器优化
* **频繁超时** - 检查网络连接

## 相关文档[​](#related-documentation "直接链接到 相关文档")

[错误代码详细的错误解释](/zh-CN/error-codes/.md)

[故障排除常见问题和解决方案](/zh-CN/category/troubleshooting.md)

[支持获得帮助](/zh-CN/support/.md)