动态与公告

产品动态

公告

新手指引

产品简介

产品概述

产品优势

地域和访问域名

规格与限制

基本概念

购买指南

计费概述

产品定价

按量计费（后付费）

欠费说明

清理日志服务资源

成本优化

常见问题

快速入门

一分钟入门指南

入门指南

使用 Demo 日志快速体验 CLS

操作指南

资源管理

权限管理

日志采集

指标采集

日志存储

指标存储

检索分析（日志主题）

检索分析（指标主题）

仪表盘

数据处理

投递与消费

监控告警

云产品中心

DataSight 独立控制台

历史文档

实践教程

日志采集

检索分析

仪表盘

监控告警

投递和消费

成本优化

开发者指南

通过 iframe 内嵌 CLS（旧方案）

通过 Grafana 使用 CLS

API 文档

History

Introduction

API Category

Making API Requests

Topic Management APIs

Log Set Management APIs

Index APIs

Topic Partition APIs

Machine Group APIs

Collection Configuration APIs

Log APIs

Metric APIs

Alarm Policy APIs

Data Processing APIs

Kafka Protocol Consumption APIs

CKafka Shipping Task APIs

Kafka Data Subscription APIs

COS Shipping Task APIs

SCF Delivery Task APIs

Scheduled SQL Analysis APIs

COS Data Import Task APIs

Data Types

Error Codes

常见问题

健康监测问题解释

采集相关

检索分析相关

其他问题

服务等级协议

CLS 政策

隐私协议

数据处理和安全协议

联系我们

词汇表

过滤与变量

PDF

聚焦模式

字号

最后更新时间： 2026-01-07 15:50:13

类型说明
类型
说明
生效范围
下拉选项过滤
通过指定字段的字段值对仪表盘内所有图表的数据进行过滤。过滤字段在日志主题索引配置内开启统计时，可自动获取字段的值作为列表项
仪表盘内所有图表
检索语句过滤
通过输入检索语句对仪表盘内所有图表的数据进行过滤，相当于在各图表查询语句中增加了过滤条件。检索语句过滤支持 范围过滤、NOT 过滤、全文检索等更丰富的过滤方式
仪表盘内所有图表
数据源变量
数据源变量支持批量切换仪表盘内图表的数据源，适用于一个仪表盘应用到多个日志主题、仪表盘内数据进行蓝绿对比等场景
仪表盘内使用该变量的图表
自定义变量
自定义变量支持用户自己设置静态输入或动态查询的变量值，替换到检索语句、标题、文本图表中，实现快捷的语句批量修改。
仪表盘内使用该变量的图表
过滤
下拉选项过滤配置
1. 登录 日志服务控制台。
2. 在左侧导航栏中，单击仪表盘，进入仪表盘管理页面。
3. 单击需要操作的仪表盘 ID/名称，进入该仪表盘详情页面。
4. 单击顶部的新增过滤与变量打开设置页面。
5. 在弹出的窗口中，设置下拉选项过滤配置，单击确定。
表单元素
说明
类型
不同的类别对应不同的配置项与应用场景，此处选择下拉选项过滤。
过滤器别名
界面上过滤器的显示名称，非必填项目，空置时自动使用过滤字段为显示名称。
日志主题
过滤字段来源的日志主题。
过滤字段
过滤的对象字段。
动态选项
开启后，自动获取过滤字段的值作为过滤选项。
静态选项
手动添加过滤项，静态过滤项将常驻显示，支持配置别名，非必填项目。
默认过滤
用于配置查看仪表盘时的默认过滤项，非必填项目。
支持多选
开启后可以选择多个过滤项作为过滤条件。
6. 返回仪表盘详情页面，单击过滤器，选择过滤项，仪表盘数据将刷新为过滤后内容。
检索语句过滤配置
1. 登录 日志服务控制台。
2. 在左侧导航栏中，单击仪表盘，进入仪表盘管理页面。
3. 单击需要操作的仪表盘 ID/名称，进入该仪表盘详情页面。
4. 单击顶部的新增过滤与变量打开设置页面。
5. 在弹出的窗口中，设置检索语句过滤信息，单击提交。
表单元素
说明
类型
不同的类别对应不同的配置项与应用场景，此处选择检索语句过滤。
过滤器名称
过滤器的名称，名称唯一，不能重复。
过滤器别名
界面上过滤器的显示名称，非必填项目。
日志主题
过滤字段来源的日志主题。
模式
检索语句的输入模式，支持交互模式与语句模式两种。
默认过滤
用于配置查看仪表盘时的默认过滤项，非必填项目。
6. 返回仪表盘详情页面，单击过滤器，选择过滤项，仪表盘数据将刷新为过滤后内容。检索语句过滤支持：范围过滤、NOT 过滤、全文检索等更丰富的过滤方式。
变量
数据源变量配置
1. 登录 日志服务控制台。
2. 在左侧导航栏中，单击仪表盘，进入仪表盘管理页面。
3. 单击需要操作的仪表盘 ID/名称，进入该仪表盘详情页面。
4. 单击顶部的新增过滤与变量打开设置页面。
5. 在弹出的窗口中，设置模板变量信息，单击提交。
表单元素
说明
变量类型
变量的类别，不同的类别对应不同的配置项与应用场景，此处选择数据源变量。
变量名称
查询检索语句中变量的命名，仅支持字母与数字。
显示名称
仪表盘上变量的显示名称，非必填项目，为空时自动使用变量名称为显示名称。
数据源范围
变量值的可选范围，默认为“所有日志主题”。可选择“自定义过滤”，设置过滤条件，只查看符合条件的日志主题。
默认日志主题
默认使用的日志主题。
6. 返回仪表盘详情页面，单击更多 > 编辑图表。
说明：
如果您的仪表盘中没有图表，请 添加图表。
7. 在编辑图表检索语句内，单击日志主题，勾选使用数据源变量，选择刚新建的模板变量。
8. 单击保存。
9. 返回仪表盘详情页面，单击上方的数据源变量下拉框，将日志主题切换为其他日志主题，使用该变量的图表将自动切换数据源。
自定义变量配置
1. 登录 日志服务控制台。
2. 在左侧导航栏中，单击仪表盘，进入仪表盘管理页面。
3. 单击需要操作的仪表盘 ID/名称，进入该仪表盘详情页面。
4. 单击顶部的新增过滤与变量打开设置页面。
5. 在弹出的窗口中，设置自定义变量信息，单击提交。
表单元素
说明
类型
变量的类别，不同的类别对应不同的配置项与应用场景，此处选择数据源变量。
变量名称
查询检索语句中变量的命名，仅支持字母与数字。通过${变量名称}的格式引用变量。
变量别名
查仪表盘上变量的显示名称，非必填项目，为空时自动使用变量名称为显示名称。
静态变量值
手动添加静态变量值，静态变量值将常驻显示，支持配置别名。
动态变量值
开启后，可以选择一个日志主题并输入检索分析语句，取检索分析的结果作为可选变量值。
默认值
默认使用变量值，为必填项。
6. 返回仪表盘详情页面，单击更多 > 编辑图表。
说明：
 如果您的仪表盘中没有图表，请 添加图表。
7. 在编辑图表检索语句内，插入刚才创建的自定义变量${interval} ，替换原始的文本。
8. 单击应用到仪表盘。
9. 返回仪表盘详情页面，单击上方的时间颗粒度变量下拉框，修改时间颗粒度，发现插入该变量的图表发生对应的变更。
常见问题
配置并使用数据源变量后，为什么没有生效，或只有部分图表生效？
数据源变量并不会直接针对仪表盘内所有图表生效，只有在图表编辑页面中使用了该变量的图表才会生效。
使用案例
在仪表盘内分析不同应用接口的性能指标（下拉选项过滤）
需求场景
日志主题 A 为某应用的 nginx 访问日志，需要通过仪表盘查看该应用整体及指定某个接口的吞吐量、错误请求数和响应时间。样例日志如下：
body_bytes_sent:1344
client_ip:127.0.0.1
host:www.example.com
http_method:POST
http_referer:www.example.com
http_user_agent:Mozilla/5.0
proxy_upstream_name:proxy_upstream_name_4
remote_user:example
req_id:5EC4EE87A478DA3436A79550
request_length:13506
request_time:1
http_status:201
time:27/Oct/2021:03:25:24
upstream_addr:219.147.70.216
upstream_response_length:406
upstream_response_time:18
upstream_status:200
interface:proxy/upstream/example/1
解决方案
1. 创建仪表盘。
2. 针对应用性能指标，分别创建三个图表（时序图）。其对应的查询语句分别如下：
吞吐量：
* | select histogram( cast(__TIMESTAMP__ as timestamp),interval 1 minute) as analytic_time, count(*) as pv group by analytic_time order by analytic_time limit 1000
错误请求数：
http_status:>=400 | select histogram( cast(__TIMESTAMP__ as timestamp),interval 1 minute) as analytic_time, count(*) as pv_lost group by analytic_time order by analytic_time limit 1000
平均响应时间：
* | select histogram( cast(__TIMESTAMP__ as timestamp),interval 1 minute) as analytic_time, avg(request_time) as response_time group by analytic_time order by analytic_time limit 1000
3. 添加下拉选项过滤。
类型：下拉选项过滤
显示名称：接口名称
日志主题：日志主题 A
字段选择：interface
4. 返回仪表盘详情页面，即可在页面顶部看到该变量。
接口名称没有指定值时，表示不进行数据过滤，仪表盘内各个图表展示的是全部数据，即应用的整体性能指标。
接口名称指定具体值时，仪表盘内所有图表以该接口作为过滤条件进行数据过滤，展示该接口的性能指标。
在仪表盘内分别查看生产环境及测试环境的性能指标（数据源变量）
需求场景
某应用具备生产环境及测试环境，分别将日志采集到“日志主题 A（生产环境）”和“日志主题 B（测试环境）”中。因此，在应用的开发、测试及运维过程中，需要同时关注两个环境的性能指标。
解决方案
1. 创建仪表盘。
2. 添加模板变量。
变量类型：数据源
变量名称：env
显示名称：应用环境
数据源范围：所有日志主题
默认日志主题：日志主题 A（生产环境）
3. 添加图表。
在日志主题下拉菜单中，勾选“使用数据源变量”，选择上一步中创建的${env}变量。图表将使用该变量的值作为当前图表的数据源，即日志主题 A（生产环境）。
4. 重复执行步骤3，添加其他图表。
5. 返回仪表盘详情页面，并在该页面顶部单击数据源变量“应用环境”，在该变量的下拉菜单中切换日志主题。同时，使用该变量的图表也将切换日志主题。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

类型	说明	生效范围
下拉选项过滤	通过指定字段的字段值对仪表盘内所有图表的数据进行过滤。过滤字段在日志主题索引配置内开启统计时，可自动获取字段的值作为列表项	仪表盘内所有图表
检索语句过滤	通过输入检索语句对仪表盘内所有图表的数据进行过滤，相当于在各图表查询语句中增加了过滤条件。检索语句过滤支持范围过滤、NOT 过滤、全文检索等更丰富的过滤方式	仪表盘内所有图表
数据源变量	数据源变量支持批量切换仪表盘内图表的数据源，适用于一个仪表盘应用到多个日志主题、仪表盘内数据进行蓝绿对比等场景	仪表盘内使用该变量的图表
自定义变量	自定义变量支持用户自己设置静态输入或动态查询的变量值，替换到检索语句、标题、文本图表中，实现快捷的语句批量修改。	仪表盘内使用该变量的图表

表单元素	说明
类型	不同的类别对应不同的配置项与应用场景，此处选择下拉选项过滤。
过滤器别名	界面上过滤器的显示名称，非必填项目，空置时自动使用过滤字段为显示名称。
日志主题	过滤字段来源的日志主题。
过滤字段	过滤的对象字段。
动态选项	开启后，自动获取过滤字段的值作为过滤选项。
静态选项	手动添加过滤项，静态过滤项将常驻显示，支持配置别名，非必填项目。
默认过滤	用于配置查看仪表盘时的默认过滤项，非必填项目。
支持多选	开启后可以选择多个过滤项作为过滤条件。

表单元素	说明
变量类型	变量的类别，不同的类别对应不同的配置项与应用场景，此处选择数据源变量。
变量名称	查询检索语句中变量的命名，仅支持字母与数字。
显示名称	仪表盘上变量的显示名称，非必填项目，为空时自动使用变量名称为显示名称。
数据源范围	变量值的可选范围，默认为“所有日志主题”。可选择“自定义过滤”，设置过滤条件，只查看符合条件的日志主题。
默认日志主题	默认使用的日志主题。

tencent cloud

日志服务

过滤与变量

类型说明

过滤

下拉选项过滤配置

检索语句过滤配置

变量

数据源变量配置

自定义变量配置

常见问题

使用案例

在仪表盘内分析不同应用接口的性能指标（下拉选项过滤）

需求场景

解决方案

在仪表盘内分别查看生产环境及测试环境的性能指标（数据源变量）

需求场景

解决方案

帮助和支持