PagerDuty Grafana 数据源
PagerDuty 数据源插件允许您查询事件数据或使用注释可视化事件。
要求
此插件有以下要求
- 一个 PagerDuty 账户
- 以下账户类型之一
- 适用于具有 Grafana Cloud 免费版、高级版或试用账户的用户,或具有已激活的 Grafana Enterprise 许可证的用户。
安装插件
要安装数据源,请参阅安装。
在 Grafana 中配置数据源
添加数据源,请填写以下字段
认证字段
此插件支持基于API密钥的认证。有关如何生成API密钥的更多信息,请访问REST 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查询中使用它。有关变量的更多信息,请参阅模板和变量。