Merge pull request #277440 from trask/ingestion-sampling-disabled

Document how to disable ingestion sampling

Author: prmerger-automator[bot]

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

@@ -430,6 +430,27 @@ Starting from verion 3.3.1, you can capture spans for a method in your applicati
 }
 ```
 
+## Locally disabling ingestion sampling (preview)
+
+By default, when the effective sampling percentage in the Java agent is 100%
+and [ingestion sampling](./sampling-classic-api.md#ingestion-sampling) has been configured,
+then the ingestion sampling percentage will be applied.
+
+Note that this behavior applies to both fixed-rate sampling of 100% and also applies to rate-limited sampling when the
+request rate doesn't exceed the rate limit (effectively capturing 100% during the continuously sliding time window).
+
+To manually disable ingestion sampling (and keep 100% of telemetry in these cases even when ingestion sampling has been configured):
+
+```json
+{
+  "preview": {
+    "sampling": {
+      "ingestionSamplingEnabled": false
+    }
+  }
+}
+```
+
 ## Autocollected logging
 
 Log4j, Logback, JBoss Logging, and java.util.logging are autoinstrumented. Logging performed via these logging frameworks is autocollected.