Skip to main content

Sentry

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable Self-Managed EnterpriseAvailable PyAirbyte
Support Level
Airbyte
Connector Version
1.0.2 (last updated a day ago)
Sync Success Rate
High
Usage Rate
High
Data workers used
0.2 per sync (Learn more)
Definition ID
cdaf146a-9b75-49fd-9dd2-9d64a0bb4781

This page contains the setup guide and reference information for the Sentry source connector.

Prerequisites​

To set up the Sentry source connector, you need:

For Sentry SaaS, you can create an organization-wide token with a Sentry internal integration. Configure the integration with read access for organizations, projects, and issues and events to sync every stream.

Set up the Sentry connector in Airbyte​

  1. In Airbyte, select Sources, then select New source.
  2. Select Sentry.
  3. For Authentication Tokens, enter your Sentry authentication token.
  4. For Host Name, keep sentry.io for Sentry SaaS, or enter the hostname of your self-hosted Sentry server without https:// or a path. You can also use your Sentry SaaS region-specific domain, such as us.sentry.io, us2.sentry.io, or de.sentry.io.
  5. For Organization, enter the organization slug.
  6. For Project, enter the project slug. This setting determines which project the events, issues, and project_detail streams sync. Organization-level streams aren't limited to this project.
  7. Optionally, for Number of concurrent workers, enter a value from 1 through 20. The default is 5.
  8. Select Set up source.

Supported sync modes​

The Sentry source connector supports these sync modes:

Supported streams​

StreamData syncedSupported sync modes
EventsError events for the configured projectFull refresh, incremental
IssuesIssues for the configured projectFull refresh, incremental
ProjectsProjects in the configured organizationFull refresh, incremental
Project DetailFull details for the configured projectFull refresh
All Projects DetailFull details for every project in the configured organizationFull refresh
ReleasesReleases in the configured organizationFull refresh, incremental

The all_projects_detail stream makes one project-detail request for every project returned by the organization-level list endpoint.

Version 1.0.0

The projects stream now returns only projects in the configured organization. The avatar, color, isInternal, isPublic, organization, and status fields return null in this stream. Sync all_projects_detail to retrieve these fields for every project. For upgrade instructions, see the Sentry migration guide.

Authentication token scopes​

The authentication token must include the scopes required by the streams you sync. To sync every stream, grant org:read, event:read, and project:read.

StreamEndpointRequired scope
EventsGET /api/0/projects/{organization}/{project}/events/project:read
IssuesGET /api/0/projects/{organization}/{project}/issues/event:read
ProjectsGET /api/0/organizations/{organization}/projects/org:read
Project DetailGET /api/0/projects/{organization}/{project}/project:read
All Projects DetailGET /api/0/projects/{organization}/{project}/ (per org project)org:read, project:read
ReleasesGET /api/0/organizations/{organization}/releases/project:read

If the token is missing a scope, the corresponding stream returns an HTTP 403 error. See the Sentry permissions and scopes reference for details.

Limitations and troubleshooting​

Event retention​

warning

Sentry SaaS retains error events for 30 or 90 days, depending on your plan. If you use Full Refresh - Overwrite, a sync replaces older destination records with only the events still available from Sentry. Use an append mode if you need to keep events beyond Sentry's data retention period.

Rate limits​

Sentry applies request and concurrency limits per caller and endpoint. The limits are returned in the X-Sentry-Rate-Limit-* response headers and can vary by endpoint. If syncs receive HTTP 429 responses, reduce Number of concurrent workers. See Sentry's rate limit documentation.

IP allow list​

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference​

Config fields reference

Field
Type
Property name
string
auth_token
string
organization
string
project
array
discover_fields
string
hostname
integer
num_workers

Changelog​

Expand to review
VersionDatePull RequestSubject
1.0.22026-07-1482008Update dependencies
1.0.12026-07-1381707Scope the 1.0.0 breaking change to the projects stream and emphasize the risk of data loss in the migration guide
1.0.02026-07-1380190Breaking: migrate the projects stream to the org-scoped endpoint (Sentry deprecated the legacy /projects/ endpoint). The stream now returns only projects belonging to the configured organization, and no longer returns avatar, color, isInternal, isPublic, organization, status. Added the all_projects_detail stream, which returns full project details (including those six fields) for every project in the organization. See the migration guide.
0.9.272026-06-3081219Update dependencies
0.9.262026-06-2380622Update dependencies
0.9.252026-06-1680036Update dependencies
0.9.242026-06-0979482Update dependencies
0.9.232026-06-0278975Update dependencies
0.9.222026-06-0178537Add user-configurable num_workers concurrency setting (default 5, tested optimal at 7)
0.9.22-rc.22026-05-2778468Concurrency tuning iteration 2 — bump default_concurrency from 7 to 8
0.9.22-rc.12026-05-2678444Concurrency tuning — bump default_concurrency from 5 to 7 for progressive rollout
0.9.212026-04-2877407Update dependencies
0.9.202026-04-2176772Update dependencies
0.9.192026-03-3175797Update dependencies
0.9.182026-03-2475330Update dependencies
0.9.172026-03-1074601Update dependencies
0.9.162026-03-0373562Update dependencies
0.9.152026-02-0372578Update dependencies
0.9.142026-01-2072096Update dependencies
0.9.132026-01-1471517Update dependencies
0.9.122025-12-1870669Update dependencies
0.9.112025-11-2570115Update dependencies
0.9.102025-11-1869655Update dependencies
0.9.92025-10-2968882Update dependencies
0.9.82025-10-2268591Add suggestedStreams
0.9.72025-10-2168468Update dependencies
0.9.62025-10-1467945Update dependencies
0.9.52025-10-0767221Update dependencies
0.9.42025-09-3066859Update dependencies
0.9.32025-09-2466627Update dependencies
0.9.22025-09-0966114Update dependencies
0.9.12025-08-2465501Update dependencies
0.9.02025-08-2164879Update events stream to use start and query params instead of filtering on source side
0.8.172025-08-1064850Update dependencies
0.8.162025-08-0264455Update dependencies
0.8.152025-07-2663965Update dependencies
0.8.142025-07-2063667Update dependencies
0.8.132025-07-0562716Update dependencies
0.8.122025-06-2861458Update dependencies
0.8.112025-05-2460461Update dependencies
0.8.102025-05-1560295Fix missing records for events stream
0.8.92025-05-1060171Update dependencies
0.8.82025-05-0459571Update dependencies
0.8.72025-04-2758970Update dependencies
0.8.62025-04-1958446Update dependencies
0.8.52025-04-1257927Update dependencies
0.8.42025-04-0557473Update dependencies
0.8.32025-03-2956847Update dependencies
0.8.22025-03-2256263Update dependencies
0.8.12025-03-0855062Update dependencies
0.8.02025-03-0555215Fix lints for events stream
0.7.02025-02-2546664Converting to manifest-only format
0.6.112025-02-2254521Update dependencies
0.6.102025-02-1554100Update dependencies
0.6.92025-02-0853513Update dependencies
0.6.82025-02-0152979Update dependencies
0.6.72025-01-2552503Update dependencies
0.6.62025-01-1851896Update dependencies
0.6.52025-01-1151335Update dependencies
0.6.42025-01-0450930Update dependencies
0.6.32024-12-2850709Update dependencies
0.6.22024-12-2149058Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.6.12024-11-0443855Update dependencies
0.6.02024-10-3047988Upgrade the CDK and startup files to sync incremental streams concurrently
0.5.32024-06-0639180[autopull] Upgrade base image to v1.2.2
0.5.22024-05-2038263Replace AirbyteLogger with logging.Logger
0.5.12024-04-0136731Add %Y-%m-%dT%H:%M:%S%z to date time formats.
0.5.02024-03-2735755Migrate to low-code.
0.4.22024-03-2536448Unpin CDK version
0.4.12024-02-1235145Manage dependencies with Poetry
0.4.02024-01-0532957Added undeclared fields to schema and migrated to base image
0.3.02023-09-0530192Added undeclared fields to schema
0.2.42023-08-1429401Fix null value in stream state
0.2.32023-08-0329023Add incremental for issues stream
0.2.22023-05-0225759Change stream that used in check_connection
0.2.12023-04-2725602Add validation of project and organization names during connector setup
0.2.02023-04-0323923Add Releases stream
0.1.122023-03-0123619Fix bug when stream state is None or any other bad value occurs
0.1.112023-02-0222303Turn ON default AvailabilityStrategy
0.1.102023-01-2722041Set AvailabilityStrategy for streams explicitly to None
0.1.92022-12-2021864Add state persistence to incremental sync
0.1.82022-12-2020709Add incremental sync
0.1.72022-09-3017466Migrate to per-stream states
0.1.62022-08-2916112Revert back to the Python CDK
0.1.52022-08-2415911Bugfix to allowing reading schemas at runtime
0.1.42022-08-1915800Bugfix to allow reading sentry.yaml at runtime
0.1.32022-08-1715734Fix yaml based on the new schema validator
0.1.22021-12-2815345Migrate to config-based framework
0.1.12021-12-288628Update fields in source-connectors specifications
0.1.02021-10-126975New Source: Sentry
Was this page helpful?