Initial commit

Author: Andre Newman

.gitignore

@@ -0,0 +1,3 @@
+/.gradle/
+/bin/
+/build/

README.md

@@ -0,0 +1,31 @@
+# Java Logging Framework Benchmark
+An application for testing three different Java logging frameworks:
+
+* Log4j 2
+* Logback
+* java.util.logging
+
+## Building the Project
+This project is build using [Gradle](https://gradle.org/). To build this project, navigate to the project folder and run `gradlew tasks build`.
+
+## Running the Tests
+Run the project using the following command:
+
+`gradle run -Dexec.args="<iterations> <events per iteration> <framework> <appender> <sync>"`
+
+The arguments take the following format:
+
+* Iterations: The number of iterations (i.e. loops) to run over the course of the test (this does not include one additional iteration to warm up the JVM).
+* Events per iteration: The number of events to generate per iteration.
+* Framework: The logging framework to use. This can be `log4j2`, `logback`, or `java.util.logging` for the respective framework. If you wish to use log4j2's asynchronous loggers, use `log4j2-async` instead.
+* Appender: The Appender to use when logging. This can be `file`, `syslog-tcp`, `syslog-udp`, or `console` (for testing purposes).
+* Sync: Specify `sync` for synchronous Appenders, or `async` for asynchronous Appenders.
+
+Information about the current test will be printed to the console.
+
+### Creating new Tests
+If you wish to use a different configuration, add the configuration file to the `src/main/resources/sync` folder. Note that if you want to add an asynchronous test, create a copy with an asynchronous appender and move it to the `src/main/resources/async` folder. The file(s) must follow this naming convention:
+
+`<framework>-<appender>.xml`
+
+Re-run Gradle project and your new configuration should be picked up automatically.

build.gradle

@@ -0,0 +1,46 @@
+/*
+ * This build file was generated by the Gradle 'init' task.
+ *
+ * This generated file contains a sample Java Library project to get you started.
+ * For more details take a look at the Java Libraries chapter in the Gradle
+ * user guide available at https://docs.gradle.org/3.5/userguide/java_library_plugin.html
+ */
+ 
+// Declare dependency versions
+ext.log4j2Version = '2.8.2'
+ext.logbackVersion = '1.2.3'
+ext.disruptorVersion = '3.3.6'
+ext.julToSlf4jVersion = '1.7.25'
+
+apply plugin: 'java-library'
+apply plugin: 'application'
+mainClassName = "com.loggly.frameworks.java.benchmark.Benchmark"
+
+repositories {
+    jcenter()
+}
+
+dependencies {
+    // This dependency is exported to consumers, that is to say found on their compile classpath.
+    api 'org.apache.commons:commons-math3:3.6.1'
+
+    // This dependency is used internally, and not exposed to consumers on their own compile classpath.
+    implementation 'com.google.guava:guava:21.0'
+    
+    // Project-specific dependencies    
+    // Log4j 2
+    compile group: 'org.apache.logging.log4j', name: 'log4j-api', version: log4j2Version
+  	compile group: 'org.apache.logging.log4j', name: 'log4j-core', version: log4j2Version
+  	
+  	// For Log4j2 Async Logging
+  	compile group: 'com.lmax', name: 'disruptor', version: disruptorVersion
+  	
+  	// Logback
+  	compile group: 'ch.qos.logback', name: 'logback-classic', version: logbackVersion
+}
+
+run {
+	systemProperties System.getProperties()
+	
+	args System.getProperty("exec.args").split()	
+}

gradle/wrapper/gradle-wrapper.jar

@@ -0,0 +1,6 @@
+#Fri Aug 04 09:08:24 EDT 2017
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-3.5-bin.zip

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,5 @@
+#!/bin/bash
+# file.sh - Count the number of lines in a log file (excluding warmup)
+# ./file.sh <path to log file>
+
+sed '/Iteration\s0/d' $1 | wc -l -

gradlew

@@ -0,0 +1,18 @@
+/*
+ * This settings file was generated by the Gradle 'init' task.
+ *
+ * The settings file is used to specify which projects to include in your build.
+ * In a single project build this file can be empty or even removed.
+ *
+ * Detailed information about configuring a multi-project build in Gradle can be found
+ * in the user guide at https://docs.gradle.org/3.5/userguide/multi_project_builds.html
+ */
+
+/*
+// To declare projects as part of a multi-project build use the 'include' method
+include 'shared'
+include 'api'
+include 'services:webservice'
+*/
+
+rootProject.name = 'Loggly-BechmarkingJavaLoggingFrameworks2017'