Sentry integration

Let Agents triage Sentry alerts, read issues and events, and post results back as a comment on the issue.

Connect in the dashboard

Open Manage → Integrations, select Sentry → Connect, and approve the islo.dev app in your Sentry organization with Accept & Install. Return to Islo and confirm the Sentry card shows Tenant. The connection is shared across your workspace (tenant scope).

Connect with the CLI

Sentry connects from the dashboard only.

Trigger a Line from a Sentry alert

In Sentry, open Alerts → Create Alert, select your project, and add both A new issue is created and A resolved issue regresses under WHEN. Under THEN, select Send a notification via islo.dev. Do not use “An issue is resolved”: every resolve would start a run.

In your Islo Line, configure this trigger to pass the Sentry event URL as input. Replace 42 with your numeric Sentry project ID. Find the ID in the ?project= value on the Sentry project Issues URL or under Project Settings → General.

[trigger]
type = "integration_trigger"
provider = "sentry"
name = "event_alert.triggered"
[trigger.selector]
provider = "sentry"
kind = "project"
scope = "selected"
project_ids = ["42"]
[trigger.outputs.input]
type = "trigger_path"
path = "trigger.raw.data.event.web_url"

Use the Sentry API from an Agent

Agents use Authorization: Bearer $SENTRY_AUTH_TOKEN; Islo injects the connected credential. Agents can post results back with POST https://sentry.io/api/0/issues/<issue_id>/comments/ and a JSON body {"text": "..."} (the islo.dev app has Event: Read & Write). For example (replace <org> with your organization slug):

curl --fail-with-body \
  -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
  'https://sentry.io/api/0/organizations/<org>/projects/'

The Agent’s gateway profile needs rules for all three Sentry hosts with provider_key=sentry and bearer authentication. Replace <profile> with its name or ID and add missing rules:

islo gateway <profile> add-rule \
  --host sentry.io --action allow --provider-key sentry --auth-mode bearer
islo gateway <profile> add-rule \
  --host us.sentry.io --action allow --provider-key sentry --auth-mode bearer
islo gateway <profile> add-rule \
  --host de.sentry.io --action allow --provider-key sentry --auth-mode bearer

Which Suggested Lines need it?

No Sentry Suggested Lines exist yet. Use the alert-triggered Line configuration above.

Next steps

Follow the quickstart to create your first factory. Once it exists, delegate work from a connected tool or configure an integration trigger to start work automatically.