[DOCS] Troubleshooting for ASE (#2473) (#2517)

PR #2473 was merged into 1.x rather than main in error. This syncs the changes back to main. Co-authored-by: Luca Belluccini <[email protected]>
elastic · Dec 2, 2024 · def884a · def884a
1 parent aa8e3ba
commit def884a
Showing 1 changed file with 12 additions and 1 deletion.
diff --git a/docs/troubleshooting.asciidoc b/docs/troubleshooting.asciidoc
@@ -283,4 +283,15 @@ Should be changed to:
 
 image::./images/integrated-pipeline.png[Integrated Managed Pipeline Mode in Properties]
 
-You may need to restart Visual Studio for these changes to fully apply.
+You may need to restart Visual Studio for these changes to fully apply.
+
+[float]
+[[azure-app-services-traceparent]]
+=== Azure App Services / ASE and sampling
+
+Azure/ASE adds trace headers set to unsampled for incoming requests to the cluster.
+
+Elastic APM .NET Agent (and likely also other agents which correctly handle the W3C Trace Parent header sampling) will obey to the traceparent header sampling of the incoming request.
+As a consequence, the traces/spans will not be sent to APM Server/Integration and therefore APM UI will not show anything.
+
+We recommend using `trace_continuation_strategy` set to `restart` or `restart_external`, so that the APM .NET Agent will ignore the incoming traceparent header sampling flag.