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

PagerDuty Grafana 数据源

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

要求

此插件有以下要求

安装插件

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

在 Grafana 中配置数据源

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

认证字段

此插件支持基于 API 密钥的认证。请访问REST API Keys 文档了解如何生成 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 查询中使用它。有关变量的更多信息,请参阅模板和变量

了解更多