From 3c886026be31a6af61a1b86773634c7bc4a44d7e Mon Sep 17 00:00:00 2001
From: Rainer Gerhards Written by
- Rainer
- Gerhards (2007-07-28) Written by
+Rainer Gerhards (2007-07-28) This document is incomplete. The module interface is
also quite incomplete and under development. Do not currently use it!
You may want to visit Rainer's blog
diff --git a/doc/omoracle.html b/doc/omoracle.html
new file mode 100644
index 00000000..40f6360f
--- /dev/null
+++ b/doc/omoracle.html
@@ -0,0 +1,78 @@
+
+ Module Name: omoracle Author: Luis Fernando Muñoz Mejías <Luis.Fernando.Munoz.Mejias@cern.ch> Available since: : 4.3.0
+ Status: : contributed module, not maitained by rsyslog core authors
+ Description: This module provides native support for logging to Oracle databases. It offers
+superior performance over the more generic omlibdbi module.
+It also includes a number of enhancements, most importantly prepared statements and
+batching, what provides a big performance improvements.
+ Note that this module is maintained by its original author. If you need assistance with it,
+it is suggested to post questions to the
+rsyslog mailing list.
+ From the header comments of this module:
+ [rsyslog.conf overview]
+[manual index] [rsyslog site] This documentation is part of the
+rsyslog
+project.About rsyslog Modules
- Oracle Database Output Module
+
+
+ This is an output module feeding directly to an Oracle
+ database. It uses Oracle Call Interface, a propietary module
+ provided by Oracle.
+
+ Selector lines to be used are of this form:
+
+ :omoracle:;TemplateName
+
+ The module gets its configuration via rsyslog $... directives,
+ namely:
+
+ $OmoracleDBUser: user name to log in on the database.
+
+ $OmoracleDBPassword: password to log in on the database.
+
+ $OmoracleDB: connection string (an Oracle easy connect or a db
+ name as specified by tnsnames.ora)
+
+ $OmoracleBatchSize: Number of elements to send to the DB on each
+ transaction.
+
+ $OmoracleStatement: Statement to be prepared and executed in
+ batches. Please note that Oracle's prepared statements have their
+ placeholders as ':identifier', and this module uses the colon to
+ guess how many placeholders there will be.
+
+ All these directives are mandatory. The dbstring can be an Oracle
+ easystring or a DB name, as present in the tnsnames.ora file.
+
+ The form of the template is just a list of strings you want
+ inserted to the DB, for instance:
+
+ $template TestStmt,"%hostname%%msg%"
+
+ Will provide the arguments to a statement like
+
+ $OmoracleStatement \
+ insert into foo(hostname,message)values(:host,:message)
+
+ Also note that identifiers to placeholders are arbitrarry. You
+ need to define the properties on the template in the correct order
+ you want them passed to the statement!
+
+
+Copyright © 2008, 2009 by Rainer Gerhards and
+Adiscon.
+Released under the GNU GPL version 3 or higher.
This documentation is part of the
rsyslog project.
-Copyright © 2008 by Rainer Gerhards and
+Copyright © 2008, 2009 by Rainer Gerhards and
Adiscon. Released under the GNU GPL
-version 2 or higher.