https://github.com/mongodb-labs/edda

A log visualizer for MongoDB - This Repository is NOT a supported MongoDB product
https://github.com/mongodb-labs/edda

log-visualizer mongodb python visualization

Last synced: 14 days ago
JSON representation

A log visualizer for MongoDB - This Repository is NOT a supported MongoDB product

• Host: GitHub
• URL: https://github.com/mongodb-labs/edda
• Owner: mongodb-labs
• Created: 2012-06-08T15:52:06.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2016-10-25T14:34:32.000Z (about 8 years ago)
• Last Synced: 2024-08-01T15:10:17.140Z (3 months ago)
• Topics: log-visualizer, mongodb, python, visualization
• Language: Python
• Homepage:
• Size: 1.38 MB
• Stars: 233
• Watchers: 19
• Forks: 28
• Open Issues: 30
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes.txt

Awesome Lists containing this project

README

        
DISCLAIMER

----------

Please note: all tools/ scripts in this repo are released for use "AS IS" without any warranties of any kind, including, but not limited to their installation, use, or performance. We disclaim any and all warranties, either express or implied, including but not limited to any warranty of noninfringement, merchantability, and/ or fitness for a particular purpose. We do not warrant that the technology will meet your requirements, that the operation thereof will be uninterrupted or error-free, or that any errors will be corrected.

Any use of these scripts and tools is at your own risk. There is no guarantee that they have been through thorough testing in a comparable environment and we are not responsible for any damage or data loss incurred with their use.

You are responsible for reviewing and testing any scripts you run thoroughly before use in any non-testing environment.

Edda, a log visualizer for MongoDB

==================================

Edda © 2014 MongoDB, Inc.

Authors: Samantha Ritter, Kaushal Parikh

INSTALL

-------

You must have the following installed as prerequisites for running Edda.

+ Pip:

  http://www.pip-installer.org/en/latest/installing.html#

+ MongoDB

  see http://www.mongodb.org/downloads

+ Install Edda:

  $ pip install edda

  

NOTE: version 0.7.0 is the latest version of Edda on PyPi.  This version only supports logs from Mongod up to v2.4.  To use logs from MongoDB v2.6 and newer, please clone from the repository instead.

RUN

---

In order to run edda you must first have a mongod running:

    $ mongod

Give the log files from your servers as command-line

arguments to edda.  Please provide only log files from the same server cluster!

	$ python edda/run_edda.py --options filename1 filename2 ...

	(see python run_edda.py --help for options)

After each run, edda generates a '.json' file that contains all of the information required to recreate the current run. Run the '.json' file just as you would a '.log'. 

If you've run edda before, you can pass in a .json file to skip the processing step and go straight to visualization:

    $ python edda/run_edda.py previous_edda_data.json

There are some sample log files in edda/sample_logs you can run

if you don't have any log files of your own yet.

ADDITIONAL

----------

If you'd like to report a bug or request a new feature,

please file an issue on our github repository:

https://github.com/10gen-labs/edda/issues/new