Sentry Entities

Supported OS Linux Windows Mac OS

Integration version1.0.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

List of Sentry entity issues for service
Sentry Issue Alerts on service
Internal Developer Portal Homepage

Overview

About the Sentry Entities integration

Sentry is an application error and performance monitoring service that engineering teams use to track and resolve software issues. This integration collects Sentry projects, issues, teams, and members as entities in the Datadog Internal Developer Portal (IDP).

What you can do with Sentry entities in IDP

  • View error health for a service on its catalog page, including unresolved issues and their status.
  • Enforce reliability standards with scorecards that reference Sentry issue data across services.
  • Surface newly created critical issues on the IDP homepage for morning triage.

How the Sentry Entities integration works

The integration authenticates with a Sentry Internal Integration token and reads from the Sentry API. It collects all projects, issues, teams, and members in your organization on a schedule managed by the Internal Developer Portal team, which can be viewed in Datadog.

Setup

Prerequisites

  • A Sentry account with the Organization Owner or Manager role
  • One integration account per Sentry organization

Create a Sentry Internal Integration token

  1. In Sentry, go to Settings > Developer Settings > Internal Integrations.
  2. Click Personal Token, then Create New Token.
  3. Enter a name, such as Datadog IDP.
  4. Under Permissions, grant read access for the following scopes:
    • Organization: Read (org:read)
    • Project: Read (project:read)
    • Issue & Event: Read (event:read)
    • Member: Read (member:read)
    • Team: Read (team:read)
  5. Click Save Changes.
  6. Copy the token shown after saving.

Connect the account in Datadog

  1. In Datadog, go to Integrations > Sentry Entities and click Add Account.
  2. In Auth Token, paste the token you copied.
  3. In Organization Slug, enter your Sentry organization slug from Sentry Settings > General > Organization Slug.
  4. Click Save.

Uninstallation

To uninstall the integration, remove each connected Sentry account from the tile in Datadog. Deleting the last account stops all data collection.

Support

Need help? Contact Datadog Support.