PagerDuty Grafana 数据源
PagerDuty 数据源插件允许您查询事件数据或使用注解可视化事件。
要求
此插件有以下要求
- 一个 PagerDuty 账号
- 以下账户类型之一
- 适用于拥有 Grafana Cloud 免费、高级或试用账户或拥有激活的 Grafana Enterprise 许可证的用户。
安装插件
要安装此数据源,请参阅安装。
在 Grafana 中配置数据源
通过填写以下字段来添加数据源
认证字段
此插件支持基于 API 密钥的认证。请访问REST API Keys 文档了解如何生成 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>
查询数据源
查询构建器
目前插件仅支持查询事件。有两种可用操作:“列出事件”和“获取事件”。
默认情况下,当列出所有事件时,查询使用 ${__from:date}
和 ${__to:date}
作为 Since
和 Until
参数,仅获取在仪表盘选定时间范围内创建的事件。如果要查询所有事件,请清空 Since
和 Until
参数。您还可以提供其他参数,例如事件的紧急程度或状态、服务 ID、团队 ID 等。
查询单个事件的数据时,您需要填写事件 ID。
您还可以通过在“选择字段”下拉框中选择字段来过滤返回的字段。
注解
您可以使用注解来可视化仪表盘上事件与其他数据之间的关系。有关如何使用注解的通用信息,请参阅文档。
模板和变量
要添加新的 PagerDuty 查询变量,请参阅添加查询变量。使用您的 PagerDuty 数据源作为数据源,并在查询构建器中填写字段。
注意:创建 PagerDuty 查询变量时,“选择字段”下的前两个选定字段将分别用作变量标签和值。如果只选择一个字段,它将同时用作变量标签和值。例如,如果您想创建一个包含事件 ID 的变量,可以在“选择字段”下选择
title
和id
,这样事件标题将用作易于阅读的标签,而事件 ID 将用作值。
创建变量后,您可以使用变量语法在 PagerDuty 查询中使用它。有关变量的更多信息,请参阅模板和变量。