用户访问指标检测

---

概述

「用户访问指标检测」用于监控工作空间内「用户访问监测」的指标数据，通过设置阈值范围，当指标到达阈值后触发告警，支持对单个指标设置告警和自定义告警等级。

应用场景

支持监控包括 Web、Android、iOS、Miniapp 应用类型的指标数据。例如可以监控 web 端 基于城市维度的 JS 错误率。

规则说明

在「监控器」中，点击「+新建监控器」，选择「用户访问指标检测」，进入检测规则的配置页面。

步骤1.检测配置

1）检测频率：检测规则的执行频率，包含1m/5m/15/30m/1h/6h（默认选中5m）。

2）检测区间：每次执行任务时，检测指标查询的时间范围。受检测频率影响，可选检测区间会有不同。（支持用户自定义）

检测频率	检测区间（下拉可选项）	自定义区间限制
1m	1m/5m/15m/30m/1h/3h	<=3h
5m	5m/15m/30m/1h/3h	<=3h
15m	15m/30m/1h/3h/6h	<=6h
30m	30m/1h/3h/6h	<=6h
1h	1h/3h/6h/12h/24h	<=24h
6h	6h/12h/24h	<=24h

3）检测指标：设置检测数据的指标。支持设置当前工作空间内单一应用类型下全部/单个应用在一定时间范围内的指标数据。如：当前工作空间内，Web类型下全部应用的指标数据。

字段	说明
应用类型	「用户访问监测」支持的应用类型，包括Web、Android、iOS、Miniapp
应用名称	基于应用类型获取对应的应用列表，支持全选和单选
指标	基于应用类型获取的指标列表， Web/Miniapp（包括JS错误数、JS错误率、资源错误数、资源错误率、首次渲染平均时间、页面加载平均耗时、LCP(largest_contentful_paint)、FID(first_input_delay)、CLS(cumulative_layout_shift)、FCP(first_contentful_paint) 等） Android/IOS（包括启动耗时、总崩溃数、总崩溃率、资源错误数、资源错误率、FPS、页面加载平均耗时等）
筛选条件	基于指标的标签对检测指标的数据进行筛选，限定检测的数据范围。支持添加一个或多个标签筛选，支持模糊匹配和模糊不匹配的筛选条件。
检测维度	配置数据里对应的字符串类型（keyword）字段都可以作为检测维度进行选择，目前检测维度最多支持选择三个字段。通过多个检测维度的字段组合，可以确定一个确定的检测对象，观测云会判断某个检测对象对应的统计指标是否满足触发条件的阈值，若满足条件则产生事件。（例如选择检测维度【 host 】与【 host_ip 】,则检测对象可以为{host: host1, host_ip: 127.0.0.1}）

Web / Miniapp 指标说明

指标	查询示例
JS错误数	R::js_error:(count(`error_message`)) {`app_id` = '#{appid}'}
JS错误率	F::dataflux__dql:(exec_expr (expr='data1.count/data2.count*100', pre_func='SUM', data1 = dql("R::page:(count(`page_url`) as count) {`app_id` = '#{appid}',`page_js_error_count` > 0}"), data2 = dql("R::page:(count(`page_url`) as count) {`app_id` = '#{appid}'}") ))
资源错误数	R::resource:(count(`resource_url`)) {`app_id` = '#{appid}',( `resource_status_group` = '4xx' || `resource_status_group` = '5xx')}
资源错误率	F::dataflux__dql:(exec_expr (expr='data1.count/data2.count*100', pre_func='SUM', data1 = dql("R::resource:(count(`page_url`) as count) {`app_id` = '#{appid}',`resource_status` >= 400}"), data2 = dql("R::resource:(count(`page_url`) as count) {`app_id` = '#{appid}'}") ))
首次渲染平均时间	R::page:(avg(page_fpt)){`app_id` = '#{appid}'}
页面加载平均耗时	R::view:(avg(loading_time)){`app_id` = '#{appid}'}
页面慢加载次数	R::resource:(count(resource_load)){`app_id` = '#{appid}',`resource_load`>8000000000,resource_type='document'}
资源加载平均耗时	R::resource:(avg(`resource_load`) as `加载耗时` ) {`app_id` = '#{appid}',resource_type!='document'}
LCP (largest_contentful_paint)	包括聚合函数: avg、P75、P90、P99 R::view:(avg(largest_contentful_paint)){`app_id` = '#{appid}'} R::view:(percentile(`largest_contentful_paint`,75)){`app_id` = '#{appid}'} R::view:(percentile(`largest_contentful_paint`,90)){`app_id` = '#{appid}'} R::view:(percentile(`largest_contentful_paint`,99)){`app_id` = '#{appid}'}
FID (first_input_delay)	包括聚合函数: avg、P75、P90、P99 R::view:(avg(first_input_delay)){`app_id` = '#{appid}'} R::view:(percentile(`first_input_delay`,75)){`app_id` = '#{appid}'} R::view:(percentile(`first_input_delay`,90)){`app_id` = '#{appid}'} R::view:(percentile(`first_input_delay`,99)){`app_id` = '#{appid}'}
CLS (cumulative_layout_shift)	包括聚合函数: avg、P75、P90、P99 R::view:(avg(cumulative_layout_shift)){`app_id` = '#{appid}'} R::view:(percentile(`cumulative_layout_shift`,75)){`app_id` = '#{appid}'} R::view:(percentile(`cumulative_layout_shift`,90)){`app_id` = '#{appid}'} R::view:(percentile(`cumulative_layout_shift`,99)){`app_id` = '#{appid}'}
FCP (first_contentful_paint)	包括聚合函数: avg、P75、P90、P99 R::view:(avg(first_contentful_paint)){`app_id` = '#{appid}'} R::view:(percentile(`first_contentful_paint`,75)){`app_id` = '#{appid}'} R::view:(percentile(`first_contentful_paint`,90)){`app_id` = '#{appid}'} R::view:(percentile(`first_contentful_paint`,99)){`app_id` = '#{appid}'}

Android / IOS 指标说明

指标	查询示例
启动耗时	M::rum_app_startup:(AVG(`app_startup_duration`)) { `app_id` = '#{appid}'}
总崩溃数	R::crash:(count(`crash_type`)) {`app_id` = '#{appid}'}
总崩溃率	F::dataflux__dql:(exec_expr (expr='data1.count/data2.count*100', pre_func='SUM', data1 = dql("R::crash:(count(`crash_type`) as count) {`app_id` = '#{appid}'}"), data2 = dql("M::rum_app_startup:(count(`app_startup_duration`) as count) {`app_id` = '#{appid}'}") ))
资源错误数	R::resource:(count(`resource_url`) as count) {`app_id` = '#{appid}',`resource_status` >= 400}
资源错误率	F::dataflux__dql:(exec_expr (expr='data1.count/data2.count*100', pre_func='SUM', data1 = dql("R::resource:(count(`resource_url`) as count) {`app_id` = '#{appid}',`resource_status` >= 400}"), data2 = dql("R::resource:(count(`resource_url`) as count) {`app_id` = '#{appid}'}") ))
FPS	R::view:(avg(`view_fps`)) {`app_id` = '#{appid}'}
页面加载平均耗时	R::view:(avg(`view_load`)) {`app_id` = '#{appid}'}
资源加载平均耗时	R::resource:(avg(`resource_load`)) { `app_id` = '#{appid}'}
卡顿次数	R::freeze:(count(`freeze_type`) as count) {`app_id` = '#{appid}'}

4）触发条件：设置告警级别的触发条件。

配置触发条件及严重程度，当查询结果为多个值时，任一值满足触发条件则产生事件。

• 事件等级详情参考 事件等级说明

01、告警级别紧急（红色）、重要（橙色）、警告（黄色）基于配置条件判断运算符。

• 运算符详情参考 运算符说明

02、告警级别正常（绿色）、信息（蓝色）基于配置检测次数，说明如下：

• 每执行一次检测任务即为 1 次检测，如【检测频率 = 5 分钟】，则 1 次检测= 5 分钟
• 可以自定义检测次数，如【检测频率 = 5 分钟】，则 3 次检测 = 15 分钟

a-正常（绿色）：检测规则生效后，产生紧急、重要、警告异常事件后，在配置的自定义检测次数内，数据检测结果恢复正常，则产生恢复告警事件。

Attention

恢复告警事件不受告警沉默限制。若未设置恢复告警事件检测次数，则告警事件不会恢复，且一直会出现在「事件」-「未恢复事件列表」中。

b-信息（蓝色）：正常检测结果也产生事件。

03、告警级别无数据（灰色）：无数据状态支持「触发无数据事件」、「触发恢复事件」、「不触发事件」三种配置，需要手动配置无数据处理策略。

检测规则生效后，第一次检测无数据且持续无数据，不产生无数据告警事件；若检测有数据且在配置的自定义检测时间范围内，数据上报发生断档，则产生无数据告警事件。

步骤2.事件通知

5）事件标题：设置告警触发条件的事件名称，支持使用预置的模板变量，详情参考 模板变量 。

6）事件内容：满足触发条件时发送的事件通知内容，支持输入markdown 格式文本信息，支持预览效果，支持使用预置的模板变量，详情参考 模板变量 。

Attention

最新版本中 “监控器名称” 将由 “事件标题” 输入后同步生成。旧的监控器中可能存在 “监控器名称” 和 “事件标题” 不一致的情况，为了给您更好的使用体验，请尽快同步至最新。支持一键替换为事件标题。

不同告警通知对象支持的 markdown 语法不同，例如：企业微信不支持无序列表。

7）告警策略：监控满足触发条件后，立即发送告警消息给指定的通知对象。告警策略中包含需要通知的事件等级、通知对象、以及告警沉默周期。详情参考 告警策略 。

步骤3.关联

8）关联仪表板：每一个监控器都支持关联一个仪表板，即通过「关联仪表板」功能能够自定义快速跳转的仪表板（监控器关联的仪表板，支持快速跳转查看监控视图）。

示例

监控 skywalking-web-demo 的 web 端基于服务维度的 JS 错误数。