菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow 管理breadcrumb arrow 关联breadcrumb arrow 创建新的关联
Enterprise 版 开源版

创建新的关联

开始之前

请确保您有添加新关联的权限。只有对数据源具有写入权限的用户才能定义新的关联。

在 Explore 的关联编辑器中创建关联

要了解更多信息,请参考 Explore 的文档关于在 Explore 中构建关联。

在管理页面中创建关联

  1. 转到 Grafana 中的管理部分。
  2. 插件和数据下,打开关联页面。
  3. 点击右上角的“添加”按钮。
  4. 提供一个标签作为关联的标签。
  5. 提供可选的描述
  6. 转到下一页。
  7. 提供目标数据源
  8. 提供目标查询,使用变量。
  9. 转到下一页。
  10. 提供源数据源
  11. 提供结果字段
  12. 如果您需要源数据源中不是字段的变量,请添加转换。
  13. 点击“添加”以添加新的转换。
  14. 选择转换类型。
  15. 根据所选类型配置转换。
  16. 保存关联。

您可以按相同方式编辑关联,但不能更改所选的数据源。

通过配置创建关联

通过扩展已配置的数据源来配置关联。关联被定义为源数据源配置的一个子部分

yaml
datasources:
  - name: Data source name # source data source
    ...
    jsonData:
    ...
    correlations:
      - targetUID: uid
        label: "test"
        description: "..."
        config:
          type: "query"
          target:
            expr: "..."
          field: "name"
          transformations:
            - type: regex
              field: "test"
              expression: /\w+/
              mapValue: "other"
            - type: logfmt
              field: "test"

配置属性说明

targetUID
目标数据源 UID
label
链接标签
description
可选描述
config
配置对象
config.type
关联类型。“query”是目前唯一支持的类型
config.target
目标查询模型
config.field
显示链接的字段名称
config.transformations (list)
转换对象列表
transformation.type
regex 或 logfmt
transformation.field
将被转换的字段。如果未定义此字段,将对关联的 config.field 中的数据应用转换。
transformation.expression
Regex 表达式 (仅适用于 regex 转换)
transformation.mapValue
来自第一个 regex 匹配的新变量名称 (仅适用于 regex 转换)

确定目标查询模型结构

当您在管理页面设置关联时,可以使用目标查询编辑器。使用配置时,您可能需要了解目标查询的结构,该结构可能因插件而异,文档可能不完善。这里提供一个快速分步指南,说明如何确定目标查询模型

  1. 打开 Explore。

  2. 选择要用作关联目标的数据源。

  3. 打开检查器选项卡并选择“查询”。

  4. 运行一个示例查询。

  5. 检查结果。

  6. 查找“queries”列表对象。每个对象都是使用数据源定义的查询模型结构创建的。您可以在配置文件中使用相同的结构。

    Query inspector with target query structure
    带有目标查询结构的查询检查器

    此示例中的查询模型由 queries 列表中的第一个条目表示。“refId”和“datasource”属性在运行时添加到所有查询中,可以省略

    json
    {
      "scenario_id": "random_walk",
      "alias": "app",
      "seriesCount: 2
    }