MZStats - Generate your web statistics!

http://www.emezeta.com

�Que es MZStats?

MZStats es un sencillo script desarrollado en perl que analiza ficheros logs de servidor web (compatible con Apache) encarg�ndose de examinarlos y convertirlos en una p�gina web con informaci�n detallada y ordenada acerca de los visitantes de dicho sitio web.

Fichero log: Un fichero log es un documento de texto donde se registran todas las acciones sobre lo que se habla. Por ejemplo, un fichero log de una conversaci�n ser�a el registro de todo lo que se ha hablado, un fichero log de un programa ser�a todas las acciones que se han hecho con ese programa, etc...

Subir

�Porque MZStats?

�Y porque no? Emezeta (MZ) es mi nombre-seud�nimo en Internet, y me pareci� adecuado usarlo junto a Stats (estad�sticas) en ingl�s. As� de simple.

Subir

�Puedo usar MZStats en mi web?

Por supuesto. Para eso he desarrollado este software y lo he publicado en SourceForge.NET. MZStats esta publicado bajo la licencia GPL, por lo cual est� considerado Software Libre. Pero �ojo! hay unos puntos que debes tener en cuenta si quieres usarlo:

Subir

�Cada cuanto actualizas MZStats?

MZStats, por el momento, lo desarrollo y he desarrollado yo solo. Por lo tanto no dispongo de demasiado tiempo para mejorarlo, pero intento dedicarle el mayor tiempo para hacerlo lo m�s completo posible. Su base de datos a�n es muy peque�a e incompleta, pero poco a poco se ir� completando. Si deseas contribuir con el proyecto, no tienes m�s que enviar un e-mail al autor a la direcci�n romansoftware arrobita yahoo puntito es.

Subir

Caracter�sticas de MZStats

MZStats posee actualmente (y posiblemente se amplie en versiones posteriores) las siguientes �features�:

Subir

Ejemplo de MZStats

�Te gustar�a ver alguna p�gina de ejemplo para ver como se ve el sistema de estad�sticas de MZStats? No hay ning�n problema. Aqu� tienes una estad�stica de mi blog personal Emezeta.

Subir

Requisitos para MZStats

Para poder usar MZStats es necesario una serie de requisitos que detallo a continuaci�n:

Subir

Descarga de MZStats

Para proceder a la descarga de MZStats pulsa aqu�.

Instalaci�n de MZStats

Para la instalaci�n de MZStats es conveniente seguir los pasos descritos a continuaci�n:

  1. Descargar y descomprimir el paquete MZStats:
    tar -xzvf mzstats-X.X.tar.gz
  2. Colocar la carpeta en nuestra ruta del webserver, asumiendo que sea /var/www/html:
    mv mzstats-X.X/ /var/www/html/stats/
Subir

Configuraci�n de MZStats

Pasos para la correcta configuraci�n de MZStats:

  1. Asegurarse de todos los requisitos necesarios para la correcta ejecuci�n de MZStats.

  2. En la configuraci�n del servidor web deberemos asegurarnos de que tenemos la sintaxis de los logs de esta manera:
    LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined (Usualmente viene as� por defecto)

  3. Asegurarse de que est� activada la resoluci�n de nombres de dominio en el apache:
    HostnameLookups On (En caso contrario no funcionar�an la lista de ISP y paises de las estad�sticas)

  4. Editar el fichero de configuraci�n del cron (usualmente /etc/crontab) y especificarle la ejecuci�n cada cierto tiempo, por ejemplo:
    00,10,20,30,40,50 * * * * root run-parts /etc/cron.diezmin
    A�adiendo esta l�nea en el crontab, obligamos al cron a ejecutar los scripts que tenga dentro de la carpeta /etc/cron.diezmin cada diez minutos. M�s informaci�n sobre configuraci�n del cron aqu�. Solo queda a�adir un script ( vim /etc/cron.diezmin/stats.pl ) en esa carpeta que ejecute el analizador de MZStats, que puede ser asi de sencillo:

    #!/usr/bin/perl

    `/var/www/html/stats/analizador.cgi`;
  5. �Se cuidadoso con los permisos! El analizador no debe tener permiso de ejecuci�n para todos los usuarios. A continuaci�n una lista de los permisos recomendados para los ficheros de MZStats:

    -rwxrwxr-- analizador.cgi (chmod 774)
    drwxrwxr-x bdd/ (chmod 775)
    -rw-r--r-- estilos.css (chmod 644)
    -rw-r--r-- favicon.ico (chmod 644)
    drwxrwxr-x img/ (chmod 775)
    drwxrwxr-x skin/ (chmod 775)
    drwxrwxr-x tmp/ (chmod 775)
    -rw-r--r-- (contenido de las carpetas) (chmod 644)
  6. El siguiente paso es editar el fichero analizador.cgi para configurar las variables, y aunque esta bien documentado, lo mejor es explicarlas un poco:

    • $titulo: El t�tulo de la web, por ejemplo "miweb.com".
    • $dominio: El dominio de nuestra web, bajo una expresi�n regular, ej: "miweb\.com".
    • $limite_*: Variables para personalizar el limite de entradas en cada secci�n.
    • $leyenda_pixel: Cuantas visitas significa un pixel en las barras de visitas.
    • $red_local: Si se trata de un servidor propio, indicar aqui la red local que se est� usando sin el �ltimo d�gito. Si no sabemos de lo que se est� hablando o no es un servidor propio dejarlo como est�.
    • $_ap/_busc/_nop: Imagenes, Patrones de buscadores y Dominios a excluir de la tabla de los referes (No tocar si no se entiende).
    • $_sp/_np: Patrones a buscar y a ignorar de la tabla de buscadores (No tocar si no se entiende).
    • Directorios: Establecer la ruta absoluta de cada directorio. Por defecto /usr/www/html/stats.
Subir

FAQ (Frecuently Answers & Question)

Las preguntas y respuestas m�s frecuentes ser�n a�adidas proximamente.

Subir

Foro de MZStats

El foro de MZStats pertenece al foro de Emezeta.COM. En el puedes comentar los problemas que puedas tener con la instalaci�n, configuraci�n o puesta a punto del programa, as� como las posibles caracter�sticas que te gustar�a que tuviese la pr�xima revisi�n, sugerencias o comentarios, etc...

Pulsa aqu� para acceder al foro de MZStats.

Subir

�MZStats es una beta!

MZStats a�n no se puede considerar una versi�n final, ya que el c�digo est� adaptado por encima, para proveer una versi�n para el usuario final, ya que MZStats fue dise�ado en un principio s�lo para uso personal. Dicho esto, me encantar�a que si algun usuario descubre alg�n problema de seguridad, bug, o cualquier otra cosa, que lo notificara al autor para corregirlo en una versi�n posterior.

Subir

A�n por hacer...

A MZStats a�n le queda un largo camino. Entre las cientos de cosas que necesita est�n las siguientes:

Subir

Contacto / El autor

MZStats ha sido desarrollado en Perl por Manz en su totalidad. Para contactar con el autor puedes hacerlo al email romansoftware arrobita yahoo puntito es o accediendo a su p�gina-blog personal: Emezeta. �Un saludo!

Subir