创建新的关联
开始之前
请确保您有添加新关联的权限。只有对数据源具有写入权限的用户才能定义新的关联。
在 Explore 的关联编辑器中创建关联
要了解更多信息,请参考 Explore 的文档关于在 Explore 中构建关联。
在管理页面中创建关联
- 转到 Grafana 中的管理部分。
- 在插件和数据下,打开关联页面。
- 点击右上角的“添加”按钮。
- 提供一个标签作为关联的标签。
- 提供可选的描述。
- 转到下一页。
- 提供目标数据源。
- 提供目标查询,使用变量。
- 转到下一页。
- 提供源数据源。
- 提供结果字段。
- 如果您需要源数据源中不是字段的变量,请添加转换。
- 点击“添加”以添加新的转换。
- 选择转换类型。
- 根据所选类型配置转换。
- 保存关联。
您可以按相同方式编辑关联,但不能更改所选的数据源。
通过配置创建关联
通过扩展已配置的数据源来配置关联。关联被定义为源数据源配置的一个子部分
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 转换)
确定目标查询模型结构
当您在管理页面设置关联时,可以使用目标查询编辑器。使用配置时,您可能需要了解目标查询的结构,该结构可能因插件而异,文档可能不完善。这里提供一个快速分步指南,说明如何确定目标查询模型
打开 Explore。
选择要用作关联目标的数据源。
打开检查器选项卡并选择“查询”。
运行一个示例查询。
检查结果。
查找“queries”列表对象。每个对象都是使用数据源定义的查询模型结构创建的。您可以在配置文件中使用相同的结构。
带有目标查询结构的查询检查器 此示例中的查询模型由 queries 列表中的第一个条目表示。“refId”和“datasource”属性在运行时添加到所有查询中,可以省略
{ "scenario_id": "random_walk", "alias": "app", "seriesCount: 2 }