From 615a4306c11ec5b981ab1d3e5c157207cb186726 Mon Sep 17 00:00:00 2001
From: Marcel Puchol <mpucholblasco@gmail.com>
Date: Sun, 19 Jan 2014 19:19:21 +0100
Subject: [PATCH 1/2] Added index.md for java-logstash-logger

---
 recipes/java-logstash-logger/index.md | 55 +++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 recipes/java-logstash-logger/index.md

diff --git a/recipes/java-logstash-logger/index.md b/recipes/java-logstash-logger/index.md
new file mode 100644
index 0000000..0ef4874
--- /dev/null
+++ b/recipes/java-logstash-logger/index.md
@@ -0,0 +1,55 @@
+---
+layout: article
+title: Java logstash logger
+tags: java
+---
+
+* Goal: Ship Java logs to Logstash using Java logging libraries.
+* Audience: Folks who use Java or Java Application Servers to direct log output in Logstash format.
+
+# Preface: capture Java logs is difficult
+
+The most common way to capture Java logs is based on using Java logging libraries
+(such as log4j, Java Logging API, Apache Commons Logging, JBoss logmanager, etc.),
+write those logs in a specified format, and then, capture it using multiline and grok.
+But there is no a perfect regular expression. In addition, multiline and does
+not capture logs correctly when log files are not flushed.
+
+Another way to obtain Java logs is based on using log4j, and adding a SocketAppender
+to send logs directly to Logstash. The main problem here is: what happen if
+Logstash is down or busy during a long time? The answer is simple: some
+logs can be lost.
+
+# Solution: write logs directly on Logstash format
+
+Do not transform logs, write them directly in your desired format!
+
+[logstash-loggers](https://github.com/mpucholblasco/logstash-loggers) can help you
+with this. It is a library to write Logstash formatted logs, plus interfaces
+to those most common Java logging libraries.
+
+It is a project in progress, so
+not all Java logging libraries are supported. Supported logging libraries are
+present on subsequent subsections.
+
+## JBoss logmanager (JBoss 7)
+
+JBoss logmanager is supported. You only should install and configure [ logstash-jboss-logmanager ]
+(https://github.com/mpucholblasco/logstash-loggers/tree/master/logstash-jboss-logmanager)
+to write JBoss 7 logs directly to Logstash format without any regular expression,
+nor headaches on researching why your logs are splitted.
+
+The following configuration sample will configure your JBoss to write your
+server.log file in Logstash format:
+
+     <custom-handler name="HANDLER_NAME" class="net.logstash.loggers.logstash_jboss_logmanager.LogstashSizeRotatingFileHandler" module="net.logstash.loggers.logstash_jboss_logmanager">
+      <properties>
+        <property name="fileName" value="${jboss.server.log.dir}/server.log"/>
+        <property name="timeZone" value="UTC"/>
+        <property name="autoFlush" value="true"/>
+        <property name="maxBackupIndex" value="10"/>
+        <property name="rotateSize" value="209715200"/>
+      </properties>
+    </custom-handler>
+
+More features can be seen on [logstash-jboss-logmanager readme](https://github.com/mpucholblasco/logstash-loggers/tree/master/logstash-jboss-logmanager).

From cfee76a0ad44171d638166a41b48d13c2a745aec Mon Sep 17 00:00:00 2001
From: Marcel Puchol <mpucholblasco@gmail.com>
Date: Sun, 19 Jan 2014 19:35:56 +0100
Subject: [PATCH 2/2] Modified index.md to include java-logstash-logger

---
 index.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/index.md b/index.md
index 1f940d6..b04051a 100644
--- a/index.md
+++ b/index.md
@@ -82,6 +82,11 @@ ready to spit out logstash compatible log files
 
 Have a NodeJS app? Get your logs into logstash efficiently with this cookbook.
 
+## [ Logging from Java ](recipes/java-logstash-logger/)
+
+Have a Java or Java Application Server? Get your logs using this
+cookbook.
+
 ## [ Cisco ASA ](recipes/cisco-asa/)
 
 Sample configuration for parsing syslog messages from a Cisco ASA firewall