Author

Kozea

Date

2012-01-27

Pystil is an elegant site web traffic analyzer written in python and coffeescript

At the time, you can only download Pystil via git. To do so, you should first install git and then:

git clone https://github.com/Kozea/pystil.git

The server side of Pystil is written in Python. It needs some libraries :

• flask (>=0.8)
• flask-sqlalchemy
• CSStyle
• pika
• gevent
• pygeoip
• log_colorizer
• psycopg2

It also need a working PostgreSQL server (with hstore extension) and a RabbitMQ server.

You should install the different libraries with easy_install. As root, type:

easy_install flask flask-sqlalchemy pika gevent pygeoip CSStyle psycopg2

To install log_colorizer, as root, from the pystil dir, do:

pip install -r requirements.txt

You should install postgresql version 9.1 and its hstore extension.

In Ubuntu 11.10, type:

sudo apt-get install postgresql postgresql-contrib

Just install RabbitMQ server.

In Ubuntu 11.10, type:

sudo apt-get install rabbitmq-server

First of all, you should log in postgresql with a super user. Then, import file sql/pystil.sql:

\i sql/pystil.sql

By default, it create a pystil user whose password is "pystil". If you want to change it to "your_new_password", just enter:

ALTER ROLE pystil PASSWORD 'your_new_password';

Copy the file .pystil-secrets (present in the pystil directory from git) to your home, and edit it:

cp .pystil-secrets ~
edit ~/.pystil-secrets 

You must now generate a secret key and enter it in the file. You should also enter your PostgreSQL password that you entered in the create role statement (if you just followed this lines, it should be "pystil").

If you want to use LDAP as an authentication backend, you should also fill the fields "LDAP_HOST" and "LDAP_PATH".

Pystil contains two main applications : - the web application that provides the data viewer, the admin interface and the files to include in the webapp you want to analyze. - a data feeder that reads "visits" message and store it in the db.

From the pystil directory, simply launch:

./bin/webapp.py

From the pystil directory, simply launch:

./bin/datafeed.py