Documentation

Welcome to Edda! We're glad you made it here. Here's what you need to do to get Edda 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 the first release candidate for MongoDB 2.2.0, and helping us test for 2.2!
   http://www.mongodb.org/downloads
   
   

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

4. Install Edda
   $ pip install edda
   
   

Running Edda

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

$ ./mongod

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

FROM GITHUB:
$ PYTHONPATH=. python edda/run_edda.py logfile1 logfile2...
FROM PIP INSTALL:
$ edda logfile1 logfile2...

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

$ python edda/edda.py test/sample_logs/hp/* or
$ python edda/edda.py test/sample_logs/pr/*

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 viewing!

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 Edda, please use github's issue tracker to file a new issue on this repository.