diff --git a/docs/organization/integrations/cursor/index.mdx b/docs/organization/integrations/cursor/index.mdx index bba3f80bdcde9..8ecde124e2bb6 100644 --- a/docs/organization/integrations/cursor/index.mdx +++ b/docs/organization/integrations/cursor/index.mdx @@ -7,7 +7,7 @@ description: >- og_image: /og-images/organization-integrations-cursor.png --- -You can trigger Cursor Cloud Agents from your [Seer Issue Fix](/product/ai-in-sentry/seer/issue-fix/) tab. The Cloud Agents will be provided with Seer's Root Cause Analysis alongside the issue context to help the Cloud Agent understand the issue and generate a solution. +You can trigger Cursor Cloud Agents from your [Seer Root Cause Analysis](/product/ai-in-sentry/seer/root-cause-analysis/) tab. The Cloud Agents will be provided with Seer's Root Cause Analysis alongside the issue context to help the Cloud Agent understand the issue and generate a solution. ## Install and Configure diff --git a/docs/organization/integrations/integration-platform/webhooks/seer.mdx b/docs/organization/integrations/integration-platform/webhooks/seer.mdx index 200696d5587d6..6b1eaf85672ce 100644 --- a/docs/organization/integrations/integration-platform/webhooks/seer.mdx +++ b/docs/organization/integrations/integration-platform/webhooks/seer.mdx @@ -4,7 +4,7 @@ sidebar_order: 7 description: "Learn more about Sentry's integration platform Seer webhooks for Issue Fix analysis notifications." --- -Sentry integrations that have subscribed to Seer webhooks can receive notifications about the Seer [Issue Fix](/product/ai-in-sentry/seer/issue-fix/) process. These webhooks allow you to track the progress of automated root cause analysis, solution generation, and code fixes. +Sentry integrations that have subscribed to Seer webhooks can receive notifications about the Seer [Root Cause Analysis](/product/ai-in-sentry/seer/root-cause-analysis/) process. These webhooks allow you to track the progress of automated root cause analysis, solution generation, and code fixes. ## Sentry-Hook-Resource Header diff --git a/docs/organization/integrations/source-code-mgmt/github/index.mdx b/docs/organization/integrations/source-code-mgmt/github/index.mdx index 6098dcd0362ab..4a6285cab04bb 100644 --- a/docs/organization/integrations/source-code-mgmt/github/index.mdx +++ b/docs/organization/integrations/source-code-mgmt/github/index.mdx @@ -233,13 +233,13 @@ The [Seer GitHub App](https://github.com/apps/seer-by-sentry) is used by [Seer]( To install the Seer GitHub App, simply follow the installation steps to install the GitHub App for the specified organization/repositories you need. You can find the Seer GitHub App [here](https://github.com/apps/seer-by-sentry). -For [Issue Fix](/product/ai-in-sentry/seer#issue-fix), you will now be able to create pull requests in the installed locations. +For [Root Cause Analysis](/product/ai-in-sentry/seer#root-cause-analysis), you will now be able to create pull requests in the installed locations. ## Configure GitHub Integration Use GitHub to [track commits](#commit-tracking), identify [suspect commits](#suspect-commits-and-suggested-assignees), [resolve via commit or PR](#resolve-via-commit-or-pull-request), [manage issues](#issue-management), and use AI for code review. -To enable [AI Code Review](/product/ai-in-sentry/ai-code-review), turn on the `Show Generative AI Features` and `Enable AI Code Review` settings in your [organization settings](https://sentry.io/orgredirect/settings/:orgslug/). +To enable [AI Code Review](/product/ai-in-sentry/seer/ai-code-review), turn on the `Show Generative AI Features` and `Enable AI Code Review` settings in your [organization settings](https://sentry.io/orgredirect/settings/:orgslug/). ### Commit Tracking diff --git a/docs/pricing/quotas/manage-seer-budget.mdx b/docs/pricing/quotas/manage-seer-budget.mdx index d41947cfc4dcf..029a4798d9288 100644 --- a/docs/pricing/quotas/manage-seer-budget.mdx +++ b/docs/pricing/quotas/manage-seer-budget.mdx @@ -22,7 +22,7 @@ og_image: /og-images/pricing-quotas-manage-seer-budget.png - **Issue Scan**: An analysis of an issue to help determine fixability. These scans are run automatically for every new error and performance issue. -- [**Issue Fix**](/product/ai-in-sentry/seer/issue-fix/): A root cause and solution generated for an issue. You will only be charged one fix per issue, however if you "Start Over" your fix, this will count as a new fix and will be charged accordingly. +- [**Issue Fix**](/product/ai-in-sentry/seer/root-cause-analysis/): A root cause and solution generated for an issue. You will only be charged one fix per issue, however if you "Start Over" your fix, this will count as a new fix and will be charged accordingly. - [**Seer Automation**](/product/ai-in-sentry/seer/#automation): Settings that combine issue scans and fixes into a powerful workflow: identifying actionable issues in real time and generating high quality fixes automatically. These options help manage Seer and PAYG spend by letting you choose when to run scans, which issues trigger fixes, and how far fixes progress (from root cause analysis to opening a pull request). diff --git a/docs/product/ai-in-sentry/index.mdx b/docs/product/ai-in-sentry/index.mdx index 9bf6589a1f7be..786beea278ac0 100644 --- a/docs/product/ai-in-sentry/index.mdx +++ b/docs/product/ai-in-sentry/index.mdx @@ -4,29 +4,31 @@ sidebar_order: 25 description: "Learn about Sentry's AI-powered features that help you analyze and debug your code faster." --- -Sentry leverages artificial intelligence (AI) and machine learning (ML) to enhance your debugging and monitoring experience. Our AI-powered features help you understand issues faster, get automated fixes, and gain deeper insights into your application's behavior. +Sentry leverages artificial intelligence (AI) and machine learning (ML) to enhance your debugging and monitoring experience. Our AI-powered features help you understand issues faster, get automated fixes, and gain deeper insights into your application's behavior. ## AI-Powered Features ### Seer -[Seer](/product/ai-in-sentry/seer/) is Sentry's AI debugging agent that helps resolve errors and performance issues in your applications. Seer combines issue detection, analysis, and automated fixing capabilities to streamline your debugging workflow. +[Seer](/product/ai-in-sentry/seer/) is Sentry's AI debugging agent that helps resolve errors and performance issues in your applications. Seer combines issue detection, analysis, and automated fixing capabilities to streamline your debugging workflow. Seer is an [add-on](/pricing/#seer-pricing) to your Sentry subscription. -- **[Issue Fix](/product/ai-in-sentry/seer/issue-fix/)**: Automated root cause analysis and suggested code fixes, for errors and performance issues. -- **Issue Scan**: Scans issues as they are ingested in Sentry to determine an actionability score and run Seer's issue fix on them automatically. +Use Seer to: + +- **[Review Code Changes](/product/ai-in-sentry/seer/ai-code-review/)**: Have Seer review your code changes in GitHub, catching bugs before merging pull requests. +- **[Fix Issues](/product/ai-in-sentry/seer/root-cause-analysis/)**: Run automated root cause analysis and generate suggested code fixes for errors and performance issues. ### Issue Summary **Issue summary** provides a quick overview of an issue by highlighting key insights taken from event and issue-level metadata. You'll see a quick overview of what's going wrong, a potential cause, and if relevant, insights from trace-connected issues. -### AI Code Review - -[AI Code Review](/product/ai-in-sentry/sentry-prevent-ai/) helps you generate new tests for uncovered code and reviews your code changes, offering suggestions for improvement before merging pull requests. Currently available only on Github - ### Query Assistant You can ask Seer to query your traces and spans data via natural language queries and find relevant samples of compute metrics without building the whole query manually +### AI Summaries + +See a summary of [User Feedback](/product/user-feedback/) and [Session Replays](/product/explore/session-replay/) to identify common issues and patterns. + ## Privacy and security Sentry includes strong guarantees for privacy and security of your data. At a glance: diff --git a/docs/product/ai-in-sentry/ai-code-review/img/prevent-ai-response.png b/docs/product/ai-in-sentry/seer/ai-code-review/img/prevent-ai-response.png similarity index 100% rename from docs/product/ai-in-sentry/ai-code-review/img/prevent-ai-response.png rename to docs/product/ai-in-sentry/seer/ai-code-review/img/prevent-ai-response.png diff --git a/docs/product/ai-in-sentry/ai-code-review/index.mdx b/docs/product/ai-in-sentry/seer/ai-code-review/index.mdx similarity index 100% rename from docs/product/ai-in-sentry/ai-code-review/index.mdx rename to docs/product/ai-in-sentry/seer/ai-code-review/index.mdx diff --git a/docs/product/ai-in-sentry/seer/index.mdx b/docs/product/ai-in-sentry/seer/index.mdx index ae3acc31eea4a..97f2d3148733d 100644 --- a/docs/product/ai-in-sentry/seer/index.mdx +++ b/docs/product/ai-in-sentry/seer/index.mdx @@ -8,41 +8,36 @@ Seer is Sentry's AI debugging agent. It uses Sentry's rich context (issue detail ## Seer Capabilities -Seer provides three main capabilities to enhance your debugging: +Seer provides end-to-end debuggingtools to help you troubleshoot and fix errors and performance issues faster, or even before they are merged: -- [**Issue fix**](#issue-fix): A collaborative agent skilled at root cause analysis and solving issues -- [**Issue scan**](#issue-scan): Automatically scans issues as they come in, feeding additional context to your alerts and automating triage -- [**Automation**](#automation): Combines issue fix and scan into a powerful workflow: identifying actionable issues in real time and generating high quality fixes, automatically +- [**AI Code Review**](#ai-code-review): Have Seer review your code changes in GitHub, catching bugs before merging pull requests. +- [**Root Cause Analysis**](#root-cause-analysis): Automatically scans issues as they come in, feeding additional context to your alerts and automating triage +- [**PR Creation**](#pr-creation): A collaborative agent skilled at root cause analysis and solving issues +- [**Delegate to Background Agents**](#background-agents): Send Seer's analysis to Cursor's background agent to debug directly in your IDE -### Issue Fix +### AI Code Review -Seer combines all of the relevant context from your code with Sentry's telemetry data to provide a best-in-class issue debugging experience. The workflow consists of three steps: +[AI Code Review](/product/ai-in-sentry/seer/ai-code-review/) helps you reviews your code changes, predicting errors and offering suggestions for improvement before merging pull requests. This feature is only available on GitHub. -1. Root cause the issue using Sentry's context and your codebase -2. Identify a solution based on the analysis -3. Generate a code patch that implements the solution and open a PR +### Root Cause Analysis -For a full product walk-through, see [issue fix](./issue-fix/). +Seer is able to automatically analyze issues as they are ingested by Sentry by combining all of the relevant context from your code with Sentry's telemetry data to provide a best-in-class issue debugging experience. This initial review is used to: - - -### Issue Scan - -Seer is able to automatically analyze issues as they are ingested by Sentry. This initial review is used to: - -- Generate an "actionability" score, which indicates how likely it is that a particular issue can be fixed with a code change +- Determine if the issue can be automatically analyzed and fixed using Seer's Root Cause Analysis - Augment issue alerts with a helpful analysis about the problem - Add an initial guess for what the potential problem is to the issue details page -The actionability score is represented in the issue feed by a Seer icon, which indicate issues that are likely straightforward fixes. +Once the Root Cause Analysis has run, Seer will provide remediatiion recommendations. + + + +### PR Creation -### Automation +You can prompt Seer to generate PRs to fix your issue, and push it to GitHub. You can add more context in natural language, or any external supporting information, to help Seer generate a better PR. **Note:** You must install the [Seer GitHub app](/organization/integrations/source-code-mgmt/github/#installing-the-seer-github-app) to use this feature. -You can use automation to trigger issue scans and fixes. There are three automation settings you can configure: +### Background Agents -1. **Automate Issue Scans**: This enables Seer's issue scan functionality -2. **Automate Issue Fixes**: This allows you to customize the degree of automation employed by Seer. For example, setting it to "Highly Actionable and Above" will automatically trigger issue fixes for all of your highly actionable Issues. -3. **Stopping Point for Automatic Fixes**: Seer allows you to customize how far to go with automation. By default, it stops at the solution step, but you can choose to have it go all the way to code changes or even generate PRs automatically. +You can send Seer's root cause analysis to Cursor for further debugging directly in your IDE. ## What Seer Uses @@ -59,17 +54,17 @@ Seer is a powerful debugging agent, with access to a wide variety of data source To start using Seer's capabilities in your Sentry-enabled projects, follow these steps: -1. **Enable generative AI features**: Make sure "Show Generative AI Features" is enabled in your [organization settings](https://sentry.io/orgredirect/organizations/:orgslug/settings/#hideAiFeatures) -2. **Set up GitHub Integration**: For issue fix capabilities, [connect your GitHub repositories](/organization/integrations/source-code-mgmt/github/). - - *Optional:* To make Pull Requests with Seer, [configure the Seer GitHub App](/organization/integrations/source-code-mgmt/github/#installing-the-seer-github-app). -3. **Configure Settings**: Customize Seer's behavior in your project settings under `Seer Automation`. Seer is enabled by default using these settings: - - **Automatic issue scans**: Enabled - - **Automatic issue fixes**: Enabled for highly actionable issues and above +1. Connect to GitHub through the [Sentry GitHub integration](/organization/integrations/source-code-mgmt/github/). You can follow the steps in [Seer settings](https://sentry.io/settings/seer/) to get started. **Note:** Seer can only be integrated with the cloud version of GitHub + +2. Select which repositories you want Seer to have access to + +3. Select which features to turn on - AI Code Review, Root Cause Analysis, PR generation of fixes - > **Note**: You can monitor your Seer usage in the [Stats & Usage tab](https://sentry.io/settings/stats/) and can learn more about managing your Seer budget [here](/pricing/quotas/manage-seer-budget/). -4. **Start Using**: Look for Seer options in your issue details pages + -You can also use Seer for [AI code reviews](/product/ai-in-sentry/ai-code-review) by enabling the [GitHub integration](/organization/integrations/source-code-mgmt/github/) and turning on the `Enable AI Code Review` setting in your [organization settings](https://sentry.io/orgredirect/settings/:orgslug/). +Seer is an add-on to your Sentry subscription. By enabling it, you are signing up for seat-based pricing for this feature. Any person who creates 2 or more PRs in a month in a Seer-enabled project will be billed. You can learn more about Seer pricing [here](/pricing/#seer-pricing). + + ## Privacy and security @@ -79,3 +74,7 @@ Sentry includes strong guarantees for privacy and security of your data. At a gl - AI-generated output is shown only to you and other authorized users in your account. You can learn more about our data privacy practices [in the security and legal docs](/security-legal-pii/security/ai-ml-policy/#use-of-identifying-data-for-generative-ai-features). + +## Turn Seer Off or On Globally + +You can turn Seer off or on globally by going to [Seer settings](https://sentry.io/settings/seer/) and selecting from the dropdown at the top of the table in each tab. diff --git a/docs/product/ai-in-sentry/seer/issue-fix/index.mdx b/docs/product/ai-in-sentry/seer/root-cause-analysis/index.mdx similarity index 61% rename from docs/product/ai-in-sentry/seer/issue-fix/index.mdx rename to docs/product/ai-in-sentry/seer/root-cause-analysis/index.mdx index 380b1a01c6fc2..2da72e0c0ba96 100644 --- a/docs/product/ai-in-sentry/seer/issue-fix/index.mdx +++ b/docs/product/ai-in-sentry/seer/root-cause-analysis/index.mdx @@ -1,35 +1,27 @@ --- -title: Issue Fix +title: Root Cause Analysis description: >- - Use Seer's issue fix to automatically find the root cause of issues and + Use Seer's Root Cause Analysis to automatically find the root cause of issues and generate code fixes. sidebar_order: 20 og_image: /og-images/product-ai-in-sentry-seer-issue-fix.png --- -**Issue fix** is Seer's collaborative workflow to find the root cause of and solution to issues. It uses Sentry's context (issue details, tracing data, logs, and profiles), your codebases (integrated through GitHub), and its interactions with you to identify and reason through problems in your code. +**Root Cause Analysis** is Seer's collaborative workflow to find the root cause of and solution to issues. It uses Sentry's context (issue details, tracing data, logs, and profiles), your codebases (integrated through GitHub), and its interactions with you to identify and reason through problems in your code. -Issue fix can be automated, allowing it to populate root cause analysis, solutions, and even pull requests as issues occur. +## How Root Cause Analysis Works - -Issue fix builds upon the capabilities previously known as Autofix. - - -## How Issue Fix Works +Seer's Root Cause Analysis flow follows a three step process: -Seer's issue fix flow follows a three step process: - -1. [Root Cause Analysis](#root-cause-analysis): Analyze the issue using Sentry's context and your codebases and determine the root cause +1. [Issue Fix](#issue-fix): Analyze the issue using Sentry's context and your codebases and determine the root cause 2. [Solution Identification](#solution-identification): Identify a solution based on the analysis -3. [Code Generation](#code-generation): Generate a code fix and open a PR - -When you begin debugging an issue with Seer, you will see a screen like this, which includes the high-level issue summary and a button to start the issue fix flow: +3. [Code Generation](#code-generation): Generate a code fix and (optionally) open a PR -![Issue Fix Start Screen](../img/issue-fix-start-screen.png) +Issues where a solution has high confidence for a fix will automatically run Seer's Root Cause Analysis flow. You can also manually trigger it from the Issue Details page. -### Root Cause Analysis +### Issue Fix -Seer will then analyze the issue and relevant code to help identify the root cause and propose a solution. You'll see a live stream of Seer's thought process in real time as it works through the problem. Seer will share key insights as they come up and you'll have the option to expand each. You'll see the event data and code that support Seer's conclusions, building a clear chain of reasoning back to the root cause. +Once Root Cause Analysis has been triggered, Seer will review the issue and relevant code to help identify the root cause and propose a solution. You'll see a live stream of Seer's thought process in real time as it works through the problem. Seer will share key insights as they come up and you'll have the option to expand each. You'll see the event data and code that support Seer's conclusions, building a clear chain of reasoning back to the root cause. While Seer is reasoning through your problem, you can step in to add context or feedback; collaboration tends to lead to the best results. If Seer encounters gaps in its understanding, it will ask for your input. @@ -50,13 +42,13 @@ Once you are ready to proceed, you can select "Code It Up" to generate code reso ### Code Generation -During the coding step, Seer will identify the code patch(or patches) needed to implement the solution. When it's done, you'll see a preview showing the suggested diffs across your codebase. If the fix involves service dependencies, you may see edits spanning across multiple repositories. +During the coding step, Seer will identify the code patch (or patches) needed to implement the solution. When it's done, you'll see a preview showing the suggested diffs across your codebase. If the fix involves service dependencies, you may see edits spanning across multiple repositories. From here, you can choose to draft a PR, or checkout the code changes locally for further iteration. If you choose to checkout the code locally, Seer will make a new branch for you. ![Screenshot of Seer showing code it generated](../img/coding-step.png) -## What Issue Fix Uses +## What Root Cause Analysis Uses Seer is a powerful debugging agent, with access to a wide variety of data sources and tools. While debugging issues, it may examine: @@ -71,7 +63,7 @@ This context is crucial to Seer's capabilities, and it allows it to do things li ## Settings -Issue fix's default behavior can be customized in several ways: +Root Cause Analysis's default behavior can be customized in several ways: 1. You can manually customize the repositories it has access to 2. You can define the default branch it should use in each repository @@ -85,11 +77,9 @@ Seer already automatically parses rules files from [Cursor](https://docs.cursor. ## Best Practices -- Setup the GitHub integration, allowing Seer access to your codebase and enabling it to generate code fixes. Enabling the GitHub integration will help Seer to provide better results. See the [Sentry GitHub integration](/organization/integrations/source-code-mgmt/github/) to learn how. -- Setup the Seer GitHub integration, so Seer can create PRs for you. - The more Sentry context you have, the better equipped Seer will be to help: consider instrumenting your application to collect traces, profiles and logs, and send them to Sentry. - For JavaScript / TypeScript projects that are minified in production, upload [source maps](/platforms/javascript/sourcemaps/) to Sentry for the best results -Currently, GitHub is the only SCM supported by Seer. We are currently working to add support for other services including GitLab and Bitbucket. +Currently, the cloud version of GitHub is the only SCM supported by Seer. diff --git a/docs/product/issues/issue-details/performance-issues/web-vitals/index.mdx b/docs/product/issues/issue-details/performance-issues/web-vitals/index.mdx index 458289dbd410c..3977f24470373 100644 --- a/docs/product/issues/issue-details/performance-issues/web-vitals/index.mdx +++ b/docs/product/issues/issue-details/performance-issues/web-vitals/index.mdx @@ -39,7 +39,7 @@ to get an understanding of what pages will trigger the Web Vitals performance is ## How to Fix Web Vitals Issues -We highly recommend using [Seer's Issue Fix](/product/ai-in-sentry/seer/#issue-fix) functionality to diagnose and fix the Web Vitals Issues we've opened. Alternatively, there is lots of great documentation online about how to improve specific web vitals metrics, see: +We highly recommend using [Seer's Root Cause Analysis](/product/ai-in-sentry/seer/#root-cause-analysis) functionality to diagnose and fix the Web Vitals Issues we've opened. Alternatively, there is lots of great documentation online about how to improve specific web vitals metrics, see: * [Optimize Largest Contentful Paint](https://web.dev/articles/optimize-lcp). * [Optimize Cumulative Layout Shift](https://web.dev/articles/optimize-cls). diff --git a/redirects.js b/redirects.js index b3cd02572d8eb..cc464b6120c50 100644 --- a/redirects.js +++ b/redirects.js @@ -280,7 +280,7 @@ const userDocsRedirects = [ }, { source: '/product/ai-in-sentry/sentry-prevent-ai/:path*', - destination: '/product/ai-in-sentry/ai-code-review/:path*', + destination: '/product/ai-in-sentry/seer/ai-code-review/:path*', }, { @@ -1257,6 +1257,10 @@ const userDocsRedirects = [ source: '/product/ai-in-sentry/seer/seer-privacy-and-security', destination: '/product/ai-in-sentry/ai-privacy-and-security/', }, + { + source: '/product/ai-in-sentry/seer/issue-fix/:path*', + destination: '/product/ai-in-sentry/seer/root-cause-analysis/:path*', + }, // .NET profiling guide redirects - consolidate to main profiling page { source: '/platforms/dotnet/guides/uwp/profiling/:path*',