关于本页

本页介绍更夫所基于的开源内核 Keep 的通用能力。更夫在其上提供国内化增强：钉钉/企业微信/飞书通知、国产大模型接入、LDAP 认证与值班管理。部署与上手请看快速上手。

认证

此提供商需要身份验证。

• api_key: Sentry API 密钥（必需：True，敏感：True）
• organization_slug: Sentry 组织 slug（必需：True，敏感：False）
• api_url: Sentry API URL（必需：False，敏感：False）
• project_slug: 组织内的 Sentry 项目 slug（必需：False，敏感：False）

某些范围可能需要才能通过提供商执行特定操作或查询。以下是相关范围及其用例的摘要：

• ****: 对组织中项目的写权限

在工作流中

此提供商可用于工作流。

作为"步骤"来查询数据，示例：

steps:
    - name: Query sentry
      provider: sentry
      config: "{{ provider.my_provider_name }}"
      with:
        project: {value}  # 项目名称
        time: {value}  # 时间范围，例如：14d

请查看以下工作流示例：

• create_jira_ticket_upon_alerts.yml

连接 Provider

::: note 要连接自托管 Sentry，您需要设置 api_url 参数。 默认值为 https://sentry.io/api/0/。 :::

API 密钥

要获取 Sentry API 密钥，请按照以下步骤操作（文档）：

1. 登录您的 Sentry 账户。
2. 导航 Settings -> Developer Settings 部分。
3. 点击 Custom integrations。
4. 点击屏幕右上角的 Create New Integration。

5. 选择 Internal Integration 并点击 Next

6. 为集成提供一个指示性名称，例如 Keep Integration
7. 从权限部分，选择所需的范围：

Project: Read & Write Issue & Event: Read Organization: Read Alerts: Read & Write (Not Mandatory)

8. 点击 Save Changes

9. 向下滚动至屏幕底部的 TOKENS 部分，复制生成的令牌 -- 这是您将在 Keep 中使用的 API 密钥。

组织 Slug

您可以在 Sentry URL 中找到组织 Slug。 例如，这是我们的 playground 账户：https://keep-dr.sentry.io/ - 组织 slug 是 keep-dr。

要从设置页面获取组织 Slug：

1. 登录您的 Sentry 账户。
2. 导航 Settings -> General Settings。
3. 从组织 Slug 输入中复制组织 Slug。

注意事项

::: note 安装 Sentry webhook 集成时，Keep 会启用对所有可访问项目的内置 Webhook 集成，并添加一个新的告警，该告警具有通过 Webhooks 向所有可访问项目发送通知的操作。

您可以使用内部集成实现从 Sentry 到 Keep 的告警推送，这不是通过平台自动化的。联系我们 进行设置。 :::

相关链接

• Sentry Integration Platform
• Sentry API Reference