¿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\awstatsE:\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: 1051789Found 1051789 already parsed records.Parsed lines in file: 815Found 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.dat2. Si hubiera un error por alguna instalación previa del ActivePerl, borrar la carpeta

%userprofile%\Configuración local\Datos de programa\ActiveStateY volver a lanzar el ppm.bat