Truedoc

[[TracNav(TOC)]]

== Configurare AWStats ==

Uno dei programmi più interessanti per la gestione delle statistiche dei siti

web è [http://awstats.sourceforge.net/ AWStats], che su una Debian può essere

installato semplicemente con:

{{{

apt-get install awstats

}}}

Una volta installato la configurazione deve essere effettuata con i file

presenti in {{{/etc/awstats}}}. Il pacchetto Debian installa già un suo

{{{awstats.conf}}} che viene utilizzato di default, ed è sufficiente qualora

si abbia un singolo sito da tenere sotto controllo. 

Se però si hanno vari ''virtual host'' es si gestiscono più siti per ciascuna

macchine si deve usare un file di configurazione per ogni sito che si vuole

tenere sotto osservazione. Per gestire questa configurazione il pacchetto

Debian fornisce alcuni script di ausilio, ma questi richiedono che detti file

abbiano un nome nella forma ''awstats.www.dominio.it.conf'' (ad esempio

{{{awstats.www.fountainpen.it.conf}}}).

All'interno di ciascuno di questi file occorrerà specificare dove si trovano

le statistiche e per quale sito esse sono raccolte, per quanto riguarda le

statistiche occorre specificare in quale file sono mantenuti log di accesso ad

Apache per il sito voluto con la direttiva {{{LogFile}}}, con qualcosa del

tipo: 

{{{ 

LogFile="/var/log/apache2/fountainpen.it-access.log" 

}}}

dove il file dei log deve essere stato opportunamente generato in maniera

separata per il sito in questione, ad esempio inserendo la riga seguente

nella definizione del relativo virtual host di Apache:

{{{

CustomLog /var/log/apache2/fountainpen.it-access.log combined

}}}

La seconda direttiva è da utilizzare è {{{SiteDomain}}} che indica il nome di

dominio per il sito 

Si tenga conto che il programma è pensato per aggiornare le statistiche in

maniera incrementale, esso cioè legge dal file di log solo le voci relativi ad

accessi più recenti rispetto agli ultimi che ha classificato. Questo significa

che il programma deve essere fatto eseguire periodicamente tramite ''cron'',

in modo da aggiornare le statistiche.