Skip to main content

Sentry Integration

Align connects to Sentry through the Alignsoft integration so production errors become part of your delivery picture: Sentry issues correlate to the Align entries that caused or fix them, and error health flows into release readiness and client-facing status reports.

What it does​

  • Error → work correlation. Sentry issues are matched to Align entries automatically (and confirmable manually), so "what broke" links straight to "who's fixing it and in which phase."
  • Release readiness. Open and regressed Sentry issues feed each release's readiness verdict alongside blockers, approvals, and CI — one honest go/no-go signal.
  • Production health reporting. Align's reporting assistant (Max) builds production-health sections from your Sentry data: incident summaries, top production errors, new vs. regressed issues, crash-free trend, and errors by release.
  • Client-readable status. Delivery teams choose what surfaces to clients; raw Sentry detail stays internal while health rolls up into plain language.

Requirements​

  • An Align workspace at app.alignsoft.us.
  • Admin role in the Align organization you're connecting.
  • Owner or Manager access in the Sentry organization (to approve the install).

Installation​

  1. In Align, go to Settings → Integrations → Sentry and click Install with Sentry.
  2. You'll be redirected to Sentry's install page for Alignsoft. Choose the Sentry organization to connect and click Accept & Install.
  3. Sentry returns you to Align, which completes the handshake automatically and verifies the installation. The Sentry card in Settings shows Connected with your Sentry org slug.
  4. In each Align project's settings, bind the Sentry project(s) that belong to that engagement. Binding drives per-project error correlation and reporting.

No tokens are copied by hand: the install uses Sentry's OAuth flow, and Align stores the resulting credentials encrypted (AES-256-GCM) per organization. Align refreshes tokens automatically.

Self-hosted Sentry​

Self-hosted instances can connect without the public app: create an internal integration in your Sentry (Settings → Custom Integrations) with read access to Organization, Project, Issue & Event, and Release, then in Align choose the manual option and paste the organization slug, token, and your instance's base URL.

Permissions and webhooks​

The integration requests read access to Organization, Project, Issue & Event, and Release — enough to correlate errors and build reports, nothing more. It never writes to your Sentry data.

Sentry sends issue webhooks to Align (signature-verified). Issue events refresh error→entry correlations for bound projects; uninstall events disable the connection immediately.

Uninstalling​

Uninstall from either side:

  • In Sentry: Settings → Integrations → Alignsoft → Uninstall. Sentry notifies Align and the connection is disabled automatically.
  • In Align: Settings → Integrations → Sentry → Disconnect. Stored credentials are removed.

Historical correlations remain in Align (they reference your own entries); no Sentry data is retained beyond issue metadata used in reports.

Support​

Questions or issues: hello@send.alignsoft.us. We aim to respond within one business day.

Changelog​

  • 2026-07 — Initial public release: OAuth install, issue webhooks, error→entry correlation, release-readiness fusion, and production-health reporting.