Logs rotation

General information

By default for logs rotation, ISPmanager 6 uses the logrotate utility.

You need to activate rotation for each web-domain in its edit form. Click "Show hidden fields" for flexible configuration of logs rotation.

logrotate starts every day in /etc/cron.daily/logrotate . The configuration file is located in

/etc/logrotate.conf

Logs rotation settings for each web-domain are located in

/etc/logrotate.d/web/domain.com

By default the following logs settings are active (contents of /etc/logrotate.d/web/domain.com)

#The first line is a template of log-files. 
/var/www/httpd-logs/domain.com.access.log {
        olddir /var/www/user/data/logs #Locate archived files into specified directory
        copytruncate #Create a copy of the original log-file and then reset it. Thus the file won't be deleted. 
        compress #Archive files (gzip is used by default)
        monthly #Rotate once a day/week/month
        prerotate #Similar to postrotate, but the operations will be performed before archiving
                /etc/webanalyzer.d/user/domain.com #Analyze logs
        endscript
}
/var/www/httpd-logs/domain.com.error.log {
        olddir /var/www/user/data/logs
        copytruncate
        compress
        monthly
}

Start rotation manually

/usr/sbin/logrotate -d -f <path_to_config_of_required_web_domain>

-d — detailed information -f — rotate in any case (for example, even if logs were rotated today) Example: if you need to rotate logs only for domain.com , the command will look like /usr/sbin/logrotate -f /etc/logrotate.d/web/domain.com

Possible problems

the log does not need rotating

Cause — logs have already been rotated. You can modify status in the file

/var/lib/logrotate/status

Or delete this file, but you will have to start rotation for all logs again

/usr/sbin/logrotate -f /etc/logrotate.conf

Logs on control panels v5 are rotated by the built-in mechanism once their size reaches 100 MB

Logs analyzer

ISPmanager 6 supports:

AWStats
webalizer

To install a log analyzer, go to ISPmanager — Settings--- Software.

You need to activate analyzer for each web-domain in its edit form. Click "Show hidden fields" for flexible configuration of logs rotation.

Example: Awstats

Once logs analyzer for the web domain domain.com is activated, the configuration file with rules will be created. Normally it is located in

/etc/awstats/awstats.domain.com.conf

The followings are specified in the file

LogFile="/var/www/httpd-logs/dasha.com.access.log" #location of log for analysis
SiteDomain="dasha.com" #site for analysis
DirData="/var/www/user/data/www/dasha.com/webstat/" #location of statistics after analysis
and others.

You can view statistics per web-domain in ISPmanager — Web domains--- select a required domain — click "Statistics".

Execute the following command for collecting statistics manually

/etc/webanalyzer.d/user/domain.name

/usr/bin/perl /usr/lib/cgi-bin/awstats.pl -update -config=domain.com

When statistics collection starts

If the period is set to "during rotation", the analyzer will start by logrotate.

The directive prerotate that starts the log analyzer will be added into the configuration file /etc/logrotate.d/web/<domain.name>

/var/www/httpd-logs/domain.name.access.log { 	
olddir /var/www/username/data/logs 	
daily 	
copytruncate 	
compress 	
rotate 10 	
prerotate 		
        /etc/webanalyzer.d/username/domain.name 	
endscript 
}
/var/www/httpd-logs/domain.name.error.log { 	
olddir /var/www/username/data/logs 	
daily 	
copytruncate 	
compress 	
rotate 10
}

If the period is set to "every hour", the statistics collection script will be added into user cron

# crontab -u username -l
MAILTO=""#
#ISPmanager log rotate domain.name
0 * *	/etc/webanalyzer.d/username/domain.name

Possible issues with statistics collection

Statistics show only one unique visitor.

This may happen in case Nginx + Apache are installed. Solution — install mod_rpaf for Apache.

Statistics show zero

Make sure that the following line in the AWStats configuration file for the domain (/etc/awstats/awstats.domain.com.conf) is specified

LogFormat=1

You also make sure log format is combined in the Apache configuration file

CustomLog /var/www/httpd-logs/domain.access.log combined

How to exclude my IP address from statistics?

Edit the configuration file /etc/awstats/awstats.domain.com.conf .

SkipHosts="123.123.123.123"

See also: the official documentation Awstats

Documentation