---
title: Sentry Entities
description: >-
  Collect Sentry projects, issues, teams, and members as entities in the Datadog
  Internal Developer Portal.
breadcrumbs: Docs > Integrations > Sentry Entities
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Sentry Entities
Supported OS Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}
   List of Sentry entity issues for serviceSentry Issue Alerts on serviceInternal Developer Portal Homepage
## Overview{% #overview %}

### About the Sentry Entities integration{% #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{% #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{% #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{% #setup %}

### Prerequisites{% #prerequisites %}

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

### Create a Sentry Internal Integration token{% #create-a-sentry-internal-integration-token %}

1. In Sentry, go to **Settings > Developer Settings > Internal Integrations**.
1. Click **Personal Token**, then **Create New Token**.
1. Enter a name, such as `Datadog IDP`.
1. 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`)
1. Click **Save Changes**.
1. Copy the token shown after saving.

### Connect the account in Datadog{% #connect-the-account-in-datadog %}

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

## Uninstallation{% #uninstallation %}

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

## Support{% #support %}

Need help? Contact [Datadog Support](https://app.datadoghq.com/help).