April 2010 - logback-dev - mailman3.qos.ch

having trouble with logs and rolling over
by Jason Roscoe 09 Apr '10

09 Apr '10

I have the below configuration where I want to have a log file roll over either at midnight or when the log gets to 100MB. We are using logback version 0.9.15 at the moment. Using the below, I'm actually not getting any logging. Could someone help me with this? <?xml version="1.0" encoding="UTF-8"?> <configuration> <appender class="ch.qos.logback.core.rolling.RollingFileAppender" name="RootFileAppender"> <file>/apps/projects/liferay/logs/my-subscriptions.log</file> <append>true</append> <filter class="ch.qos.logback.classic.filter.ThresholdFilter"> <level>debug</level> </filter> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">  <fileNamePattern>/apps/projects/liferay/logs/my-subscriptions.%d{yyyy-MM-dd}.%i.log</fileNamePattern> <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">  <maxFileSize>100MB</maxFileSize> </timeBasedFileNamingAndTriggeringPolicy> <maxHistory>30</maxHistory> </rollingPolicy> <layout class="ch.qos.logback.classic.PatternLayout"> <Pattern>%date %p [%c{0}] - %message%n</Pattern> </layout> </appender> <appender class="ch.qos.logback.core.ConsoleAppender" name="RootConsoleAppender"> <filter class="ch.qos.logback.classic.filter.ThresholdFilter"> <level>info</level> </filter> <layout class="ch.qos.logback.classic.PatternLayout"> <Pattern>%-4r [%t] %-5p %c %x - %m%n</Pattern> </layout> </appender> <root> <level value="debug"/> <appender-ref ref="RootFileAppender"/> <appender-ref ref="RootConsoleAppender"/> </root> </configuration> Thanks ________________________________ Disclaimer: This e-mail message is intended only for the personal use of the recipient(s) named above. If you are not an intended recipient, you may not review, copy or distribute this message. If you have received this communication in error, please notify us immediately by e-mail and delete the original message. This e-mail expresses views only of the sender, which are not to be attributed to Rite Aid Corporation and may not be copied or distributed without this statement.

2 2

[JIRA] Created: (LBCLASSIC-201) Preferably don't call toString() on objects in arguments array
by Donald Graham (JIRA) 07 Apr '10

07 Apr '10

Preferably don't call toString() on objects in arguments array -------------------------------------------------------------- Key: LBCLASSIC-201 URL: http://jira.qos.ch/browse/LBCLASSIC-201 Project: logback-classic Issue Type: Improvement Components: appender Affects Versions: 0.9.19 Environment: Software platform Reporter: Donald Graham Assignee: Logback dev list I'm attempting to use a SocketAppender to send log events over the network to a custom appender hosted by SimpleSocketServer. My custom appender needs to work with my arguments as objects, rather than strings. I noticed that the string representations of my arguments were being passed across the network, and traced through to the code shown below (from ch.qos.logback.classic.spi.LoggingEventVO). Would you consider sending the object's serialized form instead (assuming the object is serializable)? private void writeObject(ObjectOutputStream out) throws IOException { out.defaultWriteObject(); out.writeInt(level.levelInt); if (argumentArray != null) { int len = argumentArray.length; out.writeInt(len); for (int i = 0; i < argumentArray.length; i++) { if (argumentArray[i] != null) { out.writeObject(argumentArray[i].toString()); } else { out.writeObject(NULL_ARGUMENT_ARRAY_ELEMENT); } } } else { out.writeInt(NULL_ARGUMENT_ARRAY); } } -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://jira.qos.ch/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira

4 7

[GIT] Logback: the generic, reliable, fast and flexible logging framework. branch, master, updated. v0.9.20-5-g6e526ff
by git-noreply＠pixie.qos.ch 07 Apr '10

07 Apr '10

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Logback: the generic, reliable, fast and flexible logging framework.". The branch, master has been updated via 6e526ff11d650992626ea5ff20e7f0751c493789 (commit) from 52502aee9297ddb4cd610cb399407f9d99091e84 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.qos.ch/gitweb/?p=logback.git;a=commit;h=6e526ff11d650992626ea5ff… http://github.com/ceki/logback/commit/6e526ff11d650992626ea5ff20e7f0751c493… commit 6e526ff11d650992626ea5ff20e7f0751c493789 Author: Ceki Gulcu <ceki(a)qos.ch> Date: Wed Apr 7 09:11:07 2010 +0200 - Minor edits = typo correction in http://logback.qos.ch/manual/configuration.html#fileInclusion diff --git a/logback-classic/src/test/java/ch/qos/logback/classic/net/SerializationPerfsTest.java b/logback-classic/src/test/java/ch/qos/logback/classic/net/SerializationPerfTest.java similarity index 99% rename from logback-classic/src/test/java/ch/qos/logback/classic/net/SerializationPerfsTest.java rename to logback-classic/src/test/java/ch/qos/logback/classic/net/SerializationPerfTest.java index 09d0102..46ea7b1 100644 --- a/logback-classic/src/test/java/ch/qos/logback/classic/net/SerializationPerfsTest.java +++ b/logback-classic/src/test/java/ch/qos/logback/classic/net/SerializationPerfTest.java @@ -22,7 +22,7 @@ import ch.qos.logback.classic.net.testObjectBuilders.Builder; import ch.qos.logback.classic.net.testObjectBuilders.TrivialLoggingEventBuilder; import ch.qos.logback.classic.net.testObjectBuilders.MinimalSerBuilder; -public class SerializationPerfsTest extends TestCase { +public class SerializationPerfTest extends TestCase { ObjectOutputStream oos; @@ -197,4 +197,7 @@ public class SerializationPerfsTest extends TestCase { Builder builder = new TrivialLoggingEventBuilder(); runPerfTest(builder, "LoggingEvent object serialization"); } + + + } diff --git a/logback-site/src/site/pages/index.html b/logback-site/src/site/pages/index.html index fc97d64..07760e2 100644 --- a/logback-site/src/site/pages/index.html +++ b/logback-site/src/site/pages/index.html @@ -71,21 +71,29 @@ <li><a href="http://www.geomajas.org/">Geomajas</a></li> <li><a href="http://www.gradle.org/">Gradle</a></li> <li><a href="http://jmxmonitor.sourceforge.net/">JMX Monitor</a></li> - <li><a href="http://code.google.com/p/openmeetings/">OpenMeetings</a></li> + </ul> </td> <td> <ul> + <li><a href="http://code.google.com/p/openmeetings/">OpenMeetings</a></li> <li><a href="http://liftweb.net/">Lift</a></li> <li><a href="http://www.red5.org">Red5</a></li> <li><a href="http://scalate.fusesource.org/">Scalate</a></li> <li><a href="http://sonar.codehaus.org/">Sonar</a></li> + </ul> + </td> + + <td valign="top"> + <ul> <li><a href="http://static.springsource.org/s2-dmserver/2.0.x/user-guide/htmlsingle/user…">SpringSource dm Server</a></li> + <li><a href="http://www.streambase.com/developers/docs/latest/index.html">StreamBase</a></li> <li><a href="http://www.xuggle.com/xuggler/">Xuggler</a></li> </ul> </td> + </tr> </table> <script src="templates/footer.js" type="text/javascript"></script> diff --git a/logback-site/src/site/pages/manual/configuration.html b/logback-site/src/site/pages/manual/configuration.html index 884b58e..7990a48 100644 --- a/logback-site/src/site/pages/manual/configuration.html +++ b/logback-site/src/site/pages/manual/configuration.html @@ -1629,8 +1629,8 @@ fileName=myApp.log <b class="green big"></included></b></pre> - <p>Again, if you have note already, please note the mandatory <code - class="big green"><included></code> element.</p> + <p>Again, please note the mandatory + <code class="big green"><included></code> element if you have not already done so.</p> <p>The contents to include can be referenced as a file, as a resource, or as a URL.</p> ----------------------------------------------------------------------- Summary of changes: ...onPerfsTest.java => SerializationPerfTest.java} | 5 ++++- logback-site/src/site/pages/index.html | 10 +++++++++- .../src/site/pages/manual/configuration.html | 4 ++-- 3 files changed, 15 insertions(+), 4 deletions(-) rename logback-classic/src/test/java/ch/qos/logback/classic/net/{SerializationPerfsTest.java => SerializationPerfTest.java} (99%) hooks/post-receive -- Logback: the generic, reliable, fast and flexible logging framework.

1 0

[JIRA] Created: (LBCLASSIC-195) Allow TurboFilters to modify events
by Ceki Gulcu (JIRA) 06 Apr '10

06 Apr '10

Allow TurboFilters to modify events ----------------------------------- Key: LBCLASSIC-195 URL: http://jira.qos.ch/browse/LBCLASSIC-195 Project: logback-classic Issue Type: Improvement Components: Other Reporter: Ceki Gulcu Assignee: Ceki Gulcu Priority: Blocker http://qos.ch/pipermail/logback-dev/2010-March/005290.html -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://jira.qos.ch/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira

4 24

[GIT] Logback: the generic, reliable, fast and flexible logging framework. branch, master, updated. v0.9.20-4-g52502ae
by git-noreply＠pixie.qos.ch 06 Apr '10

06 Apr '10

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Logback: the generic, reliable, fast and flexible logging framework.". The branch, master has been updated via 52502aee9297ddb4cd610cb399407f9d99091e84 (commit) from b13f02fb21fc894022416428734030628800dec2 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.qos.ch/gitweb/?p=logback.git;a=commit;h=52502aee9297ddb4cd610cb3… http://github.com/ceki/logback/commit/52502aee9297ddb4cd610cb399407f9d99091… commit 52502aee9297ddb4cd610cb399407f9d99091e84 Author: Ceki Gulcu <ceki(a)qos.ch> Date: Tue Apr 6 12:42:57 2010 +0200 minor edits diff --git a/logback-site/src/site/pages/index.html b/logback-site/src/site/pages/index.html index 8d819d9..fc97d64 100644 --- a/logback-site/src/site/pages/index.html +++ b/logback-site/src/site/pages/index.html @@ -58,8 +58,8 @@ <h3>Projects known to rely on logback</h3> - <p>Here is a non-exhaustive list of projects known to depend on - logback, in alphabetical order: + <p>Here is a non-exhaustive list of open-source projects known to + depend on logback, in alphabetical order: </p> <table border="0"> @@ -82,7 +82,8 @@ <li><a href="http://sonar.codehaus.org/">Sonar</a></li> <li><a href="http://static.springsource.org/s2-dmserver/2.0.x/user-guide/htmlsingle/user…">SpringSource - dm Server</a></li> + dm Server</a></li> + <li><a href="http://www.xuggle.com/xuggler/">Xuggler</a></li> </ul> </td> </tr> diff --git a/logback-site/src/site/pages/manual/configuration.html b/logback-site/src/site/pages/manual/configuration.html index 16f41a9..884b58e 100644 --- a/logback-site/src/site/pages/manual/configuration.html +++ b/logback-site/src/site/pages/manual/configuration.html @@ -1480,8 +1480,7 @@ fileName=myApp.log <p>The general format for conditional statements is shown below.</p> - <pre class="prettyprint source"><configuration> - + <pre class="prettyprint source">  <if condition="some conditional expression"> <then> @@ -1497,9 +1496,7 @@ fileName=myApp.log <else> ... </else> - </if> - -</configuration></pre> + </if></pre> <p>The condition is a java expression where only context properties or system properties are accessible. For a key passed as argument, @@ -1509,7 +1506,9 @@ fileName=myApp.log write <code>property("k")</code> or equivalently <code>p("k")</code>. If the property with key "k" is undefined, the property method will return the empty string and not null. This - avoids the need to to check for null values.</p> + avoids the need to to check for null values. If you need to check + whether a property is null, the <code>isNull()</code> method is + provided. For example, you can write <code>isNull("k")</code>.</p> <p>In the next example, the <code>ConsoleAppender</code> will be attached to the root logger, but only if the HOSTNAME is @@ -1546,13 +1545,13 @@ fileName=myApp.log </configuration></pre> - <p>Conditional processing is supported everywhere within the + <p>Conditional processing is supported <em>anywhere</em> within the <code><configuration></code> element. Nested if-then-else statements are also supported. However, XML syntax is awfully cumbersome and is ill suited as the foundation of a general purpose - programming langiage. Consequently, too many conditionals will + programming language. Consequently, too many conditionals will quickly render your configuration files ungrokable to subsequent - readers of your configuration files, including yourself. + readers, including yourself. </p> ----------------------------------------------------------------------- Summary of changes: logback-site/src/site/pages/index.html | 7 ++++--- .../src/site/pages/manual/configuration.html | 17 ++++++++--------- 2 files changed, 12 insertions(+), 12 deletions(-) hooks/post-receive -- Logback: the generic, reliable, fast and flexible logging framework.

1 0

[GIT] Logback: the generic, reliable, fast and flexible logging framework. branch, master, updated. v0.9.20-3-gb13f02f
by git-noreply＠pixie.qos.ch 05 Apr '10

05 Apr '10

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Logback: the generic, reliable, fast and flexible logging framework.". The branch, master has been updated via b13f02fb21fc894022416428734030628800dec2 (commit) from 3bb6bf6908b1c17d58e0dde95aaab36570b063b6 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.qos.ch/gitweb/?p=logback.git;a=commit;h=b13f02fb21fc894022416428… http://github.com/ceki/logback/commit/b13f02fb21fc894022416428734030628800d… commit b13f02fb21fc894022416428734030628800dec2 Author: Ceki Gulcu <ceki(a)qos.ch> Date: Mon Apr 5 21:09:51 2010 +0200 Removed superflous import diff --git a/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java b/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java index 56a802a..da32e3f 100644 --- a/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java +++ b/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java @@ -40,7 +40,6 @@ import ch.qos.logback.core.joran.spi.JoranException; import ch.qos.logback.core.joran.spi.Pattern; import ch.qos.logback.core.status.Status; import ch.qos.logback.core.status.StatusChecker; -import ch.qos.logback.core.testUtil.Env; import ch.qos.logback.core.testUtil.RandomUtil; import ch.qos.logback.core.util.CoreTestConstants; import ch.qos.logback.core.util.StatusPrinter; ----------------------------------------------------------------------- Summary of changes: .../core/joran/action/IncludeActionTest.java | 1 - 1 files changed, 0 insertions(+), 1 deletions(-) hooks/post-receive -- Logback: the generic, reliable, fast and flexible logging framework.

1 0

[GIT] Logback: the generic, reliable, fast and flexible logging framework. branch, master, updated. v0.9.20-2-g3bb6bf6
by git-noreply＠pixie.qos.ch 05 Apr '10

05 Apr '10

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Logback: the generic, reliable, fast and flexible logging framework.". The branch, master has been updated via 3bb6bf6908b1c17d58e0dde95aaab36570b063b6 (commit) from 7049873cad7045bae59ddc55fa9f6ce699dd5469 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.qos.ch/gitweb/?p=logback.git;a=commit;h=3bb6bf6908b1c17d58e0dde9… http://github.com/ceki/logback/commit/3bb6bf6908b1c17d58e0dde95aaab36570b06… commit 3bb6bf6908b1c17d58e0dde95aaab36570b063b6 Author: Ceki Gulcu <ceki(a)qos.ch> Date: Mon Apr 5 21:08:52 2010 +0200 It looks like Windows XP may also throw an IOException instead of UknownHostException according to Tomasz Nurkiewicz. diff --git a/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java b/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java index 1f31383..56a802a 100644 --- a/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java +++ b/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java @@ -59,9 +59,9 @@ public class IncludeActionTest { static final String TOP_BY_FILE = INCLUSION_DIR_PREFIX + "topByFile.xml"; - static final String INTERMEDIARY_FILE = INCLUSION_DIR_PREFIX + "intermediaryByFile.xml"; + static final String INTERMEDIARY_FILE = INCLUSION_DIR_PREFIX + + "intermediaryByFile.xml"; - static final String SUB_FILE = INCLUSION_DIR_PREFIX + "subByFile.xml"; static final String MULTI_INCLUDE_BY_FILE = INCLUSION_DIR_PREFIX @@ -89,7 +89,7 @@ public class IncludeActionTest { rulesMap.put(new Pattern("x"), new NOPAction()); rulesMap.put(new Pattern("x/include"), new IncludeAction()); rulesMap.put(new Pattern("x/stack"), new StackAction()); - + tc = new TrivialConfigurator(rulesMap); tc.setContext(context); } @@ -108,21 +108,21 @@ public class IncludeActionTest { public void basicFile() throws JoranException { System.setProperty(INCLUDE_KEY, INCLUDED_FILE); tc.doConfigure(TOP_BY_FILE); - verifyConfig(new String[] {"IA", "IB"}); + verifyConfig(new String[] { "IA", "IB" }); } @Test public void basicResource() throws JoranException { System.setProperty(INCLUDE_KEY, INCLUDED_AS_RESOURCE); tc.doConfigure(INCLUDE_BY_RESOURCE); - verifyConfig(new String[] {"AR_A", "AR_B"}); + verifyConfig(new String[] { "AR_A", "AR_B" }); } @Test public void basicURL() throws JoranException { System.setProperty(INCLUDE_KEY, URL_TO_INCLUDE); tc.doConfigure(TOP_BY_URL); - verifyConfig(new String[] {"IA", "IB"}); + verifyConfig(new String[] { "IA", "IB" }); } @Test @@ -178,12 +178,13 @@ public class IncludeActionTest { System.setProperty(INCLUDE_KEY, "http://logback2345.qos.ch"); tc.doConfigure(TOP_BY_URL); assertEquals(Status.ERROR, context.getStatusManager().getLevel()); - StatusChecker sc = new StatusChecker(context.getStatusManager()); + StatusChecker sc = new StatusChecker(context.getStatusManager()); + // OS X throws IOException instead of UnknownHostException // http://jira.qos.ch/browse/LBCORE-129 - if (!Env.isMac()) { - assertTrue(sc.containsException(UnknownHostException.class)); - } + // This behavior has been observed on Windows XP as well + assertTrue(sc.containsException(UnknownHostException.class) + || sc.containsException(IOException.class)); } @Test @@ -196,20 +197,20 @@ public class IncludeActionTest { witness.push("b"); witness.push("c"); assertEquals(witness, StackAction.stack); - } + } @Test public void multiInclude() throws JoranException { System.setProperty(INCLUDE_KEY, INCLUDED_FILE); System.setProperty(SECOND_FILE_KEY, SECOND_FILE); tc.doConfigure(MULTI_INCLUDE_BY_FILE); - verifyConfig(new String[] {"IA", "IB", "SECOND"}); + verifyConfig(new String[] { "IA", "IB", "SECOND" }); } - + void verifyConfig(String[] expected) { Stack<String> witness = new Stack<String>(); witness.addAll(Arrays.asList(expected)); assertEquals(witness, StackAction.stack); } - + } ----------------------------------------------------------------------- Summary of changes: .../core/joran/action/IncludeActionTest.java | 29 ++++++++++--------- 1 files changed, 15 insertions(+), 14 deletions(-) hooks/post-receive -- Logback: the generic, reliable, fast and flexible logging framework.

1 0

[GIT] Logback: the generic, reliable, fast and flexible logging framework. branch, lbcore148, updated. v0.9.20-4-gfeec52c
by git-noreply＠pixie.qos.ch 05 Apr '10

05 Apr '10

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Logback: the generic, reliable, fast and flexible logging framework.". The branch, lbcore148 has been updated via feec52cdd1dfd7215ced4a857fd4538fa3871b8f (commit) from 7c545298b251c2e1574029b945849816a8986332 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.qos.ch/gitweb/?p=logback.git;a=commit;h=feec52cdd1dfd7215ced4a85… http://github.com/ceki/logback/commit/feec52cdd1dfd7215ced4a857fd4538fa3871… commit feec52cdd1dfd7215ced4a857fd4538fa3871b8f Author: Ceki Gulcu <ceki(a)qos.ch> Date: Mon Apr 5 21:05:52 2010 +0200 It looks like Windows XP may also throw an IOException instead of UknownHostException according to Tomasz Nurkiewicz. diff --git a/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java b/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java index 1f31383..e7e070a 100644 --- a/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java +++ b/logback-core/src/test/java/ch/qos/logback/core/joran/action/IncludeActionTest.java @@ -59,9 +59,9 @@ public class IncludeActionTest { static final String TOP_BY_FILE = INCLUSION_DIR_PREFIX + "topByFile.xml"; - static final String INTERMEDIARY_FILE = INCLUSION_DIR_PREFIX + "intermediaryByFile.xml"; + static final String INTERMEDIARY_FILE = INCLUSION_DIR_PREFIX + + "intermediaryByFile.xml"; - static final String SUB_FILE = INCLUSION_DIR_PREFIX + "subByFile.xml"; static final String MULTI_INCLUDE_BY_FILE = INCLUSION_DIR_PREFIX @@ -89,7 +89,7 @@ public class IncludeActionTest { rulesMap.put(new Pattern("x"), new NOPAction()); rulesMap.put(new Pattern("x/include"), new IncludeAction()); rulesMap.put(new Pattern("x/stack"), new StackAction()); - + tc = new TrivialConfigurator(rulesMap); tc.setContext(context); } @@ -108,21 +108,21 @@ public class IncludeActionTest { public void basicFile() throws JoranException { System.setProperty(INCLUDE_KEY, INCLUDED_FILE); tc.doConfigure(TOP_BY_FILE); - verifyConfig(new String[] {"IA", "IB"}); + verifyConfig(new String[] { "IA", "IB" }); } @Test public void basicResource() throws JoranException { System.setProperty(INCLUDE_KEY, INCLUDED_AS_RESOURCE); tc.doConfigure(INCLUDE_BY_RESOURCE); - verifyConfig(new String[] {"AR_A", "AR_B"}); + verifyConfig(new String[] { "AR_A", "AR_B" }); } @Test public void basicURL() throws JoranException { System.setProperty(INCLUDE_KEY, URL_TO_INCLUDE); tc.doConfigure(TOP_BY_URL); - verifyConfig(new String[] {"IA", "IB"}); + verifyConfig(new String[] { "IA", "IB" }); } @Test @@ -179,11 +179,12 @@ public class IncludeActionTest { tc.doConfigure(TOP_BY_URL); assertEquals(Status.ERROR, context.getStatusManager().getLevel()); StatusChecker sc = new StatusChecker(context.getStatusManager()); + // OS X throws IOException instead of UnknownHostException // http://jira.qos.ch/browse/LBCORE-129 - if (!Env.isMac()) { - assertTrue(sc.containsException(UnknownHostException.class)); - } + // This behavior has been observed on Windows XP as well + assertTrue(sc.containsException(UnknownHostException.class) + || sc.containsException(IOException.class)); } @Test @@ -196,20 +197,20 @@ public class IncludeActionTest { witness.push("b"); witness.push("c"); assertEquals(witness, StackAction.stack); - } + } @Test public void multiInclude() throws JoranException { System.setProperty(INCLUDE_KEY, INCLUDED_FILE); System.setProperty(SECOND_FILE_KEY, SECOND_FILE); tc.doConfigure(MULTI_INCLUDE_BY_FILE); - verifyConfig(new String[] {"IA", "IB", "SECOND"}); + verifyConfig(new String[] { "IA", "IB", "SECOND" }); } - + void verifyConfig(String[] expected) { Stack<String> witness = new Stack<String>(); witness.addAll(Arrays.asList(expected)); assertEquals(witness, StackAction.stack); } - + } ----------------------------------------------------------------------- Summary of changes: .../core/joran/action/IncludeActionTest.java | 27 ++++++++++--------- 1 files changed, 14 insertions(+), 13 deletions(-) hooks/post-receive -- Logback: the generic, reliable, fast and flexible logging framework.

1 0

[JIRA] Created: (LBCORE-148) Let SocketAppender re-establish failed connections in-thread insead of creating a parallel thread
by Ceki Gulcu (JIRA) 03 Apr '10

03 Apr '10

Let SocketAppender re-establish failed connections in-thread insead of creating a parallel thread ------------------------------------------------------------------------------------------------- Key: LBCORE-148 URL: http://jira.qos.ch/browse/LBCORE-148 Project: logback-core Issue Type: Improvement Reporter: Ceki Gulcu Assignee: Logback dev list SocketAppender can establish connections using ResilientOutputStreamBase instead of creating a parallel thread. This approach is JEE friendly and leverages existing code base instead of re-inventing the wheel. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://jira.qos.ch/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira

1 1

[GIT] Logback: the generic, reliable, fast and flexible logging framework. branch, lbcore148, updated. v0.9.20-3-g7c54529
by git-noreply＠pixie.qos.ch 03 Apr '10

03 Apr '10

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Logback: the generic, reliable, fast and flexible logging framework.". The branch, lbcore148 has been updated via 7c545298b251c2e1574029b945849816a8986332 (commit) from 45f7a6281a1f2a07b0f11ac79af72ccd7d8979a2 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.qos.ch/gitweb/?p=logback.git;a=commit;h=7c545298b251c2e1574029b9… http://github.com/ceki/logback/commit/7c545298b251c2e1574029b945849816a8986… commit 7c545298b251c2e1574029b945849816a8986332 Author: Ceki Gulcu <ceki(a)qos.ch> Date: Sat Apr 3 18:27:59 2010 +0200 Fixed LBCORE-148 diff --git a/logback-classic/src/test/java/ch/qos/logback/classic/net/SocketAppenderTest.java b/logback-classic/src/test/java/ch/qos/logback/classic/net/SocketAppenderTest.java index aaecb2c..f3b471b 100644 --- a/logback-classic/src/test/java/ch/qos/logback/classic/net/SocketAppenderTest.java +++ b/logback-classic/src/test/java/ch/qos/logback/classic/net/SocketAppenderTest.java @@ -31,6 +31,8 @@ import ch.qos.logback.classic.LoggerContext; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.classic.spi.LoggerContextVO; import ch.qos.logback.core.read.ListAppender; +import ch.qos.logback.core.recovery.RecoveryCoordinator; +import ch.qos.logback.core.status.OnConsoleStatusListener; import ch.qos.logback.core.util.StatusPrinter; public class SocketAppenderTest { @@ -40,8 +42,8 @@ public class SocketAppenderTest { static final int SLEEP_AFTER_LOG = 100; int port = 4561; - LoggerContext lc = new LoggerContext(); - LoggerContext serverLC = new LoggerContext(); + LoggerContext context = new LoggerContext(); + LoggerContext serverContext = new LoggerContext(); ListAppender<ILoggingEvent> la = new ListAppender<ILoggingEvent>(); SocketAppender socketAppender = new SocketAppender(); private boolean includeCallerData = false; @@ -50,10 +52,11 @@ public class SocketAppenderTest { @Test public void startFailNoRemoteHost() { SocketAppender appender = new SocketAppender(); - appender.setContext(lc); + appender.setContext(context); appender.setPort(123); appender.start(); - assertEquals(1, lc.getStatusManager().getCount()); + StatusPrinter.print(context); + assertEquals(1, context.getStatusManager().getCount()); } @Test @@ -62,7 +65,7 @@ public class SocketAppenderTest { waitForServerToStart(); configureClient(); - Logger logger = lc.getLogger(Logger.ROOT_LOGGER_NAME); + Logger logger = context.getLogger(Logger.ROOT_LOGGER_NAME); logger.debug("test msg"); Thread.sleep(SLEEP_AFTER_LOG); @@ -84,7 +87,7 @@ public class SocketAppenderTest { waitForServerToStart(); configureClient(); - Logger logger = lc.getLogger(Logger.ROOT_LOGGER_NAME); + Logger logger = context.getLogger(Logger.ROOT_LOGGER_NAME); logger.debug("test msg"); Thread.sleep(SLEEP_AFTER_LOG); @@ -114,7 +117,7 @@ public class SocketAppenderTest { waitForServerToStart(); configureClient(); - Logger logger = lc.getLogger(Logger.ROOT_LOGGER_NAME); + Logger logger = context.getLogger(Logger.ROOT_LOGGER_NAME); MDC.put("key", "testValue"); logger.debug("test msg"); @@ -140,7 +143,7 @@ public class SocketAppenderTest { waitForServerToStart(); configureClient(); - Logger logger = lc.getLogger(Logger.ROOT_LOGGER_NAME); + Logger logger = context.getLogger(Logger.ROOT_LOGGER_NAME); logger.debug("test msg"); Thread.sleep(SLEEP_AFTER_LOG); @@ -162,7 +165,7 @@ public class SocketAppenderTest { // Thread.sleep(SLEEP_AFTER_SERVER_START); configureClient(); - Logger logger = lc.getLogger(Logger.ROOT_LOGGER_NAME); + Logger logger = context.getLogger(Logger.ROOT_LOGGER_NAME); Marker marker = MarkerFactory.getMarker("testMarker"); logger.debug(marker, "test msg"); @@ -184,7 +187,7 @@ public class SocketAppenderTest { configureClient(); - Logger logger = lc.getLogger(Logger.ROOT_LOGGER_NAME); + Logger logger = context.getLogger(Logger.ROOT_LOGGER_NAME); MDC.put("key", "testValue"); logger.debug("test msg"); @@ -209,28 +212,30 @@ public class SocketAppenderTest { @Test public void lateServerLaunch() throws InterruptedException { - // FIXME - //socketAppender.setReconnectionDelay(20); configureClient(); - Logger logger = lc.getLogger(Logger.ROOT_LOGGER_NAME); + context.getStatusManager().add(new OnConsoleStatusListener()); + + Logger logger = context.getLogger(Logger.ROOT_LOGGER_NAME); logger.debug("test msg"); fireServer(); waitForServerToStart(); - Thread.sleep(SLEEP_AFTER_LOG); // allow time for client and server to - // connect - logger.debug("test msg 2"); + System.out.println("Server started"); + Thread.sleep(RecoveryCoordinator.BACKOFF_COEFFICIENT_MIN+10); + + logger.debug("test msg 2"); // trigger connection establishment + logger.debug("test msg 3"); Thread.sleep(SLEEP_AFTER_LOG); simpleSocketServer.close(); Thread.sleep(SLEEP_AFTER_LOG); simpleSocketServer.join(JOIN_OR_WAIT_TIMEOUT); - StatusPrinter.print(lc); + //StatusPrinter.print(context); assertTrue(simpleSocketServer.isClosed()); assertEquals(1, la.list.size()); ILoggingEvent remoteEvent = la.list.get(0); - assertEquals("test msg 2", remoteEvent.getMessage()); + assertEquals("test msg 3", remoteEvent.getMessage()); assertEquals(Level.DEBUG, remoteEvent.getLevel()); } @@ -241,27 +246,27 @@ public class SocketAppenderTest { } private void fireServer() throws InterruptedException { - Logger root = serverLC.getLogger("root"); + Logger root = serverContext.getLogger("root"); la.setName(LIST_APPENDER_NAME); - la.setContext(serverLC); + la.setContext(serverContext); la.start(); root.addAppender(la); - simpleSocketServer = new SimpleSocketServer(serverLC, port); + simpleSocketServer = new SimpleSocketServer(serverContext, port); simpleSocketServer.start(); Thread.yield(); } ListAppender<ILoggingEvent> getListAppender() { - Logger root = serverLC.getLogger("root"); + Logger root = serverContext.getLogger("root"); return (ListAppender<ILoggingEvent>) root.getAppender(LIST_APPENDER_NAME); } private void configureClient() { - lc = new LoggerContext(); - lc.setName("test"); - lc.putProperty("testKey", "testValue"); - Logger root = lc.getLogger(Logger.ROOT_LOGGER_NAME); - socketAppender.setContext(lc); + context = new LoggerContext(); + context.setName("test"); + context.putProperty("testKey", "testValue"); + Logger root = context.getLogger(Logger.ROOT_LOGGER_NAME); + socketAppender.setContext(context); socketAppender.setName("socket"); socketAppender.setPort(port); socketAppender.setRemoteHost("localhost"); diff --git a/logback-core/src/main/java/ch/qos/logback/core/encoder/ObjectOutputStreamEncoder.java b/logback-core/src/main/java/ch/qos/logback/core/encoder/ObjectOutputStreamEncoder.java index 3fa485d..e81cd94 100644 --- a/logback-core/src/main/java/ch/qos/logback/core/encoder/ObjectOutputStreamEncoder.java +++ b/logback-core/src/main/java/ch/qos/logback/core/encoder/ObjectOutputStreamEncoder.java @@ -18,18 +18,30 @@ import java.io.ObjectOutputStream; import java.io.OutputStream; import ch.qos.logback.core.CoreConstants; +import ch.qos.logback.core.recovery.ResilientOutputStreamListener; -public class ObjectOutputStreamEncoder<E> extends EncoderBase<E> { +public class ObjectOutputStreamEncoder<E> extends EncoderBase<E> implements + ResilientOutputStreamListener { ObjectOutputStream oos; + OutputStream os; protected int counter = 0; - + + boolean presumedInError = false; + @Override public void init(OutputStream os) throws IOException { + this.os = os; oos = new ObjectOutputStream(os); } public void doEncode(E event) throws IOException { + // if in error then provoke recovery + if (presumedInError) { + os.write(0); + return; + } + oos.writeObject(event); oos.flush(); if (++counter >= CoreConstants.OOS_RESET_FREQUENCY) { @@ -41,8 +53,27 @@ public class ObjectOutputStreamEncoder<E> extends EncoderBase<E> { } - public void close() throws IOException { - oos.close(); + public void close() { + if (oos == null) { + return; + } + try { + oos.close(); + } catch (IOException e) { + + } } + public void outputStreamChangedEvent(OutputStream os) { + try { + this.os = os; + oos = new ObjectOutputStream(os); + presumedInError = false; + } catch (IOException e) { + } + } + + public void presumedInError() { + presumedInError = true; + } } diff --git a/logback-core/src/main/java/ch/qos/logback/core/net/SocketAppenderBase.java b/logback-core/src/main/java/ch/qos/logback/core/net/SocketAppenderBase.java index 008806d..a8eadde 100644 --- a/logback-core/src/main/java/ch/qos/logback/core/net/SocketAppenderBase.java +++ b/logback-core/src/main/java/ch/qos/logback/core/net/SocketAppenderBase.java @@ -15,12 +15,12 @@ package ch.qos.logback.core.net; import java.io.IOException; -import java.io.ObjectOutputStream; import java.io.Serializable; import java.net.InetAddress; -import ch.qos.logback.core.AppenderBase; -import ch.qos.logback.core.CoreConstants; +import ch.qos.logback.core.UnsynchronizedAppenderBase; +import ch.qos.logback.core.encoder.ObjectOutputStreamEncoder; +import ch.qos.logback.core.recovery.ResilientSocketStream; import ch.qos.logback.core.spi.PreSerializationTransformer; /** @@ -31,7 +31,8 @@ import ch.qos.logback.core.spi.PreSerializationTransformer; * @author Sébastien Pennec */ -public abstract class SocketAppenderBase<E> extends AppenderBase<E> { +public abstract class SocketAppenderBase<E> extends + UnsynchronizedAppenderBase<E> { /** * The default port number of remote logging server (4560). @@ -39,45 +40,51 @@ public abstract class SocketAppenderBase<E> extends AppenderBase<E> { static final int DEFAULT_PORT = 4560; /** - * The default reconnection delay (30000 milliseconds or 30 seconds). - */ - static final int DEFAULT_RECONNECTION_DELAY = 30000; - - /** * We remember host name as String in addition to the resolved InetAddress so * that it can be returned via getOption(). */ protected String host; protected int port = DEFAULT_PORT; - protected ObjectOutputStream oos; - protected int reconnectionDelay = DEFAULT_RECONNECTION_DELAY; - protected int counter = 0; + ObjectOutputStreamEncoder<Serializable> encoder = new ObjectOutputStreamEncoder<Serializable>(); /** * Start this appender. */ public void start() { - int errorCount = 0; - if (port == 0) { - errorCount++; - addError("No port was configured for appender" - + name - + " For more information, please visit http://logback.qos.ch/codes.html#socket_no_port"); - } + InetAddress inetAddress = null; if (host == null) { - errorCount++; addError("No remote address was configured for appender" + name + " For more information, please visit http://logback.qos.ch/codes.html#socket_no_host"); + return; + } else { + inetAddress = getAddressByName(host); + if (inetAddress == null) { + return; + } } - //connect(address, port); + ResilientSocketStream ros = new ResilientSocketStream(inetAddress, port, + encoder, context); + + try { + encoder.init(ros); + } catch (IOException e) { + ros.addError("Failed to open [" + inetAddress.getHostName() + ":" + port + + "]", e); + } + super.start(); + } - if (errorCount == 0) { - this.started = true; + InetAddress getAddressByName(String host) { + try { + return InetAddress.getByName(host); + } catch (Exception e) { + addError("Could not find address of [" + host + "].", e); + return null; } } @@ -93,78 +100,29 @@ public abstract class SocketAppenderBase<E> extends AppenderBase<E> { if (!isStarted()) return; + encoder.stop(); this.started = false; - cleanUp(); - } - - /** - * Drop the connection to the remote host and release the underlying connector - * thread if it has been created - */ - public void cleanUp() { - if (oos != null) { - try { - oos.close(); - } catch (IOException e) { - addError("Could not close oos.", e); - } - oos = null; - } } - @Override protected void append(E event) { - if (event == null) return; + if (!isStarted()) { + return; + } -// if (address == null) { -// addError("No remote host is set for SocketAppender named \"" -// + this.name -// + "\". For more information, please visit http://logback.qos.ch/codes.html#socket_no_host"); -// return; -// } - - if (oos != null) { - try { - postProcessEvent(event); - Serializable serEvent = getPST().transform(event); - oos.writeObject(serEvent); - oos.flush(); - if (++counter >= CoreConstants.OOS_RESET_FREQUENCY) { - counter = 0; - // Failing to reset the object output stream every now and - // then creates a serious memory leak. - // System.err.println("Doing oos.reset()"); - oos.reset(); - } - } catch (IOException e) { - if (oos != null) { - try { - oos.close(); - } catch (IOException ignore) { - } - } - - oos = null; - addWarn("Detected problem with connection: " + e); - } + try { + postProcessEvent(event); + Serializable serEvent = getPST().transform(event); + encoder.doEncode(serEvent); + } catch (IOException e) { } } protected abstract void postProcessEvent(E event); - protected abstract PreSerializationTransformer<E> getPST(); - - protected static InetAddress getAddressByName(String host) { - try { - return InetAddress.getByName(host); - } catch (Exception e) { - // addError("Could not find address of [" + host + "].", e); - return null; - } - } + protected abstract PreSerializationTransformer<E> getPST(); /** * The <b>RemoteHost</b> option takes a string value which should be the host @@ -182,8 +140,8 @@ public abstract class SocketAppenderBase<E> extends AppenderBase<E> { } /** - * The <b>Port</b> option takes a positive integer representing the port - * where the server is waiting for connections. + * The <b>Port</b> option takes a positive integer representing the port where + * the server is waiting for connections. */ public void setPort(int port) { this.port = port; @@ -195,6 +153,5 @@ public abstract class SocketAppenderBase<E> extends AppenderBase<E> { public int getPort() { return port; } - } diff --git a/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientOutputStreamBase.java b/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientOutputStreamBase.java index 9eaefbf..83f3f70 100644 --- a/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientOutputStreamBase.java +++ b/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientOutputStreamBase.java @@ -34,7 +34,7 @@ abstract public class ResilientOutputStreamBase extends OutputStream implements private int noContextWarning = 0; private int statusCount = 0; - private RecoveryCoordinator recoveryCoordinator; + protected RecoveryCoordinator recoveryCoordinator; protected OutputStream os; protected boolean presumedClean = true; @@ -42,7 +42,7 @@ abstract public class ResilientOutputStreamBase extends OutputStream implements private ContextAwareImpl cai = new ContextAwareImpl(this); List<ResilientOutputStreamListener> listenerList = new ArrayList<ResilientOutputStreamListener>(); - + final private boolean isPresumedInError() { // existence of recoveryCoordinator indicates failed state return (recoveryCoordinator != null && !presumedClean); @@ -111,6 +111,7 @@ abstract public class ResilientOutputStreamBase extends OutputStream implements presumedClean = false; if (recoveryCoordinator == null) { recoveryCoordinator = new RecoveryCoordinator(); + firePresumedInErrorChangedEvent(); } } @@ -140,17 +141,24 @@ abstract public class ResilientOutputStreamBase extends OutputStream implements + getDescription(), this, e)); } } - + void fireOutputStreamChangedEvent() { - for(ResilientOutputStreamListener listener: listenerList) { - listener.outputStreamChangedEvent(); + for (ResilientOutputStreamListener listener : listenerList) { + listener.outputStreamChangedEvent(this); } } - void addResilientOutputStreamListener(ResilientOutputStreamListener listener) { + void firePresumedInErrorChangedEvent() { + for (ResilientOutputStreamListener listener : listenerList) { + listener.presumedInError(); + } + } + + public void addResilientOutputStreamListener( + ResilientOutputStreamListener listener) { listenerList.add(listener); } - + void addStatusIfCountNotOverLimit(Status s) { ++statusCount; if (statusCount < STATUS_COUNT_LIMIT) { @@ -171,7 +179,7 @@ abstract public class ResilientOutputStreamBase extends OutputStream implements } return; } - + StatusManager sm = cai.getStatusManager(); if (sm != null) { sm.add(status); @@ -179,7 +187,7 @@ abstract public class ResilientOutputStreamBase extends OutputStream implements } public Context getContext() { - return cai.getContext(); + return cai.getContext(); } public void setContext(Context context) { @@ -196,7 +204,6 @@ abstract public class ResilientOutputStreamBase extends OutputStream implements public void addInfo(String msg) { cai.addInfo(msg); - } public void addInfo(String msg, Throwable ex) { diff --git a/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientOutputStreamListener.java b/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientOutputStreamListener.java index ba5b0b1..66ddcb3 100644 --- a/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientOutputStreamListener.java +++ b/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientOutputStreamListener.java @@ -13,12 +13,15 @@ */ package ch.qos.logback.core.recovery; +import java.io.OutputStream; + public interface ResilientOutputStreamListener { /** * ResilientOutputStream instance will fire this event each time the * underlying output stream of the instance is changed. */ - void outputStreamChangedEvent(); - + void outputStreamChangedEvent(OutputStream os); + + void presumedInError(); } diff --git a/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientSocketStream.java b/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientSocketStream.java index cf5a671..9e4ec40 100644 --- a/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientSocketStream.java +++ b/logback-core/src/main/java/ch/qos/logback/core/recovery/ResilientSocketStream.java @@ -21,47 +21,58 @@ import java.net.Socket; import ch.qos.logback.core.Context; import ch.qos.logback.core.spi.ContextAware; -public class ResilientSocketStream extends ResilientOutputStreamBase implements ContextAware { +public class ResilientSocketStream extends ResilientOutputStreamBase implements + ContextAware { - String host; int port; - Context context; InetAddress inetAddress; - - public ResilientSocketStream(String host, int port) - throws IOException { + + public ResilientSocketStream(InetAddress inetAddress, int port) { super(); - this.host = host; + this.inetAddress = inetAddress; this.port = port; - super.os = openNewOutputStream(); - this.presumedClean = true; + try { + this.os = openNewOutputStream(); + this.presumedClean = true; + } catch (IOException e) { + postIOFailure(e); + } } - protected InetAddress getAddressByName(String host) { + public ResilientSocketStream(InetAddress inetAddress, int port, ResilientOutputStreamListener listener, Context context) { + super(); + this.inetAddress = inetAddress; + this.port = port; + setContext(context); + addResilientOutputStreamListener(listener); try { - return InetAddress.getByName(host); - } catch (Exception e) { - addError("Could not find address of [" + host + "].", e); - return null; + this.os = openNewOutputStream(); + this.presumedClean = true; + } catch (IOException e) { + postIOFailure(e); } } + + final public boolean isPresumedInError() { + return (recoveryCoordinator != null && !presumedClean); + } + @Override String getDescription() { - return "socket stream ["+host+":"+port+"]"; + return "socket stream [" + inetAddress.getHostName() + ":" + port + "]"; } @Override - OutputStream openNewOutputStream() throws IOException { + public OutputStream openNewOutputStream() throws IOException { Socket socket = new Socket(inetAddress, port); - return socket.getOutputStream(); + return socket.getOutputStream(); } - + @Override public String toString() { return "c.q.l.c.recovery.ResilientSocketStream@" + System.identityHashCode(this); } - } diff --git a/logback-core/src/main/java/ch/qos/logback/core/status/OnConsoleStatusListener.java b/logback-core/src/main/java/ch/qos/logback/core/status/OnConsoleStatusListener.java index 9b6ea49..f34e59b 100644 --- a/logback-core/src/main/java/ch/qos/logback/core/status/OnConsoleStatusListener.java +++ b/logback-core/src/main/java/ch/qos/logback/core/status/OnConsoleStatusListener.java @@ -28,5 +28,6 @@ public class OnConsoleStatusListener implements StatusListener { StringBuilder sb = new StringBuilder(); StatusPrinter.buildStr(sb, "", status); System.out.print(sb); + System.out.flush(); } } ----------------------------------------------------------------------- Summary of changes: .../logback/classic/net/SocketAppenderTest.java | 59 +++++---- .../core/encoder/ObjectOutputStreamEncoder.java | 39 ++++++- .../qos/logback/core/net/SocketAppenderBase.java | 127 +++++++------------- .../core/recovery/ResilientOutputStreamBase.java | 27 +++-- .../recovery/ResilientOutputStreamListener.java | 7 +- .../core/recovery/ResilientSocketStream.java | 49 +++++--- .../core/status/OnConsoleStatusListener.java | 1 + 7 files changed, 162 insertions(+), 147 deletions(-) hooks/post-receive -- Logback: the generic, reliable, fast and flexible logging framework.

1 0