Tutorials

  • Presto on-line...

About ...

  • ... questo sito
  • ... me


AWStats: Advanced Web Statistics

awstats
Si tratta di uno strumento, potentissimo e facile da configurare, per la generazione delle statistiche dei server web (ma anche dei server ftp e mail). Può lavorare come CGI o a linea di comando e produce delle analisi ricche di informazioni ed affidabili. Inoltre è scritto in Perl così che per utilizzarlo non dobbiamo nemmeno compilare dei sorgenti: basta configurarlo e lui semplicemente... FUNZIONA! Ed è anche veloce!!!

Come ottenere un file di LOG completo:

Sotto MacOS X, Apache è configurato per generare log di tipo "common"!
E’ un log di base, a cui mancano un sacco di informazioni utili. Il nostro obiettivo è quello di ottenere un log completo, vale a dire di tipo "combined".

•Sotto MacOS X:
Occorre editare il file /etc/httpd/httpd.conf con i privilegi di root.
Di default troveremo una riga come questa (a circa metà del documento):
   CustomLog "/private/var/log/httpd/access_log" common
Dovremo sostituire common con combined.

• Sotto MacOS X Server:
In questo caso dovremo editare il file httpd_macosxserver.conf. Occorre fare molta attenzione perchè questo file viene gestito direttamente dal programma "Server Settings".
Apriamo il "Server Settings" e configuriamo il nostro dominio per NON generare il logFile!!!
Ogni dominio configurato con "Server Settings" comincia con la riga "#<RAdmin xxx>" ed è identificabile dalla riga (poco sotto la precedente) ServerName nome_del_dominio.
Una volta identificato il blocco che ci interessa, dovremo cercare la riga:
    CustomLog "/dev/null" "%h %l %u %t \"%r\" %>s %b"
Questa riga dovrà rimanere tale e quale ma subito dopo dobbiamo inserirne una molto simile, tipo:
   CustomLog "/var/log/httpd/access_log.macosx.log" combined
Questa doppia definizione serve per aggirare una impossibilità di gestire il log "combined" tramite il tool "Server Settings".
Attenzione a dichiarare un path corretto.... è quello che useremo successivamente nella configurazione di awstats.

Installiamo awstats:

Scarichiamo una copia recente di awstats dal sito di sourceforge:
http://sourceforge.net/project/showfiles.php?group_id=13764
Meglio una copia nella versione .tzg ... e scompattiamola.
Supponendo di aver scaricato sul desktop il file awstats-5.5.tgz:

# cd ~/Desktop
# tar -zxf awstats-5.5.tgz

Creiamo anche una nuova directory che useremo per installare una versione ad hoc di awstats:
# mkdir /awstats

Torniamo nel Finder e guardiamo dentro alla cartella appena scompattata. Ci ritroviamo con una struttura di questo tipo (3 cartelle ed un readme):
  •  docs/
  •  README.txt
  •  tools/
  •  wwwroot/

A parte la documentazione, tutto quello che ci serve per partire lo troviamo dentro alla cartella wwwroot:
  •  cgi-bin/
  •  icon/

Non è mia intenzione utilizzare awstats come CGI perchè non trovo logico (a meno di particolari esigenze!) che si possa chiedere al server di aggiornare le statistiche ogni 30 secondi. I miei server devono dedicare il loro processore a servire le pagine web e non ad aggiornare le statistiche in ogni momento! Per questo motivo configurerò il sistema affinchè le statistiche vengano aggiornate una volta al giorno… di notte, magari verso le 4:00 AM, ora di minor utilizzo del server italiani ;-)
In ogni caso, per poter utilizzare awstats come CGI c’e’ poco da cambiare!
Torniamo alle due ultime cartelle:
1- La cartella icon contiene (!) le icone utilizzate nelle pagine delle statistiche (icone delle bandiere, icone dei S.O., icone dei browser...). Dovremo spostarla all’interno di una cartella visibile dal server web delle statistiche. Ne riparleremo più avanti.

2- La cartella cgi-bin contiene tutto ciò che serve per processare le nostre statistiche.

Supponendo di voler gestire le statistiche di più domini, l’idea è quella di creare altre due cartelle all’interno della cartella awstats precedentemente creata:

  • /awstats/stats/
  • /awstats/tools/

In stats creeremo una cartella per ogni dominio mentre in tools metteremo tutti gli script che ci servono, a cominciare da quelli presenti nella cartella cgi-bin. Ci servirà anche un file da usare come template: awstats-5.5/tools/awstats_buildstaticpages.pl.

# mkdir /awstats/stats
# mkdir /awstats/tools
# cd ~/Desktop/awstats-5.5/wwwroot/cgi-bin
# cp -R . /awstats/tools/
# cd ../../tools
# cp awstats_buildstaticpages.pl /awstats/tools/

Una configurazione di esempio:
Sistemata la cartella /awstats, configuriamo il programma.
Definiamo la situazione di partenza:
- Dobbiamo gestire le statistiche di www.macosx.it
--- La directory del sito HTTP è: /Library/WebServer/virtual/macosx
- Le statistiche saranno visibili all’indirizzo stat.macosx.it
--- La directory del sito delle statistiche è: /Library/WebServer/virtual/macosx_stat

Creiamo la directory macosx all’interno di /awstats/stats/.
Conterrà tutti i file storici e di servizio per la generazione quotidiana delle statistiche.

# mkdir /awstats/stats/macosx

Il file principale utilizzato per la generazione delle statistiche è awstats.pl mentre awstats.model.conf è un file di esempio per la configurazione di un dominio. Bisogna duplicarlo e modificarlo per ogni sito:

# cd /awstats/tools
# cp awstats.model.conf awstats.macosx.conf

Il file awstats.macosx.conf lo possiamo aprire ed editare con qualsiasi strumento: pico, vi, BBedit… quello che ci viene più comodo.
Noteremo che è riccamente documentato. Di seguito elencherò quelle che sono le righe più significative da modificare o da prestare attenzione:

• LogFile="/var/log/apache/access.log"
Dobbiamo modificare il percorso che punta al file da analizzare… dipende dalla configurazione apache. Nel nostro esempio (supponendo di usare MacOS X Server) scriveremo:
   LogFile = "/var/log/httpd/access_log.macosx.log"

• LogFormat=1
Utilizzando apache, dobbiamo lasciare 1 se si tratta di un log di tipo "combined" (è il tipo esteso… altamente consigliato). Oppure dobbiamo mettere 4 se si tratta di un log di tipo "common"… dipende dalla configurazione di apache.

• SiteDomain=""
Nell’esempio che stiamo esaminando, metteremo ="www.macosx.it"

• HostAliases="www.myserver.com x.y.z.w localhost 127.0.0.1"
Lasciare la parte finale "localhost 127.0.0.1" ed aggiungere eventuali alias di www.macosx.it.

• DNSLookup=2
Io preferisco mettere = 1 per abilitare completamente il DNS Lookup (la risoluzione degli indirizzi IP).

• DirData="."
Parametro molto importante! Dovremo mettere ="/awstats/stats/macosx/".
Indica la directory dove awstats scriverà tutti
i suoi files per la gestione delle statistiche del sito.

• DirIcons="/icon"

Altro parametro importante. Dovremo copiare la famosa cartella icon all’interno
della directory pubblica che conterrà le statistiche. A questo punto,
siccome il parametro DirIcons indica il path delle immagini dall’interno
delle pagine delle statistiche, "/icons" andrà benissimo.

• PurgeLogFile=0
• ArchiveLogRecords=0
Questi due parametri preferisco settarli entrambi a 1.
Siccome configurerò il sistema per effettuare un aggiornamento delle statistiche ogni giorno, con questi parametri settati a 1 il log di apache viene svuotato e una copia viene automaticamente sistemata all’interno della nostra directory /awstats/stats/macosx/

• DefaultFile="index.html"
Eventualmente dovremo aggiungere (separati da spazio) file tipo: index.php o index.html

OK! Questi sono i parametri fondamentali.... il resto serve principalmente per dichiarare quali statistiche vogliamo elaborare.

Per nostra comodità, ci rimane da configurare uno script che si occuperà di generare le pagine statiche delle nostre statistiche. Quindi facciamo una copia di awstats_buildstaticpages.pl, chiamiamolo buildstaticpages_macosx.pl ed editiamolo:

# cd /awstats/tools
# cp awstats_buildstaticpages.pl buildstaticpages_macosx.pl

Editiamo il file buildstaticpages_macosx.pl con il solito editor, in 3 singole righe:










prima
dopo
my $Config;
my $Awstats=’awstats.pl’;
my $OutputDir=’’;
my $Config=’macosx’;
my $Awstats=’/awstats/tools/awstats.pl’;
my $OutputDir=’/Library/WebServer/virtual/macosx_stat’;

Pronti? Via!

Non ci resta che provare.

• Primo Step.
Elaboriamo il file delle statistiche:

# /awstats/tools/awstats.pl -config=macosx -update

• Secondo Step.
Generiamo le pagine statiche:

# /awstats/tools/buildstaticpages_macosx.pl

• Terzo Step.
... non c’e’ un terzo step!

Per approfondimenti:


Posted on Jun 27, 2003 - 04:55 AM


Ricerca:


Adv:

ApplePro :
Vuoi acquistare un prodotto dalla Apple? Sei un utente Pro (cioè hai la partita IVA)? Se vuoi supportare il nostro sito, passa da qui: apple pro.