This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch release-2.x
in repository https://gitbox.apache.org/repos/asf/logging-log4j2.git
The following commit(s) were added to refs/heads/release-2.x by this push:
new e416542 [LOG4J2-3391] Add optional additional fields to NoSQLAppender.
e416542 is described below
commit e41654243e4d8f34c7ffd66fbf2d35fa80474d21
Author: Gary Gregory <[email protected]>
AuthorDate: Tue Feb 22 11:29:58 2022 -0500
[LOG4J2-3391] Add optional additional fields to NoSQLAppender.
Document new feature for MongoDB 3 and 4.
---
src/site/xdoc/manual/appenders.xml | 42 +++++++++++++++++++++++++++++++++++++-
1 file changed, 41 insertions(+), 1 deletion(-)
diff --git a/src/site/xdoc/manual/appenders.xml
b/src/site/xdoc/manual/appenders.xml
index 0e98d14..5f8d239 100644
--- a/src/site/xdoc/manual/appenders.xml
+++ b/src/site/xdoc/manual/appenders.xml
@@ -2472,7 +2472,6 @@ public class JpaLogEntity extends
AbstractLogEventWrapperEntity {
<p>
Here are a few sample configurations for the NoSQLAppender and
MongoDB3 provider:
</p>
-
<pre class="prettyprint linenums lang-xml"><![CDATA[<?xml
version="1.0" encoding="UTF-8"?>
<Configuration status="error">
<Appenders>
@@ -2502,6 +2501,27 @@ public class JpaLogEntity extends
AbstractLogEventWrapperEntity {
</Root>
</Loggers>
</Configuration>]]></pre>
+ <p>
+ You can define additional fields to log using
<code>KeyValuePair</code> elements, for example:
+ </p>
+ <pre class="prettyprint linenums lang-xml"><![CDATA[<?xml
version="1.0" encoding="UTF-8"?>
+<Configuration status="WARN">
+ <Appenders>
+ <NoSql name="MongoDbAppender">
+ <MongoDb3 databaseName="testDb" collectionName="testCollection"
server="localhost"
+ port="${sys:MongoDBTestPort:-27017}" />
+ <KeyValuePair key="A" value="1" />
+ <KeyValuePair key="B" value="2" />
+ <KeyValuePair key="env1" value="${env:PATH}" />
+ <KeyValuePair key="env2" value="$${env:PATH}" />
+ </NoSql>
+ </Appenders>
+ <Loggers>
+ <Root level="ALL">
+ <AppenderRef ref="MongoDbAppender" />
+ </Root>
+ </Loggers>
+</Configuration>]]></pre>
</subsection>
<a name="NoSQLAppenderMongoDB4"/>
<subsection name="NoSQLAppender for MongoDB 4">
@@ -2574,6 +2594,26 @@ public class JpaLogEntity extends
AbstractLogEventWrapperEntity {
</Root>
</Loggers>
</Configuration>]]></pre>
+ <p>
+ You can define additional fields to log using
<code>KeyValuePair</code> elements, for example:
+ </p>
+ <pre class="prettyprint linenums lang-xml"><![CDATA[<?xml
version="1.0" encoding="UTF-8"?>
+<Configuration status="WARN">
+ <Appenders>
+ <NoSql name="MongoDbAppender">
+ <MongoDb4
connection="mongodb://localhost:${sys:MongoDBTestPort:-27017}/testDb.testCollection"
/>
+ <KeyValuePair key="A" value="1" />
+ <KeyValuePair key="B" value="2" />
+ <KeyValuePair key="env1" value="${env:PATH}" />
+ <KeyValuePair key="env2" value="$${env:PATH}" />
+ </NoSql>
+ </Appenders>
+ <Loggers>
+ <Root level="ALL">
+ <AppenderRef ref="MongoDbAppender" />
+ </Root>
+ </Loggers>
+</Configuration>]]></pre>
</subsection>
<a name="NoSQLAppenderApacheCouchDB"/>
<subsection name="NoSQLAppender for Apache CouchDB">
