diff --git a/docs/organization/integrations/index.mdx b/docs/organization/integrations/index.mdx index 4f56ee69c7ec9..fd8b988a6ad05 100644 --- a/docs/organization/integrations/index.mdx +++ b/docs/organization/integrations/index.mdx @@ -47,29 +47,30 @@ For more details, see the [full Integration Platform documentation](/organizatio ## Issue Tracking -| Integration | Issue Creation/Linking | Automatic Issue Creation | Issue Sync | -| --------------------------------------------------------------------------------- | ---------------------- | ------------------------ | ---------- | -| [Asana (Legacy)](/organization/integrations/issue-tracking/asana/) | X | | -| [Azure DevOps (Work Items)](/organization/integrations/source-code-mgmt/azure-devops/) | X | X | X | -| [Bitbucket (Issues)](/organization/integrations/source-code-mgmt/bitbucket/) | X | | -| [ClickUp](/organization/integrations/issue-tracking/clickup/) | X | | -| [Factory](/organization/integrations/issue-tracking/factory/) | X | | -| [GitHub (Issues)](/organization/integrations/source-code-mgmt/github/) | X | | -| [GitLab (Issues)](/organization/integrations/source-code-mgmt/gitlab/) | X | | -| [Goast.ai](/organization/integrations/issue-tracking/goast/) | X | | -| [Height](/organization/integrations/issue-tracking/height/) | X | X | X | -| [Incident.io](/organization/integrations/issue-tracking/incidentio/) | X | | X | -| [Jira/Jira Server](/organization/integrations/issue-tracking/jira/) | X | X\* | X | -| [Kitemaker](/organization/integrations/issue-tracking/kitemaker/) | X | | X | -| [Linear](/organization/integrations/issue-tracking/linear/) | X | X | -| Pivotal Tracker (Legacy) | X | | -| Redmine (Legacy) | X | | -| [Shortcut](/organization/integrations/issue-tracking/shortcut/) | X | | -| [Sourcegraph](/organization/integrations/issue-tracking/sourcegraph/) | X | | -| [StarSling](/organization/integrations/issue-tracking/starsling/) | | X | -| [Teamcamp](/organization/integrations/issue-tracking/teamcamp/) | X | | -| [Teamwork](/organization/integrations/issue-tracking/teamwork/) | X | | -| Trello (Legacy) | X | | +| Integration | Issue Creation/Linking | Automatic Issue Creation | Issue Sync | Seer | +| --------------------------------------------------------------------------------- | ---------------------- | ------------------------ | ---------- | ---- | +| [Asana (Legacy)](/organization/integrations/issue-tracking/asana/) | X | | | | +| [Azure DevOps (Work Items)](/organization/integrations/source-code-mgmt/azure-devops/) | X | X | X | | +| [Bitbucket (Issues)](/organization/integrations/source-code-mgmt/bitbucket/) | X | | | | +| [ClickUp](/organization/integrations/issue-tracking/clickup/) | X | | | | +| [Factory](/organization/integrations/issue-tracking/factory/) | X | | | | +| [GitHub (Issues)](/organization/integrations/source-code-mgmt/github/) | X | | | | +| [GitLab (Issues)](/organization/integrations/source-code-mgmt/gitlab/) | X | | | | +| [Goast.ai](/organization/integrations/issue-tracking/goast/) | X | | | | +| [Height](/organization/integrations/issue-tracking/height/) | X | X | X | | +| [Incident.io](/organization/integrations/issue-tracking/incidentio/) | X | | X | | +| [Jira/Jira Server](/organization/integrations/issue-tracking/jira/) | X | X\* | X | | +| [Kitemaker](/organization/integrations/issue-tracking/kitemaker/) | X | | X | | +| [Linear](/organization/integrations/issue-tracking/linear/) | X | X | | | +| [Linear (Sentry Agent)](/organization/integrations/issue-tracking/sentry-linear-agent/)| | | | X | +| Pivotal Tracker (Legacy) | X | | | | +| Redmine (Legacy) | X | | | | +| [Shortcut](/organization/integrations/issue-tracking/shortcut/) | X | | | | +| [Sourcegraph](/organization/integrations/issue-tracking/sourcegraph/) | X | | | | +| [StarSling](/organization/integrations/issue-tracking/starsling/) | | X | | | +| [Teamcamp](/organization/integrations/issue-tracking/teamcamp/) | X | | | | +| [Teamwork](/organization/integrations/issue-tracking/teamwork/) | X | | | | +| Trello (Legacy) | X | | | | \* Jira Server not supported diff --git a/docs/organization/integrations/issue-tracking/index.mdx b/docs/organization/integrations/issue-tracking/index.mdx index 2019b70b76657..c7c7789a3ff1a 100644 --- a/docs/organization/integrations/issue-tracking/index.mdx +++ b/docs/organization/integrations/issue-tracking/index.mdx @@ -17,6 +17,7 @@ description: "Learn more about Sentry's issue tracking integrations." - [Jira/Jira Server/Jira Data Center](/organization/integrations/issue-tracking/jira/) - [Kitemaker](/organization/integrations/issue-tracking/kitemaker/) - [Linear](/organization/integrations/issue-tracking/linear/) +- [Linear (Sentry Agent)](/organization/integrations/issue-tracking/sentry-linear-agent/) - [Shortcut](/organization/integrations/issue-tracking/shortcut/) - [Sourcegraph](/organization/integrations/issue-tracking/sourcegraph/) - [StarSling](/organization/integrations/issue-tracking/starsling/) diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Agent-Delegation.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Agent-Delegation.png new file mode 100644 index 0000000000000..84a2afe2ff7d1 Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Agent-Delegation.png differ diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Agent-Uninstall.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Agent-Uninstall.png new file mode 100644 index 0000000000000..f604b9b37b762 Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Agent-Uninstall.png differ diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-App-Revoke.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-App-Revoke.png new file mode 100644 index 0000000000000..61a42e4936d6e Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-App-Revoke.png differ diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-App-Uninstall.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-App-Uninstall.png new file mode 100644 index 0000000000000..bd72da1b1462a Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-App-Uninstall.png differ diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Assign-To.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Assign-To.png new file mode 100644 index 0000000000000..d0ada71f92c02 Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Assign-To.png differ diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Help.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Help.png new file mode 100644 index 0000000000000..b9539f689b0cd Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Help.png differ diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Linking-Auth.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Linking-Auth.png new file mode 100644 index 0000000000000..5ab15bb34c4f3 Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Linking-Auth.png differ diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Sentry-Agent-Install.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Sentry-Agent-Install.png new file mode 100644 index 0000000000000..16399e7a56333 Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Sentry-Agent-Install.png differ diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Sentry-RCA-2.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Sentry-RCA-2.png new file mode 100644 index 0000000000000..c94a84cf14e2f Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-Sentry-RCA-2.png differ diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/index.mdx b/docs/organization/integrations/issue-tracking/sentry-linear-agent/index.mdx new file mode 100644 index 0000000000000..9170b630dce48 --- /dev/null +++ b/docs/organization/integrations/issue-tracking/sentry-linear-agent/index.mdx @@ -0,0 +1,93 @@ +--- +title: Sentry Agent for Linear +sidebar_order: 1 +description: "Learn more about the Sentry Agent for Linear, which allows users to have Seer create Root Cause Analysis and Issue Fixes for Sentry issues in Linear." +--- + + + +**Sentry Agent for Linear** is in its beta phase. Changes to the UX and functionality should be expected. + + + +The Sentry Agent for Linear allows users to initiate Seer Issue Fix runs from within Linear. These results can then be used with other agents within Linear to trigger additional actions. + +This integration highly benefits from having [automation configured within Seer](/product/ai-in-sentry/seer/#automation), to automatically create Root Cause Analysis and Solutions based on fixability scores from Seer. + +## Install and Configure + + + +Sentry owner, manager, or admin permissions are required to install this integration. + +Linear **won't** work with self-hosted Sentry. + + + +Navigate to **Settings > Integrations > Linear (Sentry Agent)**, accept and install. + + ![Install Sentry Agent for Linear](./img/Linear-Sentry-Agent-Install.png) + +## Interaction Model + +The Sentry Agent can be used in 2 different ways: + +1. Delegating the Linear issue to Sentry via the Linear assignment flow. +2. Commenting `@sentry` from within the Linear issue and making your request via natural language. + +When the issue is delegated to the agent, the agent will automatically check for a complete Issue Fix run and display the result. If one doesn't exist, the agent will request to run one. + +For comment based interactions, the integration accepts natural language. We attempt to parse the intent of the question and trigger the appropriate response. If it fails, we'll prompt the help command that will guide you through options. + +Currently the integration allows the user to run the following actions: + +- Issue Fix - Runs a Seer Issue Fix for the application. +- Status - Updates the status of the issue. +- Help - Displays the help command that will guide you through options. + +## Assigning Sentry Agent to an Issue + +1. Navigate to an issue within Linear and select "Assign" from the dropdown menu in the right sidebar. + + ![Select Sentry Agent for Linear](./img/Linear-Agent-Delegation.png) + +2. Select "Sentry" from the dropdown menu. + +3. The task will be moved into in-progress and the Sentry agent session will be created. If it's your first time using the Agent, you'll be prompted to authenticate. Use the "Link" button to link your Linear user to your Sentry user. + + ![Link Sentry Agent for Linear](./img/Linear-Linking-Auth.png) + +4. Once linked, you'll be asked if you want to run a Seer Issue Fix for the application. You can answer "Yes", or ask for "Help" to see more options. + + ![Run Seer in Linear](./img/Linear-Help.png) + +5. If you answer "Yes", the Agent will run a Seer Issue Fix for the application. **Note**: You may need to prompt it for "Status" to see the results. + + ![RCA from Sentry Seer in Linear](./img/Linear-Sentry-RCA-2.png) + +## Uninstalling the Integration + +The Sentry integration installs a Linear based application within your Linear environment, as well as configures the integration within Sentry. Fully cleaning it out requires removing both of these. + +### Removing from Sentry + +1. Navigate to Settings > Integrations > Linear (Sentry Agent) + +2. Select "Uninstall" + + ![Uninstall Sentry from integrations](./img/Linear-Agent-Uninstall.png) + +### Removing from Linear + +1. Navigate to Settings > Applications > Sentry + + ![Uninstall Sentry from Linear applications](./img/Linear-App-Uninstall.png) + +2. Select the "..." and select "Revoke Access" + + ![Revoke Access to Sentry from Linear applications](./img/Linear-App-Revoke.png) + + + + + \ No newline at end of file