Skip to main content

Engineering Systems

Connect your version control and ticketing systems to unlock automatic issue-to-code correlation, engineering task creation, and auto-fix capabilities.

Version Control​

GitHub​

The Sailfish GitHub app enables:

  • Automatic instrumentation — Sailfish creates PRs to add SDK instrumentation to your repositories
  • Continuous updates — When we release SDK improvements, Sailfish automatically creates update PRs
  • Auto-fix — Sailfish can create PRs that fix issues detected in your application
  • Code-to-issue linking — Correlate issues with specific commits and deployments

Setup​

  1. Open the GitHub integration settings in the Sailfish dashboard
  2. Click Connect GitHub
  3. Select the GitHub organization and repositories you want to connect
  4. Approve the permissions — Sailfish needs read access to code and write access to create PRs
Quick link

Open GitHub Integration Settings →

Once connected, Sailfish creates Auto-Installation PRs for each repository. These PRs add the Sailfish SDK to your codebase with sensible defaults.

tip

After merging the Auto-Installation PRs, you may need to make small adjustments. See Instrument Your Code for details on configuring CORS headers, domain filtering, and user identification.

Multi-Organization Support​

If your team uses multiple GitHub organizations, you can connect each one separately. Navigate to Settings > Integrations and click Connect GitHub again to add another organization. Each connected org shows its repositories and connection status.

GitLab​

GitLab integration provides the same capabilities as GitHub — automatic instrumentation PRs, SDK updates, and auto-fix.

Setup​

  1. Open the GitLab integration settings in the Sailfish dashboard
  2. Click Connect GitLab
  3. Authorize access to your GitLab group
  4. Select the projects you want to connect
Quick link

Open GitLab Integration Settings →

Bitbucket​

Bitbucket integration supports automatic instrumentation and auto-fix PRs.

Setup​

  1. Open the Bitbucket integration settings in the Sailfish dashboard
  2. Click Connect Bitbucket
  3. Select the Bitbucket workspace
  4. Authorize the connection and choose repositories
Quick link

Open Bitbucket Integration Settings →

Ticketing Systems​

Create engineering tickets directly from Sailfish Issues and Triages. Tickets are pre-populated with full context — occurrence count, affected users, severity, and a direct link back to Sailfish.

Jira​

Setup​

  1. Open the Jira integration settings in the Sailfish dashboard
  2. Click Connect
  3. Enter your Jira instance URL (e.g., yourcompany.atlassian.net)
  4. Authorize the connection
  5. Select the default project for new tickets
Quick link

Open Jira Integration Settings →

Creating Tickets​

From any Issue or Triage, click Create Ticket and select Jira. The ticket includes:

  • Issue title and description
  • Occurrence count and affected user count
  • Priority mapping (Sailfish severity maps to Jira priority)
  • A direct link back to the issue in Sailfish

You can customize the project, issue type, and priority before creating.

Linear​

Setup​

  1. Open the Linear integration settings in the Sailfish dashboard
  2. Click Connect
  3. Authorize access to your Linear workspace
  4. Select the default team for new issues
Quick link

Open Linear Integration Settings →

Creating Tickets​

Works the same as Jira — click Create Ticket from any issue or triage, select Linear, and the issue is created with full context.

Managing Connected Integrations​

The Settings > Integrations page shows all connected services:

  • Connection status — Connected, requires re-authorization, or disconnected
  • Connected accounts — Which organization/workspace is linked
  • Repository list — (for VCS) Which repos are connected and their instrumentation status

To disconnect an integration, click the settings icon next to it and select Disconnect.