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