Merge pull request #185085 from trask/application-insights-3.2.5-BETA-updates

Add new config options for Application Insights Java 3.2.5-BETA

Author: PRMerger12

articles/azure-monitor/app/java-standalone-config.md

@@ -312,6 +312,64 @@ To disable auto-collection of Micrometer metrics (including Spring Boot Actuator
 }
 ```
 
+## HTTP headers
+
+Starting from 3.2.5-BETA, you can capture request and response headers on your server (request) telemetry:
+
+```json
+{
+  "preview": {
+    "captureHttpServerHeaders": {
+      "requestHeaders": [
+        "My-Header-A"
+      ],
+      "responseHeaders": [
+        "My-Header-B"
+      ]
+    }
+  }
+}
+```
+
+The header names are case-insensitive.
+
+The examples above will be captured under property names `http.request.header.my_header_a` and
+`http.response.header.my_header_b`.
+
+Similarly, you can capture request and response headers on your client (dependency) telemetry:
+
+```json
+{
+  "preview": {
+    "captureHttpClientHeaders": {
+      "requestHeaders": [
+        "My-Header-C"
+      ],
+      "responseHeaders": [
+        "My-Header-D"
+      ]
+    }
+  }
+}
+```
+
+Again, the header names are case-insensitive, and the examples above will be captured under property names
+`http.request.header.my_header_c` and `http.response.header.my_header_d`.
+
+## Http server 4xx response codes
+
+By default, http server requests that result in 4xx response codes are captured as errors.
+
+Starting from version 3.2.5-BETA, you can change this behavior to capture them as success if you prefer:
+
+```json
+{
+  "preview": {
+    "captureHttpServer4xxAsError": false
+  }
+}
+```
+
 ## Suppressing specific auto-collected telemetry
 
 Starting from version 3.0.3, specific auto-collected telemetry can be suppressed using these configuration options:
@@ -467,6 +525,10 @@ you can configure Application Insights Java 3.x to use an HTTP proxy:
 Application Insights Java 3.x also respects the global `https.proxyHost` and `https.proxyPort` system properties
 if those are set (and `http.nonProxyHosts` if needed).
 
+Starting from 3.2.5-BETA, authenticated proxies are supported. You can add `"user"` and `"password"` under `"proxy"` in
+the json above (or if you are using the system properties above, you can add `https.proxyUser` and `https.proxyPassword`
+system properties).
+
 ## Self-diagnostics
 
 "Self-diagnostics" refers to internal logging from Application Insights Java 3.x.