Documentation

Welcome to Logl! We're glad you made it here. Here's what you need to do to get Logl up and running:

Installation

1. Install pip
   Pip is a tool for installing Python packages. If you don't already have pip, you can install it here:
   http://www.pip-installer.org/en/latest/installing.html#
   
   

2. Install MongoDB (which you should all do anyway because it is awesome)
   Help all of us at 10gen out by downloading MongoDB 2.1.2, our latest development release, and helping us test for 2.2!
   http://www.mongodb.org/downloads
   
   

3. Install PyMongo
   PyMongo, MongoDB's language driver for Python, is a prerequisite for running Logl. You can download and install PymMngo using pip, as described here:
   http://api.mongodb.org/python/current/installation.html
   
   

4. Install argparse
   http://pypi.python.org/pypi/argparse/
   
   

5. Install a non-text-based browser
   We recommend Google Chrome or Firefox.
   
   

6. Install Logl
   COMING SOON
   
   

Running Logl

In order to run logl, you must also have a mongod running in the background:

$ ./mongod

Logl is runnable from the command line. Once you have a mongod running, navigate to the top-level logl directory and run the following:

$ python logl/logl.py logfile1 logfile2...

Feed Logl your log files as command line arguments. If you don't have any log files to try with Logl, we've provided some samples so you don't have to miss out on the fun:

$ python logl/logl.py test/1.log test/2.log test/3.log test/4.log test/5.log

Once Logl has launched a web page, it will spawn a python server that will run until you shut it down with Ctrl+C. Be sure to kill this server once you are finished with the visualizer. Happy Logling!

Bug reports and feature requests

We'd love to hear your input! If you'd like to report a bug or request a new feature for the next version of Logl, please use github's issue tracker to file a new issue on this repository.