仪表盘过滤器和变量都支持对各个图表数据进行附加的过滤筛选操作,便于您快速查看关键字段的统计分析数据。本文档介绍如何在仪表盘中添加过滤器或变量。
仪表盘中默认展示各个分析图表在指定时间范围的统计数据,展示的图表数据取决于图表对应的时间范围和检索分析语句。日志服务支持通过过滤器或变量实现仪表盘中的图表联动。创建过滤器或变量后,您可以通过指定字段的字段值对图表数据进行过滤,即查看关键字段的统计分析数据。例如,为访问日志相关的仪表盘设置多个过滤器,分别支持访问来源、客户端 IP、HTTP code 等字段的过滤和筛选,以便快速查看不同访问来源、客户端 IP 的相关数据分析结果。
日志服务支持通过过滤器、变量添加筛选条件。
[Key:Value] AND/NOT [search query] | [sql query]
,例如 code:500 AND ip:192.168.1.2
,表示在包含键值对 code: 500
的日志中检索 ip
字段为 192.168.1.2
的日志。说明
如果使用变量筛选图表数据,则添加图表时需在检索分析语句中添加变量占位符。变量语法为${{变量名|默认值}}
,例如id: ${{id|123}} | SELECT __time__ - __time__ %60 AS time, COUNT(*) AS PV GROUP BY time
。
每个仪表盘中,过滤器、变量和图表的数量之和不可超过 50。
设置基本配置。
配置 | 说明 |
---|---|
类型 | 过滤器类型。此处选择过滤器。 |
名称 | 过滤器名称。创建过滤器后不支持修改名称。 |
过滤方式 | 过滤的方式。支持设置为以下方式。
|
支持多选 | 使用过滤器时,Value 是否支持多选。默认为关闭状态,即不支持多选。开启时,可以选择多个 Value 作为过滤条件。多选时,过滤条件之间为或(or)关系。 |
设置过滤器字段。
配置 | 说明 |
---|---|
字段名 | 用于过滤的字段名。 |
字段别名 | 用于过滤的字段在过滤器中显示的别名。例如为字段 |
设置过滤器选项。
如果用于过滤的字段值是固定的,则配置静态值。反之则配置动态值。
配置 | 说明 |
---|---|
静态值 | 为过滤器字段设置静态值(Value)。日志服务会将此静态值添加到指定字段的字段值列表项中。支持添加多个静态值。每个静态值可添加以下配置:
|
动态值 | 为过滤器字段设置动态的值。日志服务将以所选日志主题的日志分析结果作为字段值的可选项。动态值可能是动态变化的,其实际值取决于设置的时间范围和检索分析语句等因素。 |
设置基本配置。
配置 | 说明 |
---|---|
类型 | 过滤器类型。此处选择变量。 |
名称 | 变量名称。创建变量后不支持修改名称。 |
设置变量字段。
参数 | 说明 |
---|---|
字段名 | 用于过滤的变量名。 |
字段别名 | 用于过滤的变量名的别名。例如为变量 |
设置变量选项。
如果用于过滤的变量值是固定的,则配置静态值。反之则配置动态值。
参数 | 说明 |
---|---|
静态值 | 为变量设置静态值。日志服务会将此静态值添加到指定变量的值列表项中。支持添加多个静态值。每个静态值可添加以下配置:
|
动态值 | 为变量设置动态的值。日志服务将以所选日志主题的日志分析结果作为变量值的可选项。动态值可能是动态变化的,其实际值取决于设置的时间范围和检索分析语句等因素。 |
例如您需要通过图表 A 查看不同时间间隔(例如每秒、每小时等)的网站访问量时,可添加一个时间间隔变量,无需手动修改检索分析语句。
在创建变量前,需先添加图表 A 。图表 A 对应的检索分析语句如下所示:
* | SELECT DATE_FORMAT(__time__ - __time__ % 60000, 'HH:mm:ss') AS time, count(*) AS PV GROUP BY time ORDER BY time
说明
__time__
为毫秒级时间戳,因此DATE_FORMAT(__time__ - __time__ % 60000, 'HH:mm:ss')
表示将时间对其到分钟。
创建变量的示例步骤如下:
在图表 A 的检索分析语句中,添加变量占位符${{interval|60000}}
。
* | SELECT DATE_FORMAT(__time__ - __time__ % ${{interval|60000}}, 'HH:mm:ss') AS time, count(*) AS PV GROUP BY time ORDER BY time
创建变量。
重要配置项示例如下:
使用变量。
创建变量后,仪表盘中将展示变量选项框,您可以通过变量选项框过滤图表数据。例如选择时间间隔为每小时,则图表 A 将展示每小时的网址访问数量。
例如图表 A 展示了每分钟的请求数量,当您需要查看请求方法维度的请求数量时,可添加一个请求方法过滤器,无需手动修改检索分析语句。
在创建过滤器前,需先添加图表 A 且图表 A 对应的检索分析语句如下:
* | SELECT DATE_FORMAT(__time__ - __time__ % 60000, 'HH:mm:ss') AS time, count(*) AS PV GROUP BY time ORDER BY time
说明
__time__
为毫秒级时间戳,因此 DATE_FORMAT(__time__ - __time__ % 60000, 'HH:mm:ss')
表示将时间对其到分钟。
创建过滤器的示例步骤如下:
*| SELECT DISTINCT Method
。添加过滤器和变量后,您可以在仪表盘中便捷使用过滤器和变量,也可以按需修改或删除过滤器和变量,详细说明请参考仪表盘常见操作。