文档中心

交互事件

最近更新时间：2024.03.28 10:17:50

首次发布时间：2023.12.07 20:36:16

仪表盘中的统计图表支持设置交互事件，用于增加统计图表的交互效果。本文档介绍交互事件的基本类型。

背景信息

日志服务的部分统计图表支持设置交互事件，成功设置交互事件并将图表保存在仪表盘之后，在仪表盘中单击指定字段时会触发对应的交互效果。例如在仪表盘的表格中设置交互事件，指定字段 UV 的对应事件为打开日志主题，保存设置后，在仪表盘的表格中单击 UV 列的任意单元格，并在弹出悬浮窗中单击打开日志主题，页面将自动跳转到指定的日志主题检索分析页面中。
目前支持设置交互事件的图表类型包括表格、折线图、柱状图、饼图、直方图、单值图和统计图。支持的交互事件包括打开日志主题、打开仪表盘和自定义 HTTP 链接。

配置说明

在日志服务检索分析页面执行 SQL 语句之后，可以在统计图表页签中选择图表类型，并设置交互效果。将此图表保存在仪表盘之后，查看此仪表盘时即可按需触发对应的交互效果。

打开日志主题

在指定图表的交互事件页签中，单击添加字段并选择字段后，可以根据页面提示添加此字段的交互效果，例如添加事件打开日志主题，并在弹出页面中填写以下配置：

配置	说明
自定义名称	交互事件的名称，默认为`打开日志主题`。
请选择项目	日志主题所属的日志项目。
请选择Topic	指定日志主题。触发交互事件后，页面将自动跳转至指定的日志主题页面。
打开新窗口	是否在新窗口中打开指定日志主题。
时间范围	在仪表盘中触发交互效果，跳转到指定的日志主题查询分析页面后，预设的查询时间范围。支持设置为：继承当前查询时间：触发交互事件时此图表对应的查询时间范围。近1分钟等相对时间：指定的相对时间。今天等整点时间：指定的整点时间。
是否继承过滤	打开指定日志主题的查询分析页面时，是否继承当前仪表盘的过滤条件。开启后，仪表盘的过滤条件会以`AND`的方式添加到对应的查询分析语句之前。
检索分析语句	打开指定日志主题的检索分析页面时，默认使用此处指定的检索分析语句进行检索分析。您也可以单击添加变量，在检索分析语句中插入变量。插入变量后，日志服务将使用实际值替换变量。目前支持添加的变量为检索分析语句的所有结果字段。例如 `Area: ${{省份}} AND Method: ${{Method}}`表示筛选指定省份和请求方式的相关数据。

打开仪表盘

在指定图表的交互事件页签中，单击添加字段并选择字段后，可以根据页面提示添加此字段的交互效果，例如添加事件打开仪表盘，并在弹出页面中填写以下配置：

配置	说明
自定义名称	交互事件的名称，默认为`打开仪表盘`。
请选择项目	日志主题所属的日志项目。
请选择仪表盘	指定仪表盘。触发交互事件后，页面将自动跳转至指定的仪表盘页面。
打开新窗口	是否在新窗口中打开指定仪表盘。
时间范围	在仪表盘中触发交互效果，跳转到指定的日志主题查询分析页面后，预设的查询时间范围。支持设置为：继承当前查询时间：触发交互事件时此图表对应的查询时间范围。近1分钟等相对时间：指定的相对时间。今天等整点时间：指定的整点时间。
是否继承过滤	打开指定仪表盘页面时，是否继承当前仪表盘的过滤条件。开启后，仪表盘的过滤条件会添加到对应的过滤语句之后。
是否继承变量	打开指定仪表盘页面时，是否继承当前仪表盘的变量设置。
过滤语句	打开仪表盘时，此处指定的过滤语句将拼接到对应仪表盘的过滤语句之后。您也可以单击添加变量，在过滤语句中插入变量。插入变量后，日志服务会将变量值作为过滤条件。目前支持添加的变量为检索分析语句的所有结果字段。例如 `AND Method: ${{Method}} AND Area: ${{省份}}` 表示筛选指定省份和请求方式的相关数据。
动态变量	指定添加到目标仪表盘的动态变量。单击添加动态变量，并设置动态变量名和其值所在的列名，配置后，日志服务会自动将指定列对应的值动态同步到目标仪表盘中。最多可添加 5 个动态变量。
静态变量	指定添加到目标仪表盘的静态变量。单击添加静态变量，并设置静态变量名和其值所在的列名，配置后，日志服务会自动将固定的字段值同步到目标仪表盘中。最多可添加 5 个静态变量。

自定义 HTTP 链接

在指定图表的交互事件页签中，单击添加字段并选择字段后，可以根据页面提示添加此字段的交互效果，例如添加事件自定义 HTTP 链接，并在弹出页面中填写以下配置：

配置	说明
自定义名称	交互事件的名称，默认为`自定义 HTTP 链接`。
协议	链接的访问协议。
链接地址	目标链接地址。您也可以在链接地址中插入变量。目前支持添加的变量包括当前检索分析语句的所有结果字段。
是否转码	是否将链接中的 Query 参数进行 Encode 转码。
打开新窗口	是否在新窗口中打开指定日志主题。

配置示例

项目 user-log-project 下的日志主题 user-log 用于存放某网站的访问日志。创建一个仪表盘用于监控网站的访问数据，并将其命名为“访问性能监控大盘”。该仪表盘中可添加各种访问数据的监控图表，例如访问来源城市列表、访问量 Top5 页面列表、各种访问方法的占比数据等。
您还可以在仪表盘中为各类图表添加交互事件，例如为“城市访问列表”表格设置交互事件为“打开仪表盘”，打开的仪表盘中展示 PV 随时间分布的线图“访问量趋势图”。设置完成后，您在“城市访问列表”表格单击各个城市即可查看对应城市的PV趋势。
以该交互事件为例，相关的操作步骤如下。

创建仪表盘“访问性能指标监控”，并添加图表“访问量趋势图”。
“访问量趋势图”为 PV 随时间分布的折现图，对应的查询分析语句如下。
```
* | SELECT date_format(__time__, 'Y-M-d HH:mm') AS time , COUNT(*) as PV group by time order by time
```
图表配置如下：
在仪表盘“访问性能指标监控”中添加“城市访问列表”表格。
“城市访问列表”展示各个城市的访问 PV，其对应的查询分析语句如下。
```
* | SELECT Area as "省份", COUNT(*) as PV group by Area
```
为表格“城市访问列表”设置交互事件。
- 设置请选择仪表盘为“访问性能指标监控”。
- 设置过滤语句为 AND Area: ${{省份}}。
查看交互事件设置效果。
- 在“城市访问列表”表格中，单击“城市H”，然后选择查看当前省份数据，日志服务会打开仪表盘“访问性能监控指标”，并为其添加一个“Area:城市H”的过滤条件。
- “访问量趋势图”显示“城市H”对应的 PV 随时间的变化趋势。