图表查询¶
简介¶
图表查询是指依据用户自定义的数据查询以可视化布局显示数值数据并揭露重要数据关系的图形。在编辑图表时，您可以依据选择的图表类型，进行图表查询以及其他图表设置。每一个正确的查询都对应一个 JSON 文本，工作台内的 JSON 文本和图表查询可互相解析，帮助您洞察图表绘制详情。
数据查询¶
单个图表同时支持展示多种查询方式，包括简单查询、表达式查询、DQL 查询及 PromQL 查询。您可按需添加。
对于单查询图表如概览图、仪表盘、排行榜，简单查询可直接转换为表达式查询。
切换查询方式
简单查询和 DQL 查询可通过 按钮相互切换。切换后，若无法解析或者解析不完整：
- 在简单查询下未操作，直接切换回 DQL 查询则显示之前的 DQL 查询语句；
- 在简单查询下调整了查询语句，再次切换回 DQL 查询将按照最新的简单查询进行解析。
简单查询¶
简单查询支持对不同数据源的数据进行查询，并通过选择聚合函数、分组标签、Label、筛选条件等进行图表展示。
- 支持通过图表和查询中间的分隔条按钮进行上下拖动，展示更多的查询区域；
- 支持通过查询语句左侧的拖拽按钮进行上下拖动，调整查询的顺序。
数据源¶
数据源包括来自指标、日志、基础对象、自定义对象、事件、应用性能、用户访问、安全巡检、网络、Profile 的一系列数据组合。
| 选项 | 说明 |
|---|---|
| 指标 | 需要选择指标集和指标，一个指标集可包含多个指标，基础函数默认选中 Last by。结合图表类型，选择想要展示的指标进行查询。 |
| 日志/基础对象/自定义对象/事件/应用性能/用户访问/安全巡检/网络/ Profile | 系统对象、自定义对象和安全巡检需要选择分类和属性/标签，日志/事件/应用性能/用户访问需要选择来源和属性/标签，基础函数默认选中 Count by。 |
分组¶
分组查询支持选择不同的 标签 进行分组查询，数据按所选的标签项进行分组展示，支持选择多个标签（不超过三个）进行查询。
支持对分组后的查询做别名，在添加别名后，图例的名称也随之变化，方便更直观的区分相关指标。（目前支持本功能的图表有：时序图、饼图、柱状图、散点图、气泡图、漏斗图。）
Label¶
支持选择主机 Label 属性进行筛选显示。
前提条件:
在图表查询中选择 Label 之前，需在基础设施 > 主机中为主机设置 Label 属性。
更多详情，可参考主机。
Label 筛选：
在图表查询，点击 fx，选择Label 筛选、正选或者反选、以及在主机设置的Label 属性，如 dev，即可查询对应的主机数据。如下图：
筛选¶
支持通过标签进行筛选。点击漏斗图标，即可为该查询添加筛选条件，支持添加多个筛选条件，每个筛选条件之间可以有并且和或两种取值方式。
| 筛选条件 | 说明 | 支持的筛选条件类型 |
|---|---|---|
= |
等于 | Integer、Float、String |
!= |
不等于 | Integer、Float、String |
>= |
大于等于 | Integer、Float、String |
<= |
小于等于 | Integer、Float、String |
> |
大于 | Integer、Float、String |
< |
小于 | Integer、Float、String |
match |
包含 | String |
not match |
不包含 | String |
wildcard |
模糊匹配（支持除指标以外的日志类数据） | String |
not wildcard |
模糊不匹配（支持除指标以外的日志类数据） | String |
筛选条件内容中的
#{host}为视图变量，更多详情参考文档 视图变量。
函数¶
支持通过函数计算指标等数据源。点击 fx 图标，即可为该查询添加函数，支持添加多个函数。
聚合函数¶
UI 模式下支持选择如下聚合方式返回结果值。
在 DQL 模式下支持更多的聚合函数，可参考DQL 聚合函数。
| 聚合函数 | 说明 |
|---|---|
| last | 返回最新时间戳的值 |
| first | 返回最早时间戳的值 |
| avg | 返回字段的平均值。参数有且只有一个，参数类型是字段名 |
| min | 返回最小值 |
| max | 返回最大值 |
| sum | 返回字段值的和 |
| P50 | 返回第百分之 50 的字段值 |
| P75 | 返回第百分之 75 的字段值 |
| P90 | 返回第百分之 90 的字段值 |
| P99 | 返回第百分之 99 的字段值 |
| count | 返回非空字段值的汇总值 |
| count_distinct | 统计字段不同值的数量 |
| difference | 返回一个字段中连续的时间值之间的差异 |
| derivative | 返回一个字段在一个 series 中的变化率 |
| non_negative_derivative | 返回在一个 series 中的一个字段中值的变化的非负速率 |
转换函数¶
这里的转换函数又称为外层函数，UI 模式下支持选择的函数如下所示：
在 DQL 模式中支持更多的外部函数，可参考DQL 外层函数。
| 转换函数（外层函数） | 说明 |
|---|---|
| cumsum | 对处理集累计求和 |
| abs | 计算处理集每个元素的绝对值 |
| log2 | 计算处理集每个元素以 2 为底数的对数，处理集至少大于一行，否则返回空值 |
| log10 | 计算处理集每个元素以 10 为底数的对数，处理集至少大于一行，否则返回空值 |
| moving_average | 计算处理集的移动平均值，窗口的大小需要不小于处理集的行数，否则返回空值 |
| difference | 计算处理集相邻元素的差值，处理集至少大于一行，否则返回空值 |
| derivative | 计算处理集相邻元素的导数，求导的时间单位为秒（s） |
| non_negative_derivative | 计算处理集相邻元素的非负导数，求导的时间单位为秒（s） |
| non_negative_difference | 计算处理集相邻元素的非负差值，处理集至少大于一行，否则返回空值 |
| series_sum | 当分组产生多个 series, 根据时间点，合并为1个series。其中，相同时间点的多个 series 求和，处理集至少大于一行，否则返回空值 |
| rate | 计算某个指标一定时间范围内的变化率，适合缓慢变化的计数器。时间单位为秒（s） |
| irate | 计算某个指标一定时间范围内的变化率，适合快速变化的计数器，时间单位为秒（s） |
窗口函数¶
支持以选定的时间间隔为窗口（记录集合），结合聚合函数对每条记录都执行统计计算，支持选择1分钟、5分钟、15分钟、30分钟、1小时、3小时等。
注意：窗口函数查询结果并不会改变记录条数，当前存在的记录数量在执行完函数结果后，仍保持之前的记录数量。
无数据填充¶
支持设定空值数据的填充方式，设定后在查询中显示为 fill，包括三种类型：
| 函数 | 说明 |
|---|---|
| 前值填充（previous） | 前值填充是将空值数据转为上一个数值 |
| 线性填充（linear） | 线性填充是将空值数据进行线性函数计算后填充 |
| 数值填充 | 数值填充是可自定义填充数值 |
别名¶
支持添加自定义名称，点击 AS，即可添加别名。
隐藏查询¶
点击隐藏图标，即可隐藏图表上的该条查询结果。从下图可以看出，系统加载数据只显示1分钟和15分钟的查询结果，5分钟的系统加载查询结果已经被隐藏，无法在图表上查看。
复制 / 删除查询¶
点击复制 / 删除图标，即可复制 / 删除该条查询。
预设字段查询¶
若工作空间无数据上报，在配置图表查询时无法选择数据，可在查询中预设字段值，默认为数值类型，按数值类型显示 聚合函数。
DQL 查询¶
在图表查询过程中，当简单查询已无法满足您的需求时，您可以通过点击 切换到 DQL 模式，手动输入 DQL 语句进行图表查询，任意点击屏幕即可执行查询语句并刷新图表，系统将提示错误的 DQL 查询语句。
DQL 是专为观测云开发的语言，一个图表同时支持多条 DQL 查询。详情参见 DQL 查询。
PromQL 查询¶
观测云支持切换到 PromQL 查询模式，通过书写 PromQL 查询获取数据。点击 添加 PromQL 查询，即可执行查询语句。
注意：PromQL 添加后默认是文本框输入，仅支持复制、查看、删除操作。此输入框既可以输入 PromQL 简单查询也可以输入表达式查询。
关于 PromQL，您也许想了解 DQL 与其它几种查询语言的对比；或前往 PromQL了解更多相关知识。
表达式查询¶
表达式查询通过添加表达式进行计算。若表达式查询中包含多个查询语句，分组标签需保持一致。在表达式计算中，若查询 A 带单位，查询 A 与数字的运算结果同样带单位。例如：A 的单位是 KB，那么 A+100 的单位也是 KB。
时间分片¶
开启时间分片¶
时间分片一般和时间间隔配合使用，开启时间分片后，会先对原始数据按照一定的时间间隔进行分段聚合，再对聚合后数据集进行第二次聚合得到结果值。
在下面的概览图示例中，首先是把最近一小时内活跃的内存按照 5 分钟为时间间隔聚合得到 12 个平均值，然后取其中最大值在图表上展示。
关闭时间分片¶
若未开启时间分片，所有采集上来的原始数据根据选择的函数进行聚合得到结果值。
在下面的概览图示例中，把最近一小时内活跃的内存取其平均值在图表上展示。
图表千分位¶
观测云仪表板图表查询结果支持自动加上数据千分位格式显示。
若设置了单位，则按照设置的单位显示数据格式。
设置完成后可以在预览的情况下按照千分位数据格式显示，若设置单位则按照单位设置格式显示。
- 千分位数据格式显示：
- 设置的数据格式显示：
