菜单
文档breadcrumb arrow 插件breadcrumb arrow 适用于 Grafana 的 PagerDuty 数据源

PagerDuty Grafana 数据源

PagerDuty 数据源插件允许您查询事件数据或使用注释可视化事件。

要求

此插件有以下要求

  • 一个 PagerDuty 账户
  • 以下账户类型之一
    • 适用于具有 Grafana Cloud 免费版、高级版或试用账户的用户,或具有已激活的 Grafana Enterprise 许可证的用户。

安装插件

要安装数据源,请参阅安装

在 Grafana 中配置数据源

添加数据源,请填写以下字段

认证字段

此插件支持基于API密钥的认证。有关如何生成API密钥的更多信息,请访问REST API密钥文档。由于插件只从PagerDuty读取数据,建议生成只读API密钥。

字段描述
API密钥输入您的PagerDuty REST API密钥

使用配置设置配置数据源

您可以使用Grafana的配置系统使用配置文件来配置数据源。有关其工作原理的更多信息,包括您可以为此数据源设置的设置,请参阅配置Grafana数据源

以下是使用API密钥认证为此数据源提供的配置示例

yaml
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}作为SinceUntil参数,仅获取在仪表板所选时间范围内创建的事件。如果您想查询所有事件,请清除SinceUntil参数。您还可以提供其他参数,例如事件紧迫性或状态、服务ID、团队ID等。

在查询单个事件的数据时,您需要填写事件ID。

您还可以通过在“选择字段”选择框下选择它们来筛选返回的字段。

注释

您可以使用注释在仪表板上可视化事件与其他数据之间的关系。有关如何使用注释的通用信息,请参阅文档

模板和变量

要添加新的PagerDuty查询变量,请参阅添加查询变量。使用您的PagerDuty数据源作为数据源,并在查询构建器中填写字段。

注意:在创建PagerDuty查询变量时,将在“选择字段”下选中的前两个字段分别用作变量标签和值。如果只选择一个字段,则将用于变量标签和值。例如,如果您想创建一个包含事件ID的变量,您可以在“选择字段”下选择titleid,这样事件标题将用作可读标签,而事件ID将用作值。

创建变量后,您可以在使用变量语法的PagerDuty查询中使用它。有关变量的更多信息,请参阅模板和变量

了解更多