Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.46

(Home >> Server Configuration >> Statistics Software Configuration)

Overview

This interface allows you to view information about your server’s statistics and statistics software. cPanel & WHM servers include four statistics applications (generators): Analog, AWStats, Logaholic, and Webalizer.

Note:

The /usr/local/cpanel/logs/stats_log file contains the statistics logs for your server. If you experience problems with statistics processing, the log file may provide additional information to troubleshoot the issue.

 

Statistics Status Summary

This section of the interface allows you to view important information about your server's statistics software.

Show which users are behind

Note:

This option only displays if there are cPanel users whose statistics processing is behind the server's processing schedule. If this is the case, a message about the problem will also display.

To display a list of these cPanel users, click Show which users are behind. A table will appear that lists cPanel users, and the number of minutes by which they are behind the processing schedule.

See Specific User's Statistics Summary

To view summaries about statistics processing for your cPanel accounts, perform the following steps:

  1. Select All or a specific cPanel user from the User to Display menu. 
  2. Click Go. A new interface will appear that displays information about processing for that account, as well as specific information for each of the four statistics generators.
  3. Click  Details to view information about a statistics generator. 

A new interface will display the following information :

  1. Whether the statistics generator itself is enabled or disabled.
  2. Whether the Global Generator Defaults setting for the statistics generator is enabled or disabled
    • Click Change to return to the main Statistics Software Configuration interface.
    • You can then use the  Generators Configuration section of the interface to modify the settings for that generator.
  3. Whether the root user has granted the user permission to change the statistics generator configuration. 
    • Click Change to return to the main Statistics Software Configuration interface. 
    • You can then use the  User Permissions section of the interface to modify that user's permissions.
  4. Whether the root user has granted the user permission to change any generator's status from the default. 

    • Click Change to log in to cPanel and go to cPanel's  Choose Log Programs  interface (Home >> Logs >> Choose Log Programs).

Process Statistics for User

This section of the interface allows you to process the statistics for individual cPanel accounts. The process runs in the background and stores the results while you continue to work in WHM. When the process finishes, you can view these statistics from the user's cPanel interface.

To process the statistics for a user, select the user from the User to Process menu and click Go.

Generators Configuration

This section of the interface allows you to select which statistical analysis software is available to your cPanel users.

Select the appropriate checkboxes to configure Analog, AWStats, Logaholic, and Webalizer:

  • Select the appropriate Available to Users checkbox to make the software available to all of your cPanel users who have the ability to change their web statistics software.

    Note:

     cPanel users must also enable the program in order to view their website’s statistics.

  • Select the appropriate Active by Default checkbox to make the software the default software for all of your cPanel users.
  • Select the Allow Awstats configuration Include file checkbox to customize users' AWStats configurations. Then, add the configuration file to the ~/tmp/awstats/awstats.conf.include/ directory. For more information, read the Awstats SourceForge page.

User Permissions

This section of the interface allows you to specify which cPanel users can modify their statistics software.

Allow all users to change their web statistics generating software

To allow all of your cPanel users to modify their statistics software, select the Allow all users to change their web statistics generating software checkbox and click Save.

Choose Users

To choose specific cPanel users who can modify their statistics software, perform the following steps:

  1. Click Choose Users. A new interface will appear.
  2. Configure the Allowed Users menu.
    • To allow a user to select which software to use, select the account name from the Available Users menu and click Add, or click Add All to add all users to the Allowed Users menu.
    • To remove an account holder, select the user in the Allowed Users menu and click Remove, or click Remove All to remove all users from the allowed list.
  3. WHM automatically saves each change that you make to the Allowed Users menu. When you finish making changes, click Go Back.

Choose Specific Stats Programs

To choose specific statistics generators for a cPanel user, perform the following steps:

  1. Click Choose Users. A new interface will appear.
  2. Enter the user’s name in the Choose Specific Stats Programs for text box and click Configure.
  3. Select the checkbox next to each generator that you wish to make available to the user.
  4. Click Save.

Schedule Summary

This section of the interface displays the estimated update schedule for each statistics software.

Schedule Configuration

This section of the interface allows you to use the following settings to determine how often WHM processes the statistics on your server:

  • Log Processing Frequency — Enter the number of hours after which WHM should process log files for your server.
  • Bandwidth Processing Frequency— Enter the number of hours after which WHM should process bandwidth statistics for your server.

Notes:

  • Set these intervals in increments of 0.25 (which represents 15 minutes). For example, 4.25 specifies an interval of four hours and fifteen minutes.
  • We recommend that you do not set the Log Processing Frequency setting to a number below 24. Lower numbers may prevent the successful completion of the log processing schedule.

Configure Statistic Process Time Schedule

To define a more precise schedule, perform the following steps:

  1. Click Configure Statistic Process Time Schedule
  2. In the new interface that appears, select the hours in which your server will not perform log analysis.

    Important:

    Make certain to only process statistics at off-peak hours, when your server processes fewer requests. 

  3. To ensure that backups and log analysis do not occur simultaneously, select the Prevent cpanellogd (Log Processing) and cpbackup (Backups) from running at the same time checkbox.
  4. Click Save.

Notes:

  • If your server is very busy, your system may require more than one hour to fully analyze log files. Make sure that you leave an adequate number of hours unselected, to allow sufficient time for log analysis.
  • The times that you select only affect the statistics programs (AnalogAWStatsWebalizer and Logaholic). This schedule does not control how the cpanellogd  daemon processes bandwidth statistics internally, which is necessary for bandwidth reports in cPanel & WHM. The cpanellogd daemon may still process statistics in blackout hours, and uses minimal resources. The Bandwidth Processing Frequency setting still controls the frequency with which the cpanellogd daemon processes data.
  • The Extra CPUs for server load setting in the Stats and Logs section of WHM's Tweak Settings interface (Home >> Server Configuration >> Tweak Settings) also affects statistics processing. If statistics processing does not finish in the allotted time, you may need to increase this value.