Merge pull request #43928 from trask/logging-threshold-configuration

Cover Java agent logging threshold configuration

Author: American-Dipper

articles/azure-monitor/app/java-trace-logs.md

@@ -18,28 +18,41 @@ If you're using Logback or Log4J (v1.2 or v2.0) for tracing, you can have your t
 
 ## Using the Application Insights Java agent
 
-You can configure the Application Insights Java agent to automatically capture your logs,
-by enabling the feature in the `AI-Agent.xml` file:
+By default, the Application Insights Java agent automatically captures logging performed at `WARN` level and above.
+
+You can change the threshold of logging that is captured using the `AI-Agent.xml` file:
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<ApplicationInsightsAgent>
+   <Instrumentation>
+      <BuiltIn>
+         <Logging threshold="info"/>
+      </BuiltIn>
+   </Instrumentation>
+</ApplicationInsightsAgent>
+```
+
+You can disable the Java agent's logging capture using the `AI-Agent.xml` file:
 
 ```xml
 <?xml version="1.0" encoding="utf-8"?>
 <ApplicationInsightsAgent>
    <Instrumentation>
-      <BuiltIn enabled="true">
-         <Logging enabled="true" />
+      <BuiltIn>
+         <Logging enabled="false"/>
       </BuiltIn>
    </Instrumentation>
-   <AgentLogger />
 </ApplicationInsightsAgent>
 ```
 
-Alternatively, you can follow the instructions below.
+## Alternatively (as opposed to using the Java agent), you can follow the instructions below
 
-## Install the Java SDK
+### Install the Java SDK
 
 Follow the instructions to install [Application Insights SDK for Java][java], if you haven't already done that.
 
-## Add logging libraries to your project
+### Add logging libraries to your project
 *Choose the appropriate way for your project.*
 
 #### If you're using Maven...
@@ -120,7 +133,7 @@ Follow the guidelines to manually install Application Insights Java SDK, downloa
 | Log4j v1.2 |[Log4J v1.2 appender Jar](https://search.maven.org/#search%7Cga%7C1%7Ca%3A%22applicationinsights-logging-log4j1_2%22) |applicationinsights-logging-log4j1_2 |
 
 
-## Add the appender to your logging framework
+### Add the appender to your logging framework
 To start getting traces, merge the relevant snippet of code to the Log4J or Logback configuration file: 
 
 *Logback*