Add troubleshooting doc for IISExpress Classic pipeline (#2233)

elastic · Dec 7, 2023 · 4ad83c6 · 4ad83c6
1 parent 238698f
commit 4ad83c6
Show file tree

Hide file tree

Showing 3 changed files with 19 additions and 1 deletion.
diff --git a/docs/images/classic-pipeline.png b/docs/images/classic-pipeline.png
diff --git a/docs/images/integrated-pipeline.png b/docs/images/integrated-pipeline.png
diff --git a/docs/troubleshooting.asciidoc b/docs/troubleshooting.asciidoc
@@ -244,4 +244,22 @@ The most expensive operation in the agent is typically stack trace capturing. Th
 If this is too much in your environment, consider disabling stack trace capturing either partially or entirely:
 
 - To disable stack trace capturing for spans, but continue to capture stack traces for errors, set the <<config-span-stack-trace-min-duration>> to `-1` and leave the <<config-stack-trace-limit>> on its default.
-- To disable stack trace capturing entirely –which in most applications reduces the agent overhead dramatically– set <<config-stack-trace-limit>> to `0`.
+- To disable stack trace capturing entirely –which in most applications reduces the agent overhead dramatically– set <<config-stack-trace-limit>> to `0`.
+
+[float]
+[[iisexpress-classic-pipeline]]
+=== The ElasticApmModule does not load or capture transactions and there are no agent logs generated on IISExpress 
+
+When debugging applications using Visual Studio and IISExpress, the same requirement to use the `Integrated` managed 
+pipeline mode exists. Select your web application project in the solution explorer and press F4 to load the properties
+window. If the managed pipeline mode is set to classic, the ElasticApmModule will not load.
+
+For example:
+
+image::./images/classic-pipeline.png[Classic Managed Pipeline Mode in Properties]
+
+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.