DQL 查询¶

击观测云控制台的快捷入口 > 查询工具即可打开查询查看器，或者您可以通过快捷键 Alt+Q 或 option+Q 直接打开查询工具。

点击 DQL 查询右侧的 简单查询、PromQL 查询 按钮即可切换查询方式。

DQL 语法¶

DQL 查询遵循如下的语法范式，各个部分之间的相对顺序不能调换，从语法角度而言，data-source 是必须的（类似于 SQL 中的 FROM 子句），其它部分都是可选的。

更多 DQL 语法介绍可参考文档 DQL 定义。

namespace::
    data-source
    target-clause
    filter-clause
    time-expr
    by-clause
    limit-clause
    offset-clause
    slimit-clause
    soffset-clause

示例说明¶

下面是一个简单的示例，通过 DQL 查询时序指标集 cpu 的字段 usage_idle (CPU空闲率)，以 host 来过滤筛选，同时以 host 来分组显示结果。其中 #{host} 是在观测云仪表板设置的视图变量，用于过滤筛选。

把上面的语句应用到观测云场景仪表版的图表查询中，下图结合表达式查询和 DQL 查询，展示最近 15 分钟 CPU 使用率。

DQL 函数¶

DQL 查询除了可以在场景仪表板中使用以外，我们还可以通过 DQL 函数来查询 DataKit 采集的各种数据，如数据来源、字段、标签等。

SHOW 函数¶

SHOW 函数用于展示各类数据。若对通过 DataKit 采集的数据来源、字段、标签等没有清晰的了解，可以在 DQL 查询查看器通过 SHOW 函数来查询。

下面通过 SHOW 函数查询“对象”和“日志”的来源、字段等数据。

更多函数介绍可参考文档 DQL 函数以及 DQL 外层函数。

show_object_source()¶

展示 object 数据的指标集合。

show_object_field()¶

展示对象的 fileds 列表。

show_object_label()¶

展示对象包含的标签信息。

show_logging_source()¶

展示日志数据的指标集合。

show_logging_field()¶

展示指定 source 下的所有 fileds 列表。

时间查询¶

在 DQL 查询语句中可以指定 [today]、[yesterday]、[this week]、[last week]、[this month]、[last month] 时间参数。

today：今日 0 点到当前时间；

yesterday：昨日 0 点到今日 0 点；

this week：本周一 0 点到当前时间；

last week：上周一 0 点到本周一 0 点；

this month：本月 1 号 0 点到当前时间；

last month：上月 1 号 0 点到本月 1 号 0 点；

写法示例¶

查询今天 0 点截止到现在的数据，没有时间间隔，返回一个数据点：

M::cpu:(avg(`useage`)) [today]

如：查询今天 0 点截止到现在的数据，以 5 分钟时间间隔返回聚合数据点：

M::cpu:(avg(`usage`)) [today:5m]

表达式计算内还可以支持查询两个不同时间段的数据做最终的结果计算。表达式里如果有多个不同的时间参数定义，如子查询 A 与子查询 B 语句中分别定义时间参数为 [today] 和 [yesterday]，最终数据返回值的时间将按照查询时的 now() 时间做填充，最终返回一个数据。

如果表达式里定义了时间间隔，且存在多个查询时间的时间点不一致的情况，如子查询 A 与子查询 B 语句中分别定义时间参数为 [today:5m] 和 [yesterday:5m]。此时数据点的时间对不上，无法进行加减乘除，观测云会默认返回值为空。

DQL 查询¶

相关操作¶

返回结果¶

JSON¶

查询历史¶