grafana · knylander-grafana · Dec 20, 2024 · Dec 20, 2024 · Dec 20, 2024 · Dec 20, 2024
diff --git a/docs/sources/access/index.md → docs/sources/access/_index.md b/docs/sources/access/index.md → docs/sources/access/_index.md
diff --git a/docs/sources/access/profile-settings.md b/docs/sources/access/profile-settings.md
@@ -0,0 +1,53 @@
+---
+description: Configure available settings for Explore Profiles.
+keywords:
+  - pyroscope
+  - continuous profiling
+  - settings
+menuTitle: Profile settings
+title: Profile settings
+weight: 800
+aliases:
+  - /docs/grafana-cloud/monitor-applications/profiles/profile-settings/
+---
+
+# Profiles settings
+
+The **Profiles settings** page lets you modify flame graph, export, and function details options used for Profiles and [Explore Profiles]().
+
+![The Profiles Settings page](/media/docs/explore-profiles/explore-profiles-settings.png)
+
+| Features                    | Options        | Explanation                                                                                                                                                                                                                                               |
+| --------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Collapsed flame graph**   | Default: Off   | When this feature is active, you can collapse flame graphs to minimize their screen space.                                                                                                                                                                |
+| **Maximum number of nodes** | Default: 16384 | This number controls the maximum number of nodes, which controls the depth of the flame graph. The higher the number, the more nodes are used in the flame graph. The flame graphs appear longer.                                                         |
+<!-- Commenting out flamegraph.com
+| **Enable flamegraph.com**   | Default: On    | Adds a `flamegraph.com` export option to the **Export flame graph** menu. Flame graphs uploaded to `flamegraph.com` have a publicly accessible URL. Deactivate this option if data privacy is a concern.                                                  |
+-->
+| **Enable function details** | Default: On    | Enables mapping of resource usage to lines of source code. If the [GitHub integration](https://grafana.com/docs/grafana-cloud/monitor-applications/profiles/pyroscope-github-integration/) is configured, then the source code is downloaded from GitHub. |
+
+
+## Modify settings
+
+To change the settings for Explore Profiles:
+
+1. Sign in to your Grafana instance.
+1. Select **Explore** > **Profiles** in the left navigation.
+1. Select the **Settings** (gear) icon in the right corner.
+   ![Access the Settings by selecting the gear icon](/media/docs/explore-profiles/explore-profiles-settings-icon.png)
+1. Change any options as desired.
+1. Select **Save settings** to preserve the changes.
+
+<!-- Commented out -- feature disabled for now
+
+## Export flame graphs to flamegraph.com
+
+You can export flame graphs using the **Export** option on any of the flame graph views.
+
+To export a flame graph:
+
+1. View a flame graph in **Explore** > **Profiles**.
+1. Select the **Export** icon at the end of the toolbar.
+   ![Available export options for the flame graph](/media/docs/grafana-cloud/profiles/profiles-export-flamegraph.png)
+1. Choose an export option.
+1. Save the file to your system. -->
diff --git a/docs/sources/concepts/index.md → docs/sources/concepts/_index.md b/docs/sources/concepts/index.md → docs/sources/concepts/_index.md
diff --git a/docs/sources/concepts/continuous-profiling.md b/docs/sources/concepts/continuous-profiling.md
@@ -0,0 +1,20 @@
+---
+title: What is continuous profiling?
+menuTitle: Continuous profiling
+description: Discover the benefits of continuous profiling and its role in modern application performance analysis.
+weight: 200
+keywords:
+  - continuous profiling
+  - flame graphs
+refs:
+  flame-graphs:
+    - pattern: /docs/explore-profiles/
+      destination: https://grafana.com/docs/explore-profiles/<EXPLORE_PROFILES_VERSION>/concepts/flame-graphs/
+---
+
+# What is continuous profiling?
+
+[//]: # 'Shared content for the when to use continuous profiling.'
+[//]: # 'This content is located in /pyroscope/docs/sources/shared/intro/continuous-profiling.md'
+
+{{< docs/shared source="pyroscope" lookup="intro/continuous-profiling.md" version="<PYROSCOPE_VERSION>" >}}
diff --git a/docs/sources/concepts/flame-graphs.md b/docs/sources/concepts/flame-graphs.md
@@ -0,0 +1,15 @@
+---
+title: Flame graphs
+menuTitle: Flame graphs
+description: Learn about flame graphs to help visualize performance data.
+weight: 400
+keywords:
+  - Flame graphs
+---
+
+# Flame graphs
+
+[//]: # 'Shared content for intro to flame graphs.'
+[//]: # 'This content is located in /pyroscope/docs/sources/shared/intro/flame-graphs.md'
+
+{{< docs/shared source="pyroscope" lookup="intro/flame-graphs.md" version="<PYROSCOPE_VERSION>" >}}
diff --git a/docs/sources/concepts/profile-types.md b/docs/sources/concepts/profile-types.md
@@ -0,0 +1,36 @@
+---
+title: Understand profiling types and their uses in Pyroscope
+menuTitle: Understand profiling types
+description: Learn about the different profiling types available in Pyroscope and how to effectively use them in your application performance analysis.
+weight: 300
+keywords:
+  - profiles
+  - profiling types
+  - application performance
+  - flame graphs
+---
+
+# Understand profiling types and their uses in Pyroscope
+
+{{< docs/shared source="pyroscope" lookup="intro/continuous-profiling.md" version="<PYROSCOPE_VERSION>" >}}
+
+Profiling is an essential tool for understanding and optimizing application performance. In Pyroscope, various profiling types allow for an in-depth analysis of different aspects of your application. This guide explores these types and explain their impact on your program.
+
+## Profiling types
+
+In Pyroscope, profiling types refer to different dimensions of application performance analysis, focusing on specific aspects like CPU usage, memory allocation, or thread synchronization.
+
+[//]: # 'Shared content for available profile types'
+[//]: # 'This content is located in /pyroscope/docs/sources/shared/available-profile-types.md'
+
+{{< docs/shared source="pyroscope" lookup="available-profile-types.md" version="latest" >}}
+
+Refer to the Profile types tables for information on supported profile types based on instrumentation method.
+
+For information on auto-instrumentation and supported language SDKs, refer to [Configure the client](https://grafana.com/docs/pyroscope/<PYROSCOPE_VERSION>/configure-client/).
+
+<!-- Description of profiling types -->
+
+[//]: # 'Shared content for profile type explanations.'
+[//]: # 'This content is located in /pyroscope/docs/sources/shared/intro/profile-types-descriptions.md'
+
diff --git a/docs/sources/concepts/what-is-profiling.md b/docs/sources/concepts/what-is-profiling.md
@@ -0,0 +1,16 @@
+---
+title: What is profiling?
+menuTitle: What is profiling?
+description: Discover the types of profiling and how to apply each profiling method.
+weight: 100
+keywords:
+  - Pyroscope
+  - Profiling
+---
+
+# What is profiling?
+
+[//]: # 'Shared content for What is profiling?'
+[//]: # 'This content is located in /pyroscope/docs/sources/shared/intro/what-is-profiling.md'
+
+{{< docs/shared source="pyroscope" lookup="intro/what-is-profiling.md" version="<PYROSCOPE_VERSION>" >}}
diff --git a/docs/sources/investigate/index.md → docs/sources/investigate/_index.md b/docs/sources/investigate/index.md → docs/sources/investigate/_index.md
diff --git a/docs/sources/investigate/flame-graph-ai.md b/docs/sources/investigate/flame-graph-ai.md
@@ -0,0 +1,91 @@
+---
+description: Use Flame graph AI to better understand your profile data and flame graphs.
+keywords:
+  - continuous profiling
+  - flame graphs
+  - Flame graph AI
+menuTitle: Use Flame graph AI
+title: Use Flame graph AI
+weight: 100
+refs:
+  flame-graph-panel:
+    - pattern: /docs/grafana/
+      destination: /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/visualizations/flame-graph/
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/visualizations/panels-visualizations/visualizations/flame-graph/
+---
+
+# Use Flame graph AI
+
+Flame graph AI helps you understand your profiling data by using a large-language model (LLM) to assist with data interpretation.
+
+A flame graph provides a convenient way to visualize performance data.
+These graphs provide a clear, intuitive understanding of resource allocation and bottlenecks within an application.
+To learn more, refer to [Flame graph visualizations](ref:flame-graph-panel).
+
+Flame graphs and profiling data in general can help you understand:
+
+1. Performance bottlenecks: What's causing the slowdown?
+1. Root causes: Why is it happening?
+1. Recommended fixes: How would you resolve it?
+
+Flame graph AI answers these questions when explaining your flame graph.
+To learn more, refer to [AI-powered insights for continuous profiling: introducing Flame graph AI in Grafana Cloud](https://grafana.com/blog/2024/05/15/ai-powered-insights-for-continuous-profiling-introducing-flame-graph-ai-in-grafana-cloud/).
+
+![Flame graph analysis with performance bottleneck, root cause, and recommended fix](/media/docs/grafana-cloud/profiles/pyorsope-flamegraph-ai-analysis.png)
+
+## Flame graph AI compliments human interpretation
+
+Flame graph AI analyzes a flame graph and provides a plain English interpretation of the flame graph.
+
+It only takes using a flame graph successfully once to really move from the beginner to advanced interpretation.
+From a product standpoint, one challenge has been building a user-experience that can span from beginner to expert and still be useful for both.
+
+When compared to volunteers in a limited flame graph interpretation test, the Flame graph AI's interpreter scored 100%. Beginners scored 25% and flame graph experts scored 83%.
+The AI consistently outperformed beginners and advanced users, providing accurate, albeit less detailed/nuanced, interpretations than the experts.
+
+These initial results at least point towards a great opportunity in adding value to most users by incorporating AI.
+
+Refer to the [AI-powered flame graph interpreter](https://pyroscope.io/blog/ai-powered-flamegraph-interpreter/) blog post to learn more.
+
+## Explore your profile data with Flame graph AI
+
+Flame graph AI uses the LLM plugin for Grafana to provide the large-language model using OpenAI API.
+
+You can use Flame graph AI in Grafana **Explore** > **Profiles** and the Explore Profiles app, nested underneath **Explore** > **Profiles** > **Explore profiles**.
+
+### Before you begin
+
+To use Flame graph AI, you must have:
-To use Flame graph AI, you must have:
+Flame graph AI is available only when using Explore Profiles. 
+ 
+To use Flame graph AI, you must have:
-To use Flame graph AI, you must have:
+Flame graph AI is available only when using Explore Profiles. 
+ 
+To use Flame graph AI, you must have:
+
+- Configured a [Grafana Pyroscope data source](https://grafana.com/docs/grafana-cloud/connect-externally-hosted/data-sources/pyroscope/) that has profiling data
+
+- Enabled the [LLM plugin](https://grafana.com/docs/grafana-cloud/alerting-and-irm/machine-learning/configure/llm-plugin/) for your Grafana instance
+- Activated the [Explore Profiles](https://grafana.com/docs/grafana-cloud/visualizations/simplified-exploration/profiles/access/) app for your Grafana instance
+
+### Use Flame graph AI
+
+To use Flame graph AI when viewing a flame graph:
+
+1. Sign on to your Grafana Cloud account and start your Grafana instance.
+1. Select **Explore** > **Profiles** from the left navigation.
+1. Select **Flame graph** view from the **Exploration** types or select any view or service with an available flame graph. For example, from the **All services** view, select any **Flame graph** link to open the flame graph for that service.
+1. Select **Explain Flame Graph** to view the **Flame graph analysis**.
+
+### Use Flame graph AI in Diff flame graph view
+
+The **Diff flame graph** view facilitates side-by-side comparison of profiles either based on different label sets, different time periods, or both. This feature is extremely valuable for understanding the impact of changes or differences between do distinct queries of your application.
+
+The **Diff flame graph** view is an extension of **Comparison view**, crucial for more easily visually showing the differences between two profiling datasets.
+Similar to a `git diff`, the comparison takes the flame graphs from the comparison view and highlights the differences between the two flame graphs.
+
+You can use Flame graph AI to interpret the diff view.
+
+To use Flame graph AI when comparing two different flame graphs:
+
+1. Sign on to your Grafana Cloud account and start your Grafana instance.
+1. Select **Explore** > **Profiles** from the left navigation.
+1. Select a **Service**, **Profile**, and time range (optional; default value is **Last 1 hour**).
+1. Optional: In **Baseline time range**, select one or more labels to use as filters. Select **Execute**.
+1. Optional: In **Comparison time range**, select one or more labels to use as filters. Select **Execute**.
+1. Select **Explain Flame Graph**.