Statistics Dashboard

Monitor real-time and historical resource usage across all users.

Statistics Dashboard Real-time resource monitoring showing CPU, Memory, and IO usage.

Accessing Statistics

Navigate to Statistics in the Admin Panel. The dashboard has four tabs:

Current Usage Tab

Real-time resource monitoring shows live data for all users.

Metrics Displayed

ColumnDescription
UserUsername
CPURegular CPU usage percentage
DB CPUDatabase CPU usage percentage
Total CPUCombined CPU (CPU + DB CPU)
RAMRegular memory usage in MB
DB RAMDatabase memory usage in MB
Total RAMCombined memory (RAM + DB RAM)
PIDsRegular process count
DB PIDsDatabase process count
IO ReadRead throughput in KB/s
IO WriteWrite throughput in KB/s
IOTotal IO (Read + Write)
EPEntry Processes (current/limit)

Sorting

Click any column header to sort by that metric. Default sorting is by Total CPU.

Data Refresh

Data automatically refreshes at the interval configured in Settings (default: 1 minute).

History Tab

View historical resource usage over time.

Options

OptionValuesDescription
Period1h, 6h, 24h, 7d, 30dTime period to display
User FilterAny userFilter by specific user
Limit1-1000Number of data points

Data Points

History shows collected metrics at regular intervals:

Faults Tab

Shows resource limit violations that have occurred.

Fault Data

FieldDescription
TimeWhen the fault occurred
UserUsername that triggered the fault
TypeFault type (CPU, RAM, IO, EP)
ValueActual value that exceeded limit
LimitThe limit that was exceeded

Options

OptionValuesDescription
Period1h, 6h, 24h, 7d, 30dTime period to search
Limit1-500Number of fault records
Fault Threshold A fault is recorded when a user exceeds their resource limit. This helps identify users consistently hitting their limits.

Top Consumers Tab

Identifies users with the highest resource consumption.

Options

OptionValuesDescription
MetricCPU, RAM, IO, PIDsResource to rank by
Period1h, 6h, 24h, 7d, 30dTime period to analyze
Limit1-100Number of top users to show

Use Cases

Statistics Collection

Statistics are collected by the simuzo-stats service.

Configuration

Settings in Settings → General:

SettingDefaultRangeDescription
Collection Interval1 minute1-60 minutesHow often stats are collected
Retention Period7 days7-365 daysHow long history is kept

Service Management

# Check service status
systemctl status simuzo-stats

# Restart service
systemctl restart simuzo-stats

# View logs
journalctl -u simuzo-stats

Data Storage

Live statistics are stored at:

/run/simuzo/stats.json

Historical data is stored in the Simuzo database.

API Access

Statistics are available via API:

# Get current stats as JSON
GET /admin.php?act=stats&api=json&tab=current

# Get history
GET /admin.php?act=stats&api=json&tab=history&period=24h

# Get faults
GET /admin.php?act=stats&api=json&tab=faults&period=24h

# Get top consumers
GET /admin.php?act=stats&api=json&tab=top&metric=cpu&period=24h

Troubleshooting

Statistics Not Updating

  1. Check service: systemctl status simuzo-stats
  2. Verify file exists: ls -la /run/simuzo/stats.json
  3. Check collection interval in settings
  4. Review logs

Missing Data

  1. Check retention settings
  2. Verify database connectivity
  3. Check disk space
Performance Tip Higher collection frequency and longer retention use more database storage. Adjust based on your needs.

Related Topics