Skip to content

Commit ceb2cef

Browse files
authored
docs(integration): Update Linear Agent Docs (#15420)
Adding new content for updated OAuth consent screen, options for configuration, enable prs / automatic seer command, and help elicitations. Adding support for both us / eu Sentry environments.
1 parent 7796f42 commit ceb2cef

File tree

7 files changed

+63
-8
lines changed

7 files changed

+63
-8
lines changed
112 KB
Loading
124 KB
Loading
69.9 KB
Loading
54.3 KB
Loading
31 KB
Loading

docs/organization/integrations/issue-tracking/sentry-linear-agent/index.mdx

Lines changed: 62 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ og_image: /og-images/organization-integrations-issue-tracking-sentry-linear-agen
99

1010
<Alert title="Beta">
1111

12-
**Sentry Agent for Linear** is in its beta phase. It is currently only available for US-based Sentry.io organizations. Changes to the UX and the agent functionality should be expected.
12+
**Sentry Agent for Linear** is in its beta phase. Changes to the UX and the agent functionality should be expected.
1313

1414
</Alert>
1515

@@ -24,7 +24,6 @@ This integration highly benefits from having [automation configured within Seer]
2424
Sentry owner, manager, or admin permissions are required to install this integration.
2525

2626
Linear **won't** work with self-hosted Sentry.
27-
2827
</Alert>
2928

3029
Navigate to **Settings > Integrations > Linear (Sentry Agent)**, accept and install.
@@ -42,31 +41,87 @@ When the issue is delegated to the agent, the agent will automatically check for
4241

4342
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.
4443

45-
Currently the integration allows the user to run the following actions:
44+
Most actions are available via interactive buttons or natural language. Currently, the integration allows the user to run the following actions:
4645

4746
- Issue Fix - Runs a Seer Issue Fix for the application.
4847
- Status - Updates the status of the issue.
4948
- Help - Displays the help command that will guide you through options.
49+
- Enable/Disable automatic Seer runs - Toggle whether Seer automatically runs (without confirmation) when issues are assigned in Linear.
50+
- Enable/Disable Seer PRs - Allow Seer to open pull requests automatically when fixes are ready.
51+
52+
## Automation & Configuration
53+
54+
When an issue is assigned to the Sentry Agent in Linear, the user will be prompted to link their account with Sentry. This creates the relationship between your Linear user and your Sentry user, and exposes the projects and Sentry resources the user has access to.
55+
56+
The OAuth consent screen shows what orgnaization is connecting to Linear as well as gives options that can be enabled to customize the Sentry Agent in Linear's behavior.
57+
58+
<div style={{width: '50%'}}>
59+
60+
![OAuth consent screen](./img/Linear-oauth-consent.png)
61+
62+
</div>
63+
64+
These options can also be managed within the agent interface after the account is linked through the `help` command and leveraging the select menu at the bottom.
65+
66+
<div style={{width: '50%'}}>
67+
68+
![Help command](./img/Linear-agent-help-options.png)
69+
70+
</div>
71+
72+
These options can also be enabled interactively during agent sessions. These options present themselves in the following ways:
73+
74+
- Via buttons after an issue is assigned:
75+
- `Yes, run Seer RCA` runs Seer Root Cause Analysis (RCA) for the current issue
76+
- `Yes, and run automatically in the future` enables automatic runs in the future for this workspace and starts Seer RCA for the current issue
77+
- Natural language controls:
78+
- "enable automatic seer runs", "disable automatic seer runs"
79+
- "enable Seer PRs", "disable Seer PRs"
5080

5181
## Assigning Sentry Agent to an Issue
5282

5383
1. Navigate to an issue within Linear and select "Assign" from the dropdown menu in the right sidebar.
5484

85+
<div style={{width: '75%'}}>
86+
5587
![Select Sentry Agent for Linear](./img/Linear-Agent-Delegation.png)
5688

89+
</div>
90+
5791
2. Select "Sentry" from the dropdown menu.
5892

5993
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.
6094

6195
![Link Sentry Agent for Linear](./img/Linear-Linking-Auth.png)
6296

63-
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.
97+
4. If auto-run is disabled, you'll see a prompt with buttons:
98+
99+
- `Yes, run Seer RCA`
100+
- `Yes, and run automatically in the future`
101+
<div style={{width: '65%'}}>
102+
![Enable automatic Seer runs](./img/Linear-run-or-run-always.png)
103+
</div>
104+
105+
5. If auto-run is enabled, the Agent will start Seer automatically and confirm it's running. Use "status" to check progress or view results. If an analysis already exists, the Agent will post the latest status or Sentry issue details.
106+
107+
<div style={{width: '65%'}}>
108+
109+
![Seer RCA in Linear](./img/Linear-Sentry-RCA-2.png)
110+
111+
</div>
112+
113+
114+
### Triage Rules
115+
116+
The Sentry Agent supports Linear's triage rules allowing you to tag issues with a custom label in Linear, and have it execute the Sentry Agent. Examples are below.
117+
118+
#### Triage Configuration
64119

65-
![Run Seer in Linear](./img/Linear-Help.png)
120+
![Triage Configuration](./img/Linear-triage-rule.png)
66121

67-
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.
122+
#### Triage Action
68123

69-
![RCA from Sentry Seer in Linear](./img/Linear-Sentry-RCA-2.png)
124+
![Triage Action](./img/Linear-triage-claim.png)
70125

71126
## Uninstalling the Integration
72127

docs/platforms/react-native/integrations/plugin.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,4 +126,4 @@ Sentry.init({
126126
});
127127
```
128128

129-
For more information, please refer to [the Supabase integration documentation for the JavaScript SDK](/platforms/javascript/configuration/integrations/supabase/).
129+
For more information, please refer to [the Supabase integration documentation for the JavaScript SDK](javascript/guides/node/configuration/integrations/supabase/).

0 commit comments

Comments
 (0)