Logs
The Logs page provides a comprehensive audit trail of all system events in HandyCafe. Every significant action -- from session starts to cashier logins -- is recorded here for accountability, troubleshooting, and compliance purposes.
Performance
The log viewer uses virtual list rendering to maintain smooth performance even when displaying thousands of entries. This means only the visible rows are rendered in the DOM at any time, allowing the system to handle 1,000+ log records without interface degradation.
Log Entry Fields
Each log entry contains the following fields:
| Field | Description |
|---|---|
| Timestamp | Date and time the event occurred |
| Source | The system component that generated the event |
| Category | Classification of the event (see categories below) |
| Action | Specific action type (see common actions below) |
| PC | The client PC or console involved, if applicable |
| IP | IP address associated with the event |
| Member | The member involved, if applicable |
| Cashier | The cashier who triggered or was on duty for the event |
| Message | Human-readable description of what happened |
Log Categories
Events are classified into 8 categories:
- Server -- Server startup, shutdown, configuration changes, and system-level events.
- Client -- Client connections, disconnections, and state changes.
- Cashier -- Cashier login, logout, and administrative actions.
- Member -- Member registration, profile updates, and account changes.
- Session -- Session lifecycle events (start, stop, pause, resume).
- Console -- Console-related events (additions, removals, session assignments).
- Order -- Order creation, modification, and closure events.
- Payment -- Payment processing, refunds, and financial transaction events.
Common Logged Actions
The following actions appear frequently in the log:
startSession-- A new session was started on a client or console.stopSession-- An active session was ended.pauseSession-- A running session was paused.resumeSession-- A paused session was resumed.consoleAdded-- A new gaming console was registered in the system.newMemberAdded-- A new member account was created.orderCreated-- A new product order was placed.orderClosed-- An order was completed and closed.cashierLogin-- A cashier logged into the system.cashierLogout-- A cashier logged out.serverStarted-- The HandyCafe Server application was started.clientConnected-- A client PC established a connection to the server.clientDisconnected-- A client PC disconnected from the server.
Filtering and Search
Category Filter
Select one or more categories to narrow the log display. For example, show only Session and Payment events to audit financial activity.
Action Filter
Filter by specific action types to find particular events quickly.
Date Range Filter
Restrict the log view to a specific time period. Combined with other filters, this makes it straightforward to investigate incidents that occurred during a known time window.
Sort Options
Sort log entries by any field in ascending or descending order. Sorting by timestamp (newest first) is the default.
Text Search
A free-text search box matches against all fields, allowing you to search for a specific hostname, IP address, member name, or any keyword in the log messages.
Permissions
Access to the Logs page is controlled by the following permissions:
| Permission | Description |
|---|---|
LOG_VIEW |
Required to access the Logs page at all |
LOG_DISPLAY_FULL |
Allows viewing the complete log history |
LOG_DISPLAY_TODAY |
Restricts the view to today's entries only |
LOG_DELETE |
Allows deleting log entries |
A cashier with LOG_VIEW and LOG_DISPLAY_TODAY can review today's events but cannot access historical data. Only users with LOG_DISPLAY_FULL can browse the entire log archive.
Real-Time Updates
New log events appear automatically in the viewer as they occur. The system listens for log events via the TCP event connection so there is no need to manually refresh the page. A log cache improves performance by reducing repeated database queries when scrolling through recent entries.