Monitoring & Logs
Monitoring & Logs
Section titled “Monitoring & Logs”Monitor your server with activity logs, player statistics, and detailed performance metrics.
Activity Log
Section titled “Activity Log”The Activity Log tracks all significant events on your server.
Accessing the Log
Section titled “Accessing the Log”Navigate to Activity in the sidebar to view the activity log.
Event Categories
Section titled “Event Categories”| Category | Events Tracked |
|---|---|
| Player | Joins, leaves, kicks, bans |
| Server | Start, stop, restart, crashes |
| Backup | Creation, restoration, deletion |
| Config | Settings changes, file edits |
| Mod | Install, update, remove |
| User | Panel user actions |
| System | System events, updates |
Filtering
Section titled “Filtering”- Click the Filter dropdown
- Select one or more categories
- Log updates to show matching entries
Log Entry Information
Section titled “Log Entry Information”Each entry shows:
- Timestamp - When the event occurred
- Category - Event type (color-coded)
- User - Who performed the action
- Details - Description of what happened
- Status - Success/failure indicator
Clearing the Log
Section titled “Clearing the Log”Users with activity.manage permission can clear the log:
- Click Clear Log
- Confirm the action
- All entries are removed
API Endpoints
Section titled “API Endpoints”| Method | Endpoint | Description |
|---|---|---|
| GET | /api/management/activity | Get activity log |
| POST | /api/management/activity/clear | Clear activity log |
Permissions
Section titled “Permissions”| Permission | Description |
|---|---|
activity.view | View activity log |
activity.manage | Clear activity log |
Statistics Dashboard
Section titled “Statistics Dashboard”View comprehensive player and server statistics.
Accessing Statistics
Section titled “Accessing Statistics”Navigate to Statistics in the sidebar.
Player Statistics
Section titled “Player Statistics”| Metric | Description |
|---|---|
| Total Players | All-time unique players |
| Peak Online Today | Highest concurrent today |
| Active Players (7d) | Players active in last week |
| New Players (7d) | First-time joins this week |
Playtime Statistics
Section titled “Playtime Statistics”| Metric | Description |
|---|---|
| Total Playtime | Sum of all player time |
| Average Playtime | Per player average |
| Sessions per Player | Average login count |
Weekly Activity Chart
Section titled “Weekly Activity Chart”A visual chart showing:
- Daily unique player counts
- 7-day trend visualization
- Peak day indicators
Top Players
Section titled “Top Players”List of most active players:
- Player name
- Total playtime
- Session count
- Last seen
API Endpoints
Section titled “API Endpoints”| Method | Endpoint | Description |
|---|---|---|
| GET | /api/scheduler/statistics/players | Player statistics |
| GET | /api/scheduler/statistics/activity | Daily activity data |
Performance Monitoring
Section titled “Performance Monitoring”Real-time server performance monitoring with detailed metrics.
Accessing Performance
Section titled “Accessing Performance”Navigate to Performance in the sidebar.
Live Metrics
Section titled “Live Metrics”The dashboard shows real-time values for:
- CPU Usage - Percentage (process and system)
- Memory Usage - Heap and non-heap
- TPS - Ticks per second (target: 20)
- Players - Current online count
- Status - Server state
Performance Graphs
Section titled “Performance Graphs”Four real-time graphs display:
- CPU Usage - 60-point history
- Memory Usage - Heap allocation over time
- Players - Online player count history
- TPS - Server performance trend
TPS Thresholds
Section titled “TPS Thresholds”| TPS Range | Status | Indicator |
|---|---|---|
| 19+ TPS | Good | Green |
| 15-18 TPS | Warning | Yellow |
| Below 15 TPS | Critical | Red |
Prometheus Integration
Section titled “Prometheus Integration”For detailed metrics, install the ApexHosting:PrometheusExporter plugin.
JVM Metrics
Section titled “JVM Metrics”| Metric | Description |
|---|---|
| Heap Memory | Used, committed, max |
| Non-Heap Memory | Metaspace, code cache |
| Memory Pools | Eden, Survivor, Old Gen |
Thread Metrics
Section titled “Thread Metrics”| Metric | Description |
|---|---|
| Current Threads | Active thread count |
| Daemon Threads | Background threads |
| Peak Threads | Maximum reached |
Server Metrics
Section titled “Server Metrics”| Metric | Description |
|---|---|
| Sessions | Join/leave counts |
| Worlds Loaded | Number of active worlds |
| Players per World | Distribution by world |
| GC Statistics | Garbage collection data |
Performance API
Section titled “Performance API”| Method | Endpoint | Description |
|---|---|---|
| GET | /api/server/memory | JVM memory stats |
| GET | /api/server/tps-metrics | TPS from Prometheus |
| GET | /api/server/prometheus | Full Prometheus metrics |
| GET | /api/management/stats/history | Historical statistics |
Permissions
Section titled “Permissions”| Permission | Description |
|---|---|
performance.view | View performance metrics |
Whitelist & Ban Management
Section titled “Whitelist & Ban Management”Dedicated interface for managing server access.
Accessing
Section titled “Accessing”Navigate to Whitelist in the sidebar.
Whitelist Tab
Section titled “Whitelist Tab”Enable Whitelist
Section titled “Enable Whitelist”- Toggle the Enable Whitelist switch
- Only whitelisted players can join
Adding Players
Section titled “Adding Players”- Enter player name in the input field
- Click Add
- Player appears in the list
Removing Players
Section titled “Removing Players”- Find the player in the list
- Click the Remove (X) button
- Player is removed from whitelist
Bans Tab
Section titled “Bans Tab”Banning Players
Section titled “Banning Players”- Switch to Bans tab
- Enter player name
- Optionally add a reason
- Click Ban
Unbanning Players
Section titled “Unbanning Players”- Find the player in the ban list
- Click Unban
- Player can rejoin the server
Search
Section titled “Search”Both lists support search:
- Type in the search field
- List filters in real-time
API Endpoints
Section titled “API Endpoints”| Method | Endpoint | Description |
|---|---|---|
| GET | /api/management/whitelist | Get whitelist status |
| PUT | /api/management/whitelist | Update whitelist settings |
| POST | /api/management/whitelist/:player | Add to whitelist |
| DELETE | /api/management/whitelist/:player | Remove from whitelist |
| GET | /api/management/bans | Get ban list |
| POST | /api/management/bans | Ban a player |
| DELETE | /api/management/bans/:player | Unban a player |
Permissions
Section titled “Permissions”| Permission | Description |
|---|---|
players.whitelist | Manage whitelist |
players.ban | Ban players |
players.unban | Unban players |