Sentry

概述
安装
变更日志
相关内容

Grafana 的 Sentry 数据源插件

Sentry 数据源插件允许您在 Grafana 中查询和可视化 Sentry 数据。

要求

Sentry 数据源有以下要求

具有服务器或组织管理角色的 Grafana 用户；请参阅权限。
一个活跃的 Sentry 账号
在 Sentry 中，需要 Admin、Manager 或 Owner 角色才能获取内部集成令牌

已知限制

借助 Grafana Sentry 数据源插件，您可以在组织内可视化问题、事件或使用统计信息。更多信息请参阅问题、事件和组织统计。

安装 Sentry 数据源插件

要在您的 Grafana 实例中安装 Sentry 数据源插件，请参阅安装。

从 Sentry 获取身份验证令牌

要在 Grafana 中配置 Sentry 数据源插件，请从 Sentry 获取内部集成令牌

访问 https://sentry.io。
导航至 Organization Settings（组织设置）
在 Developer Settings（开发者设置）下选择 Custom Integrations（自定义集成）。
点击 Create New Integration（创建新集成），然后选择 Internal Integration（内部集成）
使用一个有效的名称，例如 Grafana。
前往 PERMISSIONS（权限），为所需的资源（如“Project”、“Issue and Event”和“Organization”）提供 Read（读取）权限。
点击 Save Changes（保存更改），然后向下滚动到 TOKENS（令牌）并点击 + New Token（+ 新令牌）
在 Grafana 中配置数据源时，复制令牌到 Sentry Auth Token（Sentry Auth Token）字段。

注意：在 Sentry 中，需要 Admin、Manager 或 Owner 角色才能获取内部集成令牌

在 Grafana 中配置数据源

填写以下字段来添加数据源

字段名称	描述
Sentry URL	要使用的 Sentry URL。如果留空，默认为 `https://sentry.io`。
Sentry 组织	Sentry 组织 slug。通常位于 URL 中，例如 `https://sentry.io/organizations/{organization_slug}/`。
Sentry Auth Token	Sentry Auth token。您可以使用上一节中指定的步骤从 `https://sentry.io/settings/{organization_slug}/developer-settings/`) 生成此令牌。

通过 Provisioning 配置数据源

您可以将数据源配置为使用 Grafana 的 Provisioning 系统。有关 Provisioning 如何工作以及您可以为数据源设置的所有设置的更多信息，请参阅Provisioning Grafana。

以下是 Provisioning 此数据源的示例

apiVersion: 1
datasources:
  - name: Sentry
    type: grafana-sentry-datasource
    access: proxy
    orgId: 1
    version: 1
    editable: false
    jsonData:
      url: https://sentry.io
      orgSlug: xxxxxxxxxxxxx
    secureJsonData:
      authToken: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

查询数据源

查询编辑器允许您查询 Sentry，获取 Sentry 问题、事件和统计信息，并在 Grafana 仪表盘面板中显示它们。您可以选择以下查询类型之一来获取相关数据。

Sentry 问题

要获取 Sentry 问题列表，请选择 Sentry Issues 作为查询类型。问题会根据 Grafana 选择的时间范围进行筛选。

字段	描述
查询类型	选择 Issues 作为查询类型。
项目	（可选）选择一个或多个项目来筛选结果。
环境	（可选）选择一个或多个环境来筛选结果。
查询	（可选）输入您的 Sentry 查询以获取相关结果。
排序方式	（可选）选择您想要显示的结果顺序。
限制	（可选）限制显示的结果数量。

Sentry 事件

要获取 Sentry 事件列表，请选择 Sentry Events 作为查询类型。事件会根据 Grafana 选择的时间范围进行筛选。

字段	描述
查询类型	选择 Events 作为查询类型。
项目	（可选）选择一个或多个项目来筛选结果。
环境	（可选）选择一个或多个环境来筛选结果。
查询	（可选）输入您的 Sentry 查询以获取相关结果。更多关于查询语法的信息。
排序方式	（可选）选择您想要显示的结果顺序。
限制	（可选）限制显示的结果数量。最大限制 - 100。

Sentry 组织统计

要获取 Sentry 组织统计的趋势，请选择 Stats 作为查询类型。组织统计会根据 Grafana 选择的时间范围进行筛选。

字段	描述
查询类型	选择 Stats 作为查询类型。
字段	选择您想要进行趋势分析的字段类型。目前，您必须选择 `sum(quantity)` 或 `sum(times_seen)` 中的一个。
类别筛选器	选择您想要筛选结果的类别。您必须选择其中一个可用选项。
分组方式	（可选）选择一个或多个您想要对结果进行分组的字段。
项目	（可选）选择一个或多个项目来筛选结果。
结果筛选器	（可选）选择一个或多个结果来筛选结果。
原因筛选器	（可选）输入您想要筛选的原因的逗号分隔列表。

模板和变量

在 Grafana 仪表盘中，您可以使用 Sentry 实体作为仪表盘变量。Sentry 数据源支持以下变量

变量名称	描述
团队	列出 Sentry 团队。团队名称用作显示值，团队 slug 用作实际值。
项目	列出 Sentry 项目。项目名称用作显示值，每个项目 ID 用作实际值。
环境	列出选定项目的 Sentry 环境。如果您未选择项目，则会列出所有适用的环境。