PagerDuty Grafana 数据源
PagerDuty 数据源插件允许您查询事件数据或使用注释可视化事件。
要求
此插件具有以下要求
- 一个 PagerDuty 帐户
- 以下帐户类型之一
- 适用于具有 Grafana Cloud 免费、高级或试用帐户或具有 已激活的 Grafana Enterprise 许可证 的用户。
安装插件
要安装数据源,请参考 安装。
在 Grafana 中配置数据源
添加数据源,方法是填写以下字段
身份验证字段
此插件支持基于 API 密钥的身份验证。访问 REST API 密钥 文档,了解更多关于如何生成 API 密钥的信息。由于插件仅从 PagerDuty 读取数据,因此建议生成**只读** API 密钥。
字段 | 描述 |
---|---|
API 密钥 | 输入您的 PagerDuty REST API 密钥 |
使用配置配置数据源
可以使用配置文件和 Grafana 的配置系统配置数据源。要了解它的工作原理,包括可以为此数据源设置的所有设置,请参考 配置 Grafana 数据源
以下是使用 API 密钥身份验证为此数据源提供配置的一些示例
apiVersion: 1
datasources:
- name: PagerDuty
type: grafana-pagerduty-datasource
jsonData:
auth:
id: api_key
secureJsonData:
auth.api_key.apiKey: <API_KEY>
查询数据源
查询构建器
目前,插件仅支持查询事件。有 2 个操作可用:“列出事件”和“获取事件”。
在列出所有事件时,默认情况下,查询使用${__from:date}
和${__to:date}
作为Since
和Until
参数,仅获取在仪表板所选时间范围内创建的事件。如果您要查询所有事件,请清除Since
和Until
参数。您还可以提供其他参数,例如事件紧急程度或状态、服务 ID、团队 ID 等。
在查询单个事件的数据时,您需要填写事件 ID。
您还可以通过在“选择字段”选择框中选择字段来筛选要返回的字段。
注释
您可以使用注释来可视化事件与仪表板上的其他数据之间的关系。有关如何使用注释的一般信息,请参考 文档。
模板和变量
要添加新的 PagerDuty 查询变量,请参考 添加查询变量。使用您的 PagerDuty 数据源作为数据源,并在查询构建器中填写字段。
注意:在创建 PagerDuty 查询变量时,将使用“选择字段”下选择的第一个和第二个字段作为变量标签和值。如果只选择了一个字段,则它将用于变量标签和值。例如,如果您要创建一个包含事件 ID 的变量,您可以在“选择字段”下选择
title
和id
,以便事件标题用作人类可读的标签,而事件 ID 用作值。
创建变量后,您可以在 PagerDuty 查询中使用它,方法是使用 变量语法。有关变量的更多信息,请参阅 模板和变量。