Sentry
Sentry provider allows you to query Sentry events and to pull/push alerts from Sentry
Inputs
time: str = "14d"
: The time range for the query (e.g.,1d
)project: str
: The project to query on.
Authentication Parameters
The api_key
and organization_slug
are required for connecting to the Sentry provider. You can obtain them as described in the “Connecting with the Provider” section.
project_slug
is if you want to connect Sentry to a specific project within an organization.
To connect self hosted Sentry, you need to set the api_url
parameter. Default value is https://sentry.io/api/0/
.
Connecting with the Provider
API Key
To obtain the Sentry API key, follow these steps (Docs):
- Log in to your Sentry account.
- Navigate
Settings
->Developer Settings
section. - Click on
Custom integrations
. - Click on
Create New Integration
on the top right side of the screen. - Select
Internal Integration
and clickNext
- Give the integration an indicative name, e.g.
Keep Integration
- From the permission section, select the required scopes as defined at the bottom of this page.
- Click
Save Changes
- Scroll down to the bottom of the screen to the
TOKENS
section and copy the generated token — This is the API key you will be using in Keep.
Organization Slug
You can find the Organization Slug in your Sentry URL.
For example, this is our playground account: https://keep-dr.sentry.io/
- The organization slug is keep-dr
.
To obtain the Organization Slug from the settings page:
- Log in to your Sentry account.
- Navigate
Settings
->General Settings
. - Copy the Organization Slug from the Organization Slug input.
Scopes
Certain scopes may be required to perform specific actions or queries via the Sentry Provider. Below is a summary of relevant scopes and their use cases:
event:read
| Required:True
| Description:Read events and issues.
project:read
| Required:True
| Description:Read projects in organization
project:write
| Required:False
| Description:Write permission for projects in an organization.
(*Required for auto-webhook integration)
Notes
When installing Sentry webhook integration, Keep enables built-in Webhook integration to all accessible projects and adds a new Alert that has an Action
to send a notification via Webhooks to all accessible projects.
You can achieve alerts pushing from Sentry to Keep using an Internal Integration
which is not automated via the platform. Contact us to set it up.