Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
log4j appender to MongoDB database
Java Ruby
Tag: 0.4.0

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
src
.gitignore
LICENSE.txt
MAINTAINERS
README.txt
buildfile
log4j.properties.sample
pom.xml

README.txt

Description
-----------
This library provides Log4J Appenders [1] that write log events to the
MongoDB document oriented database [2].

MongoDbAppender - Stores a BSONified version of the Log4J LoggingEvent
MongoDbPatternLayoutAppender - Uses standard Log4J pattern layout, parser
    and converter classes to store a log message as a custom-formatted document

More details at http://log4mongo.org/display/PUB/Log4mongo+for+Java

Author
------
Peter Monks (pmonks@gmail.com)

Contributors
------
Jozef Sevcik (sevcik@styxys.com)
Robert Stewart (robert@wombatnation.com)
Zach Bailey


Pre-requisites
--------------
JDK 1.6+
MongoDB Server v1.+ (tested with 1.2.1, 1.6.x) (required for unit tests)
MongoDB Java Driver v1.0+ (tested with 2.1)
Log4J 1.2+ (tested with 1.2.16 - note: won't work on earlier versions due to
            log4j API changes)

Log4mongo-java 0.4.0+ should work with any version of the MongoDB Java driver. However,
version 0.3.2 of log4mongo-java will work with MongoDB Java driver versions only up
to 2.0. The 2.1 driver includes a source compatible, but binary incompatible, change to
a DBCollection.insert() method used by log4mongo-java.

Installation / Configuration
----------------------------
1. Start a local MongoDB server running on the default port - this is required
   for the unit tests:
       mongod -dbpath ./mongodata

2. Build the JAR file using Maven2
       mvn clean package

3. Deploy the target/log4mongo-java-x.y.jar file, along with the Log4J and MongoDB
   Java Driver JARs, into the classpath of your Java application

4. Configure log4j as usual, referring to the log4j.properties.sample file for
   the specific configuration properties the appender supports


Todos
-----
* Add unit tests
  * connection failures
  
* Clean up BSONification code - currently it's functional but skanky.
  Consider using daybreak for this [4].

  
Notes on Date handling
-----
MongoDB (actually BSON) supports datetimes as a native data type [5] 
and all drivers are supposed to handle conversion from client-native 
date type (java.util.Date in Java) to BSON representation of date in miliseconds
since the Unix epoch. 
However, MongoDB built-in console (bin/mongo) does represent dates formatted,
even the dates were saved in native data type, which may be confusing [6].
See testTimestampStoredNatively in tests (TestMongoDbAppender.java) if you want to get an idea.

References
----------
[1] http://logging.apache.org/log4j/1.2/index.html
[2] http://www.mongodb.org/
[3] http://github.com/mongodb/mongo-java-driver/downloads
[4] http://github.com/maxaf/daybreak
[5] http://bsonspec.org/#/specification
[6] http://groups.google.com/group/mongodb-user/browse_thread/thread/e59cbc8c9ba30411/af061b4bdbce5287
Something went wrong with that request. Please try again.