LVE Stats: How It Works

Issue

This article explains how LVE Stats collects and stores data. It displays resource usage statistics for Lightweight Virtual Environments (LVE) on CloudLinux OS — including why multiple lvestats-server.py processes run simultaneously, where the data is stored, and how to read the usage charts.

Environment

• Product: CloudLinux OS
• Component: LVE Stats (lve-stats)
• Operating system: CloudLinux OS (all supported versions)

Solution

1. Three lvestats-server.py processes are expected. For example:

root 24006 0.1 1.7 312132 32620 ? SN Nov28 1:51 /opt/cloudlinux/venv/bin/python3 /usr/share/lve-stats/lvestats-server.py start --pidfile /var/run/lvestats.pid
root 24007 0.4 1.7 459596 32364 ? SNl Nov28 6:10 /opt/cloudlinux/venv/bin/python3 /usr/share/lve-stats/lvestats-server.py start --pidfile /var/run/lvestats.pid
root 24030 0.2 2.4 329940 45252 ? SN Nov28 3:45 /opt/cloudlinux/venv/bin/python3 /usr/share/lve-stats/lvestats-server.py start --pidfile /var/run/lvestats.pid

This is normal behaviour: the main process handles stats parsing, while the other two handle the LVE Stats plugins.

2. Data collection. 
   The main lvestats-server.py process parses the /proc/lve/list file every 5 seconds. The exact interval can vary depending on which plugins are installed, but the average query interval is around five seconds.
3. Data storage. 
   The gathered data is stored in a local SQLite database by default. The storage location can be changed in the lve-stats configuration file. lve-stats can also store data in a MySQL (MariaDB) or PostgreSQL server instead of SQLite.
4. Viewing statistics. 
   End users and server administrators can select a time period and review the number of faults (if any) for all users or for a specific user. In the usage graph:
   • Column A shows the default average value (one minute)
   • Column L shows the current limit
   • Column F shows the number of faults
     
     
      
5. Generating charts from the command line. 
   Administrators can generate the same usage chart from the command line using lvechart.
6. Viewing process snapshots. 
   End users can see a snapshot of their processes directly from their hosting panel. Administrators can retrieve the same snapshots from the command line using lve-read-snapshot.
   
   
    

Useful Links

• CloudLinux OS Components — Plugins
• CloudLinux OS Components — Configuration
• Command-line Tools — lvechart
• Command-line Tools — lve-read-snapshot
• How to configure lve-stats notifications?
• Why LVE stats are not collected for some accounts, or they are not visible in LVE Manager?
• Large LVE Snapshot files
• How to backup and rebuild LVE database
• Centralized Monitoring is not displaying the statistics
• LVE limits default values and recommended values