视图变量¶

概述¶

观测云支持向视图中添加全局变量，当你想要在仪表板中，动态地完成图表的筛选，可以选择使用视图变量来实现。（注意：在切换视图变量时，下拉中仅支持显示前50个，可通过搜索查看其余变量）

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

若已添加过视图变量，顶部导航栏下面会显示视图变量名称，点击右侧「编辑」按钮，即可进入视图变量编辑页面。

视图变量支持的数据来源包括「指标」、「DQL」、「系统对象」、「自定义对象」、「日志」、「应用性能」、「用户访问」、「安全巡检」和「自定义」。

使用 DQL 可以实现查询变量和关联变量。(了解更多DQL函数说明)

【指标数据】建议使用该查询方式

语法	说明
show_measurement()	返回时序数据的指标集合
show_tag_key(from=["指标集名"])	返回指标集 tag 列表, 可以指定具体的指标
show_tag_value(from=['指标集名'], keyin=['标签名'])	返回数据库中指定 tag key 的 tag value 列表
show_object_source() _ `object`可替换为 logging/event/tracing/rum _	返回 object /log/keyevent/tracing /rum数据的指标集合，该函数不需要参数

SHOW_TAG_VALUE 函数示例：

##查询指标集 cpu 的 host 标签值列表
SHOW_TAG_VALUE(from=["cpu"],keyin=["host"])

基础设施、日志等【非指标数据】建议使用该方式

语法	说明
_数据源类型::数据来源:(distinct(`属性字段名`)){筛选条件} _	M/metric - 时序指标数据；O/object - 对象数据；L/logging - 日志数据；E/event - 事件数据；T/tracing - 追踪数据；R/rum - RUM 数据
R::view:(distinct(`app_id`))	返回web应用用户访问监测的app_id列表
R::view:(distinct(`env`)) {`app_id` = '#{appid}'}	变量联动，假使上一条查询的变量名设为`appid`，则返回上条变量中所选app_id对应的`evn`列表
R::view:(distinct(`env`)) {`app_id` = '8f05003ebccad062'}	返回`app_id=8f05003ebccad062`对应的`evn`列表

使用场景：两个变量 host（主机）、container_name（容器），选择host，自动显示该 Host 对应所有 Container 列表

变量1（主机名）：查询最近10分钟的容器主机列表
O::docker_containers:(distinct(host)) [10m]

变量2（容器名）：查询变量1中所选主机下的容器列表
O::docker_containers:(distinct(container_name)) {host=#{host}}[10m]

选择【指标集】以及对应的【标签】

选择【对象分类】以及对应的【属性字段】

自定义变量选项中的内容，每个选项之间用英文 “,” 隔开。

字段	描述
默认值	当前视图变量在仪表板中的初始变量。支持预览当前视图变量的全部变量，并选择在仪表板默认查看的初始变量。默认值列表最多显示50个变量，支持搜索查找更多
变量名	当前视图变量集合所属的变量名称
显示名	当前视图变量集合在仪表板中现实的名称

针对视图变量可以进行如下的高级配置：

功能	说明
拖动排序	通过鼠标悬浮（hover）至图标，可点击拖动视图变量，调节先后顺序
排序	针对查询返回的视图变量进行默认、升降、排序排列。
是否隐藏	开启该功能后，在非编辑模式下，该变量不可见