You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@usergrid.apache.org by to...@apache.org on 2014/09/29 22:53:05 UTC

[26/52] [abbrv] git commit: Added notes about how to setup log4j logging.

Added notes about how to setup log4j logging.


Project: http://git-wip-us.apache.org/repos/asf/incubator-usergrid/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-usergrid/commit/121fd148
Tree: http://git-wip-us.apache.org/repos/asf/incubator-usergrid/tree/121fd148
Diff: http://git-wip-us.apache.org/repos/asf/incubator-usergrid/diff/121fd148

Branch: refs/heads/eventsystem
Commit: 121fd148baf46ace3cb216e9672d33719c282eb4
Parents: 8a1daff
Author: Dave Johnson <dm...@apigee.com>
Authored: Fri Sep 26 12:35:02 2014 -0400
Committer: Dave Johnson <dm...@apigee.com>
Committed: Fri Sep 26 12:35:02 2014 -0400

----------------------------------------------------------------------
 stack/tools/README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/121fd148/stack/tools/README.md
----------------------------------------------------------------------
diff --git a/stack/tools/README.md b/stack/tools/README.md
index f8fcd71..e03fc35 100644
--- a/stack/tools/README.md
+++ b/stack/tools/README.md
@@ -47,6 +47,24 @@ What Tools are available?
 ---
 This README.md only documents two of the tools, WarehouseExport and WarehouseUpsert. You will have to seek documentation else where or look at the source code (in the org.apache.usergrid.tools package) to understand what other tools are avialable.
 
+Enabling additional logging for debugging purposes
+---
+
+If you want to control what is logged by the Usergrid Tools, you must provide your own log4j.configuration file.  When you start the tool with the java command, add the following option right after the word "java" and (of course) replace /path/to with the real path to your log4j file.
+
+    -Dlog4j.configuration=file:/path/to/log4j.properties
+
+Here is a simple log4j.properties file that will turn on DEBUG logging for the Usergrid Tools:
+
+    log4j.rootLogger=WARN,stdout
+    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
+    log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
+    log4j.appender.stdout.layout.ConversionPattern=%d %p (%t) [%c] - %m%n
+
+    log4j.category.org.apache.usergrid.tools=DEBUG
+    log4j.category.org.apache.usergrid=INFO
+    log4j.logger.org.apache.usergrid.persistence.cassandra=WARN
+
 
 Redshift Warehouse Export and Upsert
 ===