文档中心

日志服务

添加仪表盘过滤器和变量

添加仪表盘过滤器

添加仪表盘过滤器

本章节介绍如何添加仪表盘过滤器及相关示例。

前提条件

已采集到日志数据，并配置了索引。详细说明请参考快速入门。

已创建仪表盘，并在仪表盘中添加了统计图表。详细说明请参考创建仪表盘和添加图表到仪表盘。

说明

每个仪表盘中，过滤器、变量和图表的数量之和不可超过 50。

添加过滤器步骤

登录日志服务控制台。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择常用功能 > 仪表盘。

在仪表盘列表中，单击目标日志项目下的仪表盘。

单击页面右上方设置图标。

在过滤器和变量页签中，单击添加过滤器。

在新建过滤器面板中，配置如下参数，单击新建过滤器。

参数	说明
过滤器名称	过滤器名称。创建过滤器后不支持修改名称。该名称仅用于过滤器管理，并显示在过滤器列表页面，不显示在仪表盘中。
过滤器别名（显示名）	在仪表盘中显示的过滤器别名。例如为字段 clientIP 设置别名客户端 IP，以便获得更好的仪表盘使用体验。
字段名	用于过滤的字段。日志服务把该字段作为过滤条件的 Key，对整个仪表盘进行过滤操作。您可以通过静态值或动态值参数配置该字段的值。
过滤方式	过滤的方式。支持设置为以下方式。 AND：取多个搜索结果的交集，即在图表的检索语句中增加指定过滤条件。实际生效的检索分析语句为[Value] AND [search query] \| [sql query]。 NOT：搜索结果不包含原图表指定的检索语句。实际生效的检索分析语句为[Value] NOT [search query] \| [sql query]。 Value 为您在静态值或动态值参数中配置的字段值。
支持多选	使用过滤器时，Value 是否支持多选。默认为关闭状态，即不支持多选。开启时，可以选择多个 Value 作为过滤条件。多选时，过滤条件之间为或（or）关系。Value 为您在静态值或动态值参数中配置的字段值。
静态值	为过滤器字段设置静态值（Value）。日志服务会将该静态值添加到指定字段的值列表项中。支持添加多个静态值，且各静态值顺序可通过拖动自由调整。每个静态值可添加以下配置：字段值：用于过滤的字段值。支持设置为星号（*），表示匹配所有的字段值。字段值别名：字段值在过滤器中显示的别名。可选。例如为字段值 zhangsan 设置别名张三。默认选中：过滤器中是否默认选中此字段。默认为关闭状态，即不选中。未开启支持多选时，只能为某一个值开启默认选中。
动态值	为过滤器字段设置动态的值。日志服务将以所选日志主题的检索分析结果作为字段值的可选项。动态值是动态变化的，其实际值取决于设置的时间范围和检索分析语句等因素。

添加请求方法过滤器示例

例如统计图表 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') 表示将时间对齐到分钟。

添加过滤器。

重要参数说明如下：

设置名称为method。

设置过滤器别名为请求方法。

设置字段名为Method。

勾选动态值，即通过检索分析语句从日志中提取 Method 字段值。对应的检索分析语句为 *| SELECT DISTINCT Method。

保存配置。

在设置页面右上角，单击保存。

使用过滤器。

添加过滤器后，仪表盘中将展示过滤器，您可以使用过滤器筛选图表数据。例如选择请求方法为POST，统计图表 A 将展示每分钟 POST 方法对应的请求数量。

相关操作

添加过滤器和变量后，您可以在仪表盘中便捷使用过滤器和变量，也可以按需修改或删除过滤器和变量，详细说明请参考仪表盘常见操作。

最近更新时间：2026.02.26 16:19:11

这个页面对您有帮助吗？

有用

有用

无用

无用