tencent cloud

文档反馈

过滤与变量

最后更新时间:2024-01-20 17:31:31

    类型说明

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

    过滤

    下拉选项过滤配置

    2. 在左侧导航栏中,单击仪表盘,进入仪表盘管理页面。
    3. 单击需要操作的仪表盘 ID/名称,进入该仪表盘详情页面。
    4. 单击顶部的新增过滤与变量打开设置页面。
    5. 在弹出的窗口中,设置下拉选项过滤配置,单击确定
    表单元素
    说明
    类型
    不同的类别对应不同的配置项与应用场景,此处选择下拉选项过滤。
    过滤器别名
    界面上过滤器的显示名称,非必填项目,空置时自动使用过滤字段为显示名称。
    日志主题
    过滤字段来源的日志主题。
    过滤字段
    过滤的对象字段。
    动态选项
    开启后,自动获取过滤字段的值作为过滤选项。
    静态选项
    手动添加过滤项,静态过滤项将常驻显示,支持配置别名,非必填项目。
    默认过滤
    用于配置查看仪表盘时的默认过滤项,非必填项目。
    支持多选
    开启后可以选择多个过滤项作为过滤条件。
    6. 返回仪表盘详情页面,单击过滤器,选择过滤项,仪表盘数据将刷新为过滤后内容。

    检索语句过滤配置

    2. 在左侧导航栏中,单击仪表盘,进入仪表盘管理页面。
    3. 单击需要操作的仪表盘 ID/名称,进入该仪表盘详情页面。
    4. 单击顶部的新增过滤与变量打开设置页面。
    5. 在弹出的窗口中,设置检索语句过滤信息,单击提交
    表单元素
    说明
    类型
    不同的类别对应不同的配置项与应用场景,此处选择检索语句过滤。
    过滤器名称
    过滤器的名称,名称唯一,不能重复。
    过滤器别名
    界面上过滤器的显示名称,非必填项目。
    日志主题
    过滤字段来源的日志主题。
    模式
    检索语句的输入模式,支持交互模式与语句模式两种。
    默认过滤
    用于配置查看仪表盘时的默认过滤项,非必填项目。
    6. 返回仪表盘详情页面,单击过滤器,选择过滤项,仪表盘数据将刷新为过滤后内容。检索语句过滤支持:范围过滤、NOT 过滤、全文检索等更丰富的过滤方式

    变量

    数据源变量配置

    2. 在左侧导航栏中,单击仪表盘,进入仪表盘管理页面。
    3. 单击需要操作的仪表盘 ID/名称,进入该仪表盘详情页面。
    4. 单击顶部的新增过滤与变量打开设置页面。
    5. 在弹出的窗口中,设置模板变量信息,单击提交
    表单元素
    说明
    变量类型
    变量的类别,不同的类别对应不同的配置项与应用场景,此处选择数据源变量。
    变量名称
    查询检索语句中变量的命名,仅支持字母与数字。
    显示名称
    仪表盘上变量的显示名称,非必填项目,为空时自动使用变量名称为显示名称。
    数据源范围
    变量值的可选范围,默认为“所有日志主题”。可选择“自定义过滤”,设置过滤条件,只查看符合条件的日志主题。
    默认日志主题
    默认使用的日志主题。
    6. 返回仪表盘详情页面,单击更多 > 编辑图表
    说明:
    如果您的仪表盘中没有图表,请 添加图表
    7. 在编辑图表检索语句内,单击日志主题,勾选使用数据源变量,选择刚新建的模板变量。
    8. 单击保存
    9. 返回仪表盘详情页面,单击上方的数据源变量下拉框,将日志主题切换为其他日志主题,使用该变量的图表将自动切换数据源。

    自定义变量配置

    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. 返回仪表盘详情页面,并在该页面顶部单击数据源变量“应用环境”,在该变量的下拉菜单中切换日志主题。同时,使用该变量的图表也将切换日志主题。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持