Merge pull request #10471 from mistymadonna/flame-graph

New Flame graph doc

Author: 19BMG00

docs/profiling/flame-graph.md

@@ -0,0 +1,51 @@
+---
+title: Identify hot paths with the Flame Graph
+description: Find hot paths in your code with a visualized overview
+ms.date: 09/30/2022
+ms.topic: how-to
+ms.assetid: 7501a20d-04a1-480f-a69c-201524aa709d
+author: mikejo5000
+ms.author: mikejo
+manager: jmartens
+ms.technology: vs-ide-debug
+monikerRange: '>= vs-2022'
+ms.workload: 
+  - multiple
+---
+# Identify hot paths with a visualized call tree
+
+Flame graphs are a visualization of categorized data, created to visualize stack traces of profiled software so that the most frequent code paths can be identified quickly and accurately.
+
+The **Flame Graph** helps you identify hot paths in your code by visualizing a call tree. The graph gives a visual overview of where time is being spent in your application and you can click on specific nodes to dig into them further.
+
+![Screenshot showing Flame Graph with tooltips displayed.](./media/vs-2022/flame-graph-tooltips.png "Flame Graph with tooltips displayed")
+
+## Investigate hot paths
+
+1. The Flame Graph view is in the CPU tool details tool window, above the source line highlighting view. After you've stopped your profiling session, you can view the Flame Graph by clicking **Open details**.
+
+   ![Screenshot showing Open details selected.](./media/vs-2022/flame-graph-open-details.png "Open details view selected")
+
+1. Select **Flame Graph** in the Current View dropdown selection.
+
+   ![Screenshot showing Flame Graph view selected.](./media/vs-2022/flame-graph-view.png "Flame Graph view selected")
+
+   ![Screenshot showing Flame Graph overview displayed.](./media/vs-2022/flame-graph-overview.png "Flame Graph overview displayed")
+
+1. By default, the flame graph in the CPU tool is shown upside down or as an "icicle chart," where the y-axis is counting stack depth downwards from zero at the top. You can view the standard flame chart layout by clicking **Flip Flame Graph**.
+
+   ![Screenshot showing Flip Flame Graph selected.](./media/vs-2022/flame-graph-flip.png "Flip Flame Graph selected")
+
+## Navigation
+In the Flame Graph view, you can navigate by clicking on a node with a mouse or using the keyboard.
+
+|Keyboard shortcut|Command|
+|-|-|
+|Tab|Go to any node|
+|Up/Down arrow|Go to a node's parent or child|
+|Enter|Zoom in|
+|Escape|Zoom out|
+
+## See also
+- [Diagnose high latency with CPU Insights](../profiling/cpu-insights.md)
+- [Analyze CPU usage without debugging](../profiling/cpu-usage.md)

docs/profiling/media/vs-2022/flame-graph-flip.png

@@ -52,6 +52,9 @@ Tools available in the Diagnostic Tools window or during a debugging session inc
 - [Memory usage](../profiling/memory-usage.md)
 - [PerfTips](../profiling/perftips.md)
 
+> [!TIP]
+> Use relaunch to skip the launch page and automatically run with your previous settings by pressing **Alt+F2** or by clicking **Debug > Performance Profiler**.
+
 > [!NOTE]
 > Windows 8 and later is required to run profiling tools with the debugger (**Diagnostic Tools** window). You can use the [post-mortem](#post_mortem) tools with Windows 7 and later. 
 

docs/profiling/media/vs-2022/flame-graph-open-details.png

@@ -49,6 +49,9 @@ When you start debugging in Visual Studio by selecting **Debug** > **Start Debug
 
 The diagnostic session ends when you stop debugging.
 
+>[!NOTE]
+>Use relaunch to skip the launch page and automatically run with your previous settings with **Alt+F2** or by clicking **Debug > Performance Profiler**.
+
 For more information, see:
 
 - [Measure application performance by analyzing CPU usage](../profiling/beginners-guide-to-performance-profiling.md)

docs/profiling/media/vs-2022/flame-graph-overview.png

@@ -33,17 +33,21 @@
   - name: Events Viewer
     href: events-viewer.md
   - name: CPU Usage
-    href: cpu-usage.md
-  - name: CPU Insights
     items:
-    - name: CPU Insights  
-      href: cpu-insights.md
-    - name: Performance insights
+    - name: CPU Usage
+      href: cpu-usage.md
+    - name: Flame Graph 
+      href: flame-graph.md
+    - name: CPU Insights
       items:
-      - name: String concatenation
-        href: perf-insights-string-concatenation.md
-      - name: Regex
-        href: perf-insights-regex.md
+      - name: CPU Insights  
+        href: cpu-insights.md
+      - name: Performance insights
+        items:
+        - name: String concatenation
+          href: perf-insights-string-concatenation.md
+        - name: Regex
+          href: perf-insights-regex.md
   - name: File IO
     href: use-file-io.md
   - name: Memory usage