¿Que es AWStats?

AWStats es una herramienta que genera estadísticas gráficas para servidores web. Lo que hace es
mostrar el contenido del archivo de log del servidor web de forma gráfica.

Entre las cosas que muestra están el número de visitas, navegadores usados, sistemas operativos ...

Para poder usarlo es necesario tener acceso de lectura al fichero de log del servidor y poder ejecutar
scripts hechos en Perl desde la línea de comandos o bien como CGI en un servidor web como
Apache.

Pre - requisitos
− Un servidor web para publicar las estadísticas.
− Poder correr scripts de Perl, por línea de comandos y/o como CGI en un servidor web.

1. Instalación de Perl en Apache2 para Windows.

Se asume la instalación de Apache en la ruta E:\Apache

1. Bajar el archivo ActivePerl-5.12.2.1202-MSWin32-x86-293621.zip (última versión al

momento de elaborar esta guía) de su página de descargas
http://www.activestate.com/activeperl/downloads .

2. Al descomprimir se podrá ver un par de carpetas y algunos archivos. Seleccionar la

carpeta perl y copiarla a la unidad E: cambiando su nombre a usr , quedando entonces como
E:\usr

Copiar / renombrar
2. Instalación de AWStats.

− Bien, lo primero será descargar el Zip de la web de AWStats. Recomiendo el Zip ya que así
tendremos libre movilidad con los archivos. Al momento de elaborar esta referencia, se
descargo el archivo awstats-6.95.zip.
− Descomprimir awstats-6.95.zip en la unidad C: (se creara la carpeta c:\awstats-6.95)

− Entrar a la carpeta “C:\awstats-6.95\ wwwroot” y de ella, copiar las carpetas css, js, icon y
classes a carpeta “E:\bvs\htdocs\”. Se asume BVS instalado en E:

− Copiar la carpeta “cgi-bin” que está dentro de “c:\awstats-6.95\wwwroot”, cambiando su

nombre a “awstats” dentro de la carpeta “E:\bvs\cgi-bin”.

− Entraremos a la carpeta E:/bvs/cgi-bin/awstats ,

− El archivo llamado “awstats.model.conf“, lo renombraremos a “awstats.site.conf” y
procederemos a abrirlo para editarlo en los siguientes puntos:
1. Buscaremos el parámetro “LogFile=” y lo cambiaremos por nuestra dirección completa
del log de Apache, que con Xampp encontraremos en E:/apache/logs/access.log. Por lo
tanto editaremos la línea y la dejaremos así:
LogFile=”E:/apache/logs/access.log”
2. Buscaremos el parámetro “LogFormat=” y se establecerá de acuerdo a la configuración
del formato de archivo log que guarde Apache. Se asumirá que se configuro con el formato
combined. Por lo que se pondrá :
LogFormat=1.
3. Buscaremos el parámetro “SiteDomain=” y entre comillas pondremos el nombre del
dominio del sitio al que se le hace las estadísticas
p.e. SiteDomain=”www.bvs.ins.gob.pe”
4. Busca parámetro “DirData=” . Este parámetro indica donde se guardan los archivos de
datos procesados por el awstats, que le sirven para mostrar las estadísticas. Establecer
como:
DirData=”site”
Y en el directorio “E:\bvs\cgi-bin\awstats” crear la carpeta “site”

5. Buscar parámetro “DirCgi=” y establecer su valor a la ruta relativa del cgi-bin movido y
renombrado, quedando:
DirCgi=”/cgi-bin/awstats”

3. Procesamiento de Logs – Construcción/actualización base de datos de las

estadísticas

Hasta el momento, ya tenemos configurado el awtats junto con el xampp. Hay que construir los
archivos de datos mediante el procesamiento de los logs del servidor.

Abrir una consola (Inicio -> Ejecutar -> cmd) y teclearemos lo siguiente, siguiendo el ejemplo del
tutorial:
E:
cd bvs\cgi-bin\awstats
E:\usr\bin\perl.exe awstats.pl -config=site -update”

Si todo va bien veremos algo como:

Create/Update database for config “E:/bvs/cgi-bin/awstats/awstats.conf” by AWStats version 6.8

(build 1.910)
From data in log file “E:/apache/logs/access.log”…
Phase 1 : First bypass old records, searching new record…
Direct access after last parsed record (after line 1051789)
Jumped lines in file: 1051789
Found 1051789 already parsed records.
Parsed lines in file: 815
Found 0 dropped records,
Found 0 corrupted records,
Found 0 old records,
Found 815 new qualified records.

Esto construirá los archivos de datos para mostrar las estadísticas. Para acceder a ellas tan solo
deberéis teclear en vuestro navegador:
“http://vuestrodominio.com/cgi-bin/awstats/awstats.pl?config=site”
cambiando “vuestrodominio.com” por la dirección de vuestra página web.
Las estadísticas mostradas, estarán actualizadas hasta la fecha en que se lanzo el comando anterior.
Para que las estadísticas se actualicen, crear una tarea programada que invoque a un archivo .bat

El archivo puede llamarse p.e. estadisticas.bat , colocarse en la carpeta E:\bvs\cgi-bin\awstats\ y

su contenido puede ser:

E:\usr\bin\perl.exe awstats.pl -config=site –update

La tarea se puede programar para ejecutarse 1 vez al día, en horas de menos visitas.
 Apendice A

Plugin GEO-IP

Este plugin muestra estadísticas de visitantes, por Países, usando una base de datos de IPs por
países.

La base de datos, se obtiene de Maxmind, que ofrece una versión comercial con frecuentes
actualizaciones y una libre (GeoLite country) con una menor frecuencia de actualizaciones.

Se puede descargar su formato binario de http://www.maxmind.com/app/geolitecountry ,

GeoIP.dat.gz. Descomprimir y copiar en E:\bvs\cgi-bin\awstats\plugins

En el archivo de configuración awstats.site.conf, hay que cargar el plugin, descontentando el

parámetro LoadPlugin=”geoip GEOIP_STANDARD /pathto/GeoIP.dat” y dándole el valor que
se ve en la figura:
Luego hay que instalar también un modulo de Perl para usar este plugin. Usaremos el manejador de
paquetes de Perl, que se encuentra en la carpeta d:\xampp\perl\bin\ , invocándolo mediante el
archivo ppm.bat

El manejador de paquetes, nos permitirá instalar/desinstalar paquetes de Perl.

Primero entrar a la opción de menú Edit -> preferencias y escoger el área usr que tiene como prefix
E:/usr/site/lib , como se ve en la imagen.
En la casilla de búsqueda, poner geo-ip y se mostraran paquetes que concuerdan con este criterio.

Escoger Geo-IP-PurePerl , dar al botón de agregar paquete, y luego al de proceder.

Eso es todo, la siguiente vez que se actualicen las estadísticas, se verá la información de los países.

Notas.
1. Revisar periódicamente la pagina de Maxmind para una nueva versión de su base GeoIP.dat
2. Si hubiera un error por alguna instalación previa del ActivePerl, borrar la carpeta
%userprofile%\Configuración local\Datos de programa\ActiveState
Y volver a lanzar el ppm.bat