summaryrefslogtreecommitdiffstats
path: root/plugins/ommongodb/README
blob: 445e525ccea507f827cf02bded9ffb960024f9ae (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
plugin to use MongoDB as backend.

tested in ubuntu 10.04 and ubuntu 10.10

BUILDING THIS PLUGIN
Right now, it seems to be necessary to copy the 10gen c-driver directly under
the ./plugins/ommongodb subdirectory. Then, you need to follow their build
instructions on how to build the mongodb c driver:
http://api.mongodb.org/c/current/building.html

This is clumpsy, and if someone has ideas on how to improve this situation,
please drop us a line. For obvious reasons, ./configure does not detect
a missing mongodb c driver.

In order to successfully build ommongodb, you NEED to use the v0.2 version of
the mongo c driver. As it looks, the driver breaks API compatibility and the
curret v0.4 driver seems to have a totally different API (at least this is
what I currently (2012-03-08) see.

configuration:

in your /etc/rsyslog.conf, together with other modules:
$ModLoad ommongodb # provides mongodb support

then in your /etc/rsyslog.d (check your distribution way to organize the configuration..) you create a file 10-mongodb.conf with the following content:

#the format for the driver is :ommongodb:ip:db:collection;StdMongoDBFmt
#if you want to change what is logged in the db, the template, you must change the source code since the keys are hardcoded
$template StdMongoDBFmt,"%msg%%syslogfacility%%HOSTNAME%%syslogpriority%"
*.*     :ommongodb:127.0.0.1,syslog,logs;StdMongoDBFmt


TODO
we must ensure that the collection is a capped collection
refactor my code :-)

email Victor Pereira <victor.pereira@bigrails.com>
twitter twitter.com/vpereira

part of this doc by Rainer Gerhards <rgerhards@adiscon.com>