视图变量¶

简介¶

观测云支持向视图中添加全局变量，当您想要在仪表板中，动态地完成图表的筛选，可以选择使用视图变量来实现。

添加视图变量¶

在仪表板中，若未添加过视图变量，顶部导航栏显示添加视图变量按钮，点击即可进入添加视图变量。

配置说明¶

字段说明¶

注意：若工作空间无数据上报，在配置视图变量时无法选择数据，可在配置时预设字段，数据正常上报后，会自动匹配字段。

操作说明¶

变量查询¶

视图变量支持 DQL 查询、UI 查询、自定义三种查询方式。

取值范围¶

视图变量的取值范围有两种方式：

跟随仪表板联动，即根据仪表板的时间控件所选的时间范围列出变量查询的数据；
不跟随仪表板联动，即列出变量查询的所有数据，不受仪表板时间控件所选的时间范围影响。

下面是不同数据来源变量查询的取值范围说明：

DQL 查询¶

在 DQL 查询过程中，支持用户直接手写 DQL 语句，查询返回对应的数据值，您可以在查询中添加时间范围筛选和配置级联查询。

点击 了解更多 DQL 定义和语法。

DQL 语句查询示例：

注意：基础设施、日志等非指标数据建议使用该方式。

添加时间范围说明¶

视图变量使用 DQL 语句查询时，支持以 [xx:xx:xx] 的格式添加数据查询的时间范围：

• 若在 DQL 查询中添加了时间范围，则优先使用 DQL 查询中的时间范围；
• 若在 DQL 查询中未添加时间范围，则默认使用仪表板时间控件所选的时间范围。

示例：

# 查询最近 10 分钟的容器主机列表 
O::docker_containers:(distinct(`host`)) [10m]

Show 函数查询¶

在使用 DQL 查询时，支持使用 Show 函数来查询返回对应的数据值，Show 函数不支持添加时间范围筛选。

点击 了解更多 DQL 函数说明。

Show 函数查询示例：

注意：指标数据建议使用该查询方式。

UI 查询¶

在 UI 查询中，支持选择指标、基础对象、自定义对象、日志、应用性能、用户访问、安全巡检数据来源，通过直接在 UI 上点击选择查询变量，查询返回对应的数据值。

在 UI 查询中，您无法添加时间范围和配置 级联查询。

自定义查询¶

自定义是指用户可以直接定义一组数值用于视图变量使用，无需通过查询语句获取相关值；自定义变量选项中的内容，每个选项之间用英文 “,” 隔开。自定义查询不支持添加时间范围和配置级联查询。

级联查询¶

当需要配置两个以上视图变量，且第二个视图变量需要基于第一个视图变量查询的结果的来进行联动查询时，可以使用级联查询，以此类推，级联查询可以支持多个视图变量的联动查询。

注意：级联查询仅支持 DQL 语句来进行查询配置。

级联查询示例说明¶

下面以用户访问监测配置 Web 应用概览视图变量级联筛选为例，需要基于应用 ID、环境和版本进行联动查询。

配置说明：

应用 ID、环境和版本有三个变量，故需要在仪表板配置三条变量查询语句。在第二和第三条查询语句使用上一级配置的 #{变量名} ，即可完成级联查询配置。

变量 1（应用 ID）：查询应用名称为 df_web_rum_sdk 的应用列表：

R::view:(distinct(`app_id`)){sdk_name = 'df_web_rum_sdk'}

变量 2（环境）：查询应用名称为 df_web_rum_sdk，且变量 1 中所选应用 ID 下的环境列表：

R::view:(distinct(`env`)) {app_id = '#{appid}' and sdk_name = 'df_web_rum_sdk'}

变量 3（版本）：查询应用名称为 df_web_rum_sdk，且变量 2 中所选环境下的版本列表：

R::view:(distinct(`version`)) {app_id = '#{appid}' and env = '#{env}'  and sdk_name = 'df_web_rum_sdk'}

级联查询逻辑运算符说明¶

添加对象映射¶

针对基础设施对象数据可以设置字段映射，字段映射只是用作显示，不会影响原字段数据。

选择数据来源、对象分类。以及需要映射的两个属性字段。如下图所示：将 container_id 映射显示为 container_name。

场景示例¶

视图变量配置应用示例¶

1、视图变量创建完成后，要在图表中关联此变量，实现图表与视图变量的联动筛选。

1）在图表查询中，筛选字段时，value值选中该变量即可。(此处下拉中显示的是变量名)

2）在场景视图中切换变量值，图表将根据变量标签进行筛选展示.

2、在图表中，选中特定时间线或数据点，可直接点击实现反向添加，实现全局联动查看选中值相关的图表数据分析。

1）点击特定时间线或数据点后，在显示的卡片中点击应用到视图变量下的设置条件。

2）即可填充到仪表板的视图变量中。效果显示如下：

对象映射配置应用示例¶

对象映射可以应用在两个地方：视图变量的下拉显示中和图表的显示中。

在视图变量中应用¶

在视图变量中添加对象的【属性字段】，若该字段同样设置了字段映射，那么在视图变量中显示为：映射的字段（查询的字段）。

举例说明：

1）在【视图变量】中添加了 container_id 变量（如下图所示）。

2）在【对象映射】中设置 container_id 映射为 container_name。

3）此时在视图中变量显示为：container_name(container_id)。

在图表中应用¶

在图表中查询了对象的【属性字段】，并在设置中开启【字段映射】，若该字段同样设置了字段映射，那么在图表变量中显示为：映射的字段（查询的字段）。

举例说明：

1）在对象映射中设置 host 映射为 name（如下图所示）：

2）在图表查询中使用该字段，并且在设置中开启字段映射，那么在图表中显示格式为 name(host)。