/logtastic

A web application for storing, searching, and viewing log events

Primary LanguageJavaScript

Logtastic

Description

Brings together CouchDB with the Log4(X) style logging frameworks. The goal is to collect log messages from most any application and display those messages in a convenient web interface. Some nice plots and summary data is provided.

Features

There are two components included with the Logtastic package. The first is a language specific appender that formats and posts log events to a CouchDB instance. The second is a couchapp for viewing log messages stored in the CouchDB instance. A couchapp is a web application that is stored in and served from a CouchDB instance. These two components work together to allow you to collect log messages and view them in a single location.

Log event appenders are provided for the following programming languages:

  • Ruby via the Logging framework
  • Java via the Log4r framework

Contributions for other languages are welcome.

Installation

First, you will need to install CouchDB and get it running.

Next, you will need to install couchapp. This is a collection of Python scripts that simplify the process of developing and deploying a couchapp to a CouchDB instance. This tool will be used to deploy the Logtastic couchapp to your CouchDB instance.

Finally, you will need to install the appender for your chosen language. Each appender provides documentation on how to configure and use the appender in your own software.

It is highly recommended that you deploy the Logtastic couchapp before attempting to use any appender to log to your CouchDB instance.

License

Copyright © 2009

This software is free for personal and educational use. The source code may be freely distributed provided this copyright notice is included in all copies of the software.

This software requires a licensing fee and licensing agreement for use in government or commercial applications. This right to license the software is reserved solely for the original author, Timothy W Pease.

THE SOFTWARE IS PROVIDED ‘AS IS’, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.