Note - Final Litedb 4 release has migrated to master as the last version supporting LiteDB 4.x versions. This branch has been closed. Future development will happen in a new repository for LiteDB 5.x and .net core
NLog target for the LiteDB database
Examples below for the 4 connection string types:
<targets>
<!-- Legacy Target still supported-->
<target name="legacy" xsi:type="liteDBTarget"
connectionString="filename=NLog.db"
collectionName="DefaultLog" FlushTimeout="100" BufferSize="100" SlidingTimeout="true" OverflowAction="Flush">
<property name="ThreadID" layout="${threadid}" bsonType="Int32" />
<property name="ThreadName" layout="${threadname}" />
<property name="ProcessID" layout="${processid}" bsonType="Int32" />
<property name="ProcessName" layout="${processname:fullName=true}" />
<property name="UserName" layout="${windows-identity}" />
</target>
<target name="special" xsi:type="liteDBTarget"
connectionString="special={MyDocuments}\testApp\NLog.db"
collectionName="DefaultLog" IsJournaling="false" FlushTimeout="100" BufferSize="100" SlidingTimeout="true" OverflowAction="Flush">
<property name="ThreadID" layout="${threadid}" bsonType="Int32" />
<property name="ThreadName" layout="${threadname}" />
<property name="ProcessID" layout="${processid}" bsonType="Int32" />
<property name="ProcessName" layout="${processname:fullName=true}" />
<property name="UserName" layout="${windows-identity}" />
</target>
<target name="path" xsi:type="liteDBTarget"
connectionString="path=c:\temp\testApp\NLog.db"
collectionName="DefaultLog" IsJournaling="false" FlushTimeout="100" BufferSize="100" SlidingTimeout="true" OverflowAction="Flush">
<property name="ThreadID" layout="${threadid}" bsonType="Int32" />
<property name="ThreadName" layout="${threadname}" />
<property name="ProcessID" layout="${processid}" bsonType="Int32" />
<property name="ProcessName" layout="${processname:fullName=true}" />
<property name="UserName" layout="${windows-identity}" />
</target>
<target name="file" xsi:type="liteDBTarget"
connectionString="file=NLog.db"
collectionName="DefaultLog" IsJournaling="false" FlushTimeout="100" BufferSize="100" SlidingTimeout="true" OverflowAction="Flush">
<property name="ThreadID" layout="${threadid}" bsonType="Int32" />
<property name="ThreadName" layout="${threadname}" />
<property name="ProcessID" layout="${processid}" bsonType="Int32" />
<property name="ProcessName" layout="${processname:fullName=true}" />
<property name="UserName" layout="${windows-identity}" />
</target>
</targets>
<rules>
<logger name="*" minlevel="Trace" maxlevel="Debug" writeTo="special" />
<logger name="*" minlevel="Info" maxlevel="Warn" writeTo="path" />
<logger name="*" minlevel="Error" maxlevel="Fatal" writeTo="file" />
</rules>name - Name of the target.
- flushtimeout - timeout (in milliseconds) after which the contents of the buffer will be flushed if there's no write in the specified period of time. Use -1 to disable timed flushes
- buffersize - the number of log events to be buffered ( min 1, max 100). Default is 100.
- slidingtimeout - If sliding timeout is enabled, the inactivity timer is reset after each write, if it is disabled - inactivity timer will count from the first event written to the buffer.
- overflowaction -the action to take if the buffer overflows. (default "Flush")
- Discard - replace the oldest event with new events without sending events down to the wrapped target.
- Flush - flush the entire buffer to the wrapped target.
connectionName - The name of the connection string to get from the config file.
connectionString - 3 connection string types are permitted.
- Special - this allows for the connection string to utilize special folders - Refer to Microsoft documentation on Environment.SpecialFolder Enum for a full list. They are case sensitive.
- Path - as this suggests - a file path.
- File - just a base filename.
collectionName - The name of the LiteDB collection to write logs to.
IsJournaling - Journaling is enabled by default. Specify IsJournaling="false" to disable LiteDB journaling.
includeDefaults - Specifies if the default document is created when writing to the collection. Defaults to true.
field - Specifies a root level document field. There can be multiple fields specified.
property - Specifies a dictionary property on the Properties field. There can be multiple properties specified.
<target name="liteDB" xsi:type="liteDBTarget"
connectionString="file=NLog.db"
collectionName="DefaultLog" FlushTimeout="100" BufferSize="100" SlidingTimeout="true" OverflowAction="Flush">
<property name="ThreadID" layout="${threadid}" bsonType="Int32" />
<property name="ThreadName" layout="${threadname}" />
<property name="ProcessID" layout="${processid}" bsonType="Int32" />
<property name="ProcessName" layout="${processname:fullName=true}" />
<property name="UserName" layout="${windows-identity}" />
</target> <target name="liteDB" xsi:type="liteDBTarget"
connectionString="file=NLog.db"
collectionName="DefaultLog" IsJournaling="false" FlushTimeout="100" BufferSize="100" SlidingTimeout="true" OverflowAction="Flush">
<property name="ThreadID" layout="${threadid}" bsonType="Int32" />
<property name="ThreadName" layout="${threadname}" />
<property name="ProcessID" layout="${processid}" bsonType="Int32" />
<property name="ProcessName" layout="${processname:fullName=true}" />
<property name="UserName" layout="${windows-identity}" />
</target>or
<target name="legacy" xsi:type="liteDBTarget"
connectionString="filename=NLog.db;journal=false"
collectionName="DefaultLog" FlushTimeout="100" BufferSize="100" SlidingTimeout="true" OverflowAction="Flush">
<property name="ThreadID" layout="${threadid}" bsonType="Int32" />
<property name="ThreadName" layout="${threadname}" />
<property name="ProcessID" layout="${processid}" bsonType="Int32" />
<property name="ProcessName" layout="${processname:fullName=true}" />
<property name="UserName" layout="${windows-identity}" />
</target>{
"_id":{"$oid":"58aa0e644a8392ac98bb4812"},
"Date":{"$date":"2017-02-19T21:30:12.4760000Z"},
"Level":"Error",
"Logger":"NLog.Targets.LiteDB.Specs.IntegrationTests.IntegrationTests",
"Message":"Test Log Message",
"Exception":
{
"Message":"Test Exception",
"BaseMessage":"Inner Exception",
"Text":"System.Exception: Test Exception ---> System.Exception: Inner Exception\r\n --- End of inner exception stack trace ---",
"Type":"System.Exception",
"Source":null
},
"Properties":
{
"ThreadID":"10",
"ProcessID":"44184",
"ProcessName":"-Information about process here ",
"UserName":"MachineName\\user"
}
}
}