Getting started with the latest release

Compile

Dependences

To compile picviz, you will need:

• Compile suite (gcc, make etc..)
• flex and bison
• Cmake ( http://www.cmake.org)
• pcre library ( http://www.pcre.org/)
• cairo library ( http://cairographics.org/)

Optional:

• Python development library ( http://www.python.org)
• QT4 python bindings ( http://www.riverbankcomputing.co.uk/software/pyqt/download)

Compile and install

libpicviz

$ wget http://www.wallinfire.net/files/picviz/libpicviz-0.6.tar.gz
$ tar xvf libpicviz-0.6.tar.gz
$ cd libpicviz-0.6
$ make
$ sudo make install
$ cd src/bindings/python
$ sudo python ./setup.py install

Command line:

$ wget http://www.wallinfire.net/files/picviz/picviz-cli-0.6.tar.gz
$ tar xvf picviz-cli-0.6.tar.gz
$ cd src
$ make
$ sudo make install

Frontend:

$ wget http://www.wallinfire.net/files/picviz/picviz-gui-0.6.tar.gz
$ tar xvf picviz-gui-0.6.tar.gz
$ sudo python ./setup.py install

You can now try in picviz-cli-0.6/samples, you have some example files.

Use

You can create your graphs using the language. To learn this please refer to the Picviz language page. Those files are named with the extension 'pcv'. Samples are available in the source directory 'sample'.

However the best is to generate this language. And perl being a great language for this, one can use the tools available with the sources in the directory 'tools'. So to graph your logs easily one can do:

$ cd parsers/
$ sudo ./syslog2picviz.pl /var/log/syslog > syslog.pcv

In my case, the syslog file is pretty big:

$ wc -l syslog.pcv 
87139 syslog.pcv

Because the file is pretty big, your svg viewer may not work. So you can use the png plugin:

$ pcv -Tpngcairo syslog.pcv -o syslog.png

Which would produce the following graph:

You can also increase the image resolution to get a better image

$ pcv -Tpngcairo syslog.pcv -o syslog.png -rrr

Default values positioning is not relative. As of now, this is not the default behavior to put data in relative mode but it soon may change. To active it, simply add at the beginning of the graph:

engine {
    relative = "1";
}

This graph is the result for the same data than above but in relative mode: