From 611dcb9d1c16702a2aabb57a287c57a0e79366d3 Mon Sep 17 00:00:00 2001
From: fjy <fangjin@metamarkets.com>
Date: Thu, 31 Jul 2014 14:47:44 -0700
Subject: [PATCH] new docs on logging

Conflicts:
	docs/content/toc.textile
---
 docs/content/Logging.md  | 39 +++++++++++++++++++++++++++++++++++++++
 docs/content/toc.textile |  4 +++-
 2 files changed, 42 insertions(+), 1 deletion(-)
 create mode 100644 docs/content/Logging.md

diff --git a/docs/content/Logging.md b/docs/content/Logging.md
new file mode 100644
index 00000000000..d949aa7858d
--- /dev/null
+++ b/docs/content/Logging.md
@@ -0,0 +1,39 @@
+---
+layout: doc_page
+---
+Logging
+==========================
+
+Druid nodes will emit logs that are useful for debugging to the console. Druid nodes also emit periodic metrics about their state. For more about metrics, see [Configuration](Configuration.html). Metric logs are printed to the console by default, and can be disabled with `-Ddruid.emitter.logging.logLevel=debug`.
+
+Druid uses [log4j](http://logging.apache.org/log4j/2.x/) for logging, and console logs can be configured by adding a log4j.xml file. Add this xml file to your classpath if you want to override default Druid log configuration.
+
+An example log4j.xml file is shown below:
+
+```
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
+
+<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
+
+  <appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
+    <layout class="org.apache.log4j.PatternLayout">
+      <param name="ConversionPattern" value="%d{ISO8601} %-5p [%t] %c - %m%n"/>
+    </layout>
+  </appender>
+
+  <!-- ServerView-related stuff is way too chatty -->
+  <logger name="io.druid.client.BatchServerInventoryView">
+    <level value="warn"/>
+  </logger>
+  <logger name="io.druid.curator.inventory.CuratorInventoryManager">
+    <level value="warn"/>
+  </logger>
+
+  <root>
+    <priority value="info" />
+    <appender-ref ref="ConsoleAppender"/>
+  </root>
+
+</log4j:configuration>
+```
\ No newline at end of file
diff --git a/docs/content/toc.textile b/docs/content/toc.textile
index 6b2fa17c216..0deb2d27bed 100644
--- a/docs/content/toc.textile
+++ b/docs/content/toc.textile
@@ -28,16 +28,18 @@ h2. Configuration
 * "Realtime":Realtime-Config.html
 
 h2. Data Ingestion
+* "Ingestion FAQ":./Ingestion-FAQ.html
 * "Realtime":./Realtime-ingestion.html
 * "Batch":./Batch-ingestion.html
 * "Indexing Service":./Indexing-Service.html
 ** "Tasks":./Tasks.html
 * "Data Formats":./Data_formats.html
-* "Ingestion FAQ":./Ingestion-FAQ.html
 
 h2. Operations
+* "Performance FAQ":./Performance-FAQ.html
 * "Extending Druid":./Modules.html
 * "Booting a Production Cluster":./Booting-a-production-cluster.html
+<<<<<<< HEAD
 * "Performance FAQ":./Performance-FAQ.html
 * "Logging":./Logging.html