HandyCafe Docs
owner

日志

日志页面提供了HandyCafe中所有系统事件的详细审计记录。从会话开始到收银员登录的每一个重要操作都在此记录,以便于责任追踪、故障排除和合规目的。

性能

日志查看器使用虚拟列表渲染来保持流畅的性能,即使在显示数千条记录时也是如此。这意味着在任何时候只有可见的行被渲染到DOM中,使系统能够处理超过1000条日志记录而不影响界面性能。

日志条目字段

每个日志条目包含以下字段:

字段 描述
时间戳 事件发生的日期和时间
来源 生成事件的系统组件
类别 事件的分类(见下文类别)
操作 具体的操作类型(见下文常见操作)
电脑 涉及的客户端电脑或控制台(如适用)
IP 与事件关联的IP地址
会员 涉及的会员(如适用)
收银员 触发事件或值班的收银员
消息 对发生事件的人类可读描述

日志类别

事件分为8类:

  1. 服务器 -- 服务器启动、关闭、配置更改和系统级事件。
  2. 客户端 -- 客户端连接、断开和状态变化。
  3. 收银员 -- 收银员登录、注销和管理操作。
  4. 会员 -- 会员注册、资料更新和账户更改。
  5. 会话 -- 会话生命周期事件(开始、停止、暂停、恢复)。
  6. 控制台 -- 与控制台相关的事件(添加、移除、会话分配)。
  7. 订单 -- 订单创建、修改和关闭事件。
  8. 支付 -- 支付处理、退款和财务交易事件。

常见日志操作

以下操作经常出现在日志中:

  • startSession -- 在客户端或控制台上启动了一个新会话。
  • stopSession -- 一个活动会话被结束。
  • pauseSession -- 一个正在运行的会话被暂停。
  • resumeSession -- 一个暂停的会话被恢复。
  • consoleAdded -- 系统中注册了一个新的游戏控制台。
  • newMemberAdded -- 创建了一个新的会员账户。
  • orderCreated -- 下达了一个新的产品订单。
  • orderClosed -- 一个订单已完成并关闭。
  • cashierLogin -- 收银员登录了系统。
  • cashierLogout -- 收银员退出了系统。
  • serverStarted -- HandyCafe服务器应用程序已启动。
  • clientConnected -- 客户端电脑与服务器建立了连接。
  • clientDisconnected -- 客户端电脑与服务器断开了连接。

过滤和搜索

类别过滤

选择一个或多个类别以缩小日志显示范围。例如,仅显示会话和支付事件以审计财务活动。

操作过滤

按特定操作类型过滤,以快速找到特定事件。

日期范围过滤

将日志视图限制在特定时间段内。结合其他过滤器,这使得调查已知时间窗口内发生的事件变得简单。

排序选项

按任意字段升序或降序排序日志条目。默认按时间戳排序(最新优先)。

文本搜索

自由文本搜索框可匹配所有字段,允许您搜索特定的主机名、IP地址、会员名或日志消息中的任何关键词。

权限

访问日志页面受以下权限控制:

权限 描述
LOG_VIEW 访问日志页面所需的权限
LOG_DISPLAY_FULL 允许查看完整的日志历史
LOG_DISPLAY_TODAY 仅限查看今天的条目
LOG_DELETE 允许删除日志条目

拥有LOG_VIEWLOG_DISPLAY_TODAY权限的收银员可以查看今天的事件,但无法访问历史数据。只有拥有LOG_DISPLAY_FULL权限的用户才能浏览整个日志存档。

实时更新

新的日志事件会在发生时自动出现在查看器中。系统通过TCP事件连接监听日志事件,因此无需手动刷新页面。日志缓存通过减少滚动查看最近条目时的重复数据库查询来提高性能。