用户访问指标检测¶
用户访问指标检测用于监控工作空间内用户访问的指标数据，通过设置阈值范围，当指标到达阈值后触发告警，支持对单个指标设置告警和自定义告警等级。
应用场景¶
支持监控包括 Web、Android、iOS、Miniapp 应用类型的指标数据。例如可以监控 Web 端 基于城市维度的 JS 错误率。
新建¶
点击监控器 > 新建监控器 > 用户访问指标检测，进入规则的配置页面。
步骤一：检测配置¶
1）检测频率：检测规则的执行频率，包含 1m/5m/15/30m/1h/6h（默认选中 5m）。
2）检测区间：每次执行任务时，检测指标查询的时间范围。受检测频率影响，可选检测区间会有不同。
| 检测频率 | 检测区间（下拉可选项） |
|---|---|
| 1m | 1m/5m/15m/30m/1h/3h |
| 5m | 5m/15m/30m/1h/3h |
| 15m | 15m/30m/1h/3h/6h |
| 30m | 30m/1h/3h/6h |
| 1h | 1h/3h/6h/12h/24h |
| 6h | 6h/12h/24h |
| 12h | 12h/24h |
| 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}。） |
| 指标 | 查询示例 |
| JS错误数 | R::error:(count(`__docid`) as `JS 错误数`) { `app_id` = '<应用 ID>' } |
| JS错误率 | Web: eval(A/B, alias='页面 JS 错误率', A="R::view:(count(`view_url`)) {`view_error_count` > 0, `app_id` = '<应用 ID>'}",B="R::view:(count(`view_url`)) { `app_id` = '<应用 ID>'} ") Miniapp: eval(A/B, alias='JS 错误率', A="R::view:(count(`view_name`)) {`view_error_count` > 0, `app_id` = '<应用 ID>' }",B="R::view:(count(`view_name`)) { `app_id` = '<应用 ID>' }") |
| 资源错误数 | R::resource:(count(`resource_url`) as `资源错误数`) {`resource_status` >=400, `app_id` = '<应用 ID>'} |
| 资源错误率 | eval(A/B, alias='资源错误率', A="R::`resource`:(count(`resource_url`)) { `resource_status` >= '400',`app_id` = '<应用 ID>' }", B="R::`resource`:(count(`resource_url`)) { `app_id` = '<应用 ID>' }") |
| 首次渲染平均时间 | 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}'} |
| 指标 | 查询示例 |
| 启动耗时 | R::action:(avg(duration)) { `app_id` = '<应用 ID>' ,action_type='app_cold_launch'} |
| 总崩溃数 | R::error:(count(error_type)) {app_id='<应用 ID>',`error_source` = 'logger' and is_web_view !='true'} |
| 总崩溃率 | eval(A.a1/B.b1, alias='总崩溃率',A="R::error:(count(error_type) as a1) {app_id='<应用 ID>',`error_source` = 'logger',is_web_view !='true'} ",B="R::action:(count(action_name) as b1) { `app_id` = '<应用 ID>',`action_type` in [`launch_cold`,`launch_hot`,`launch_warm`]} ") |
| 资源错误数 | R::resource:(count(`resource_url`) as `资源错误数`) {`resource_status` >=400, `app_id` = '<应用 ID>'} |
| 资源错误率 | eval(A/B, alias='资源错误率', A="R::`resource`:(count(`resource_url`)) { `resource_status` >= '400',`app_id` = '<应用 ID>' }", B="R::`resource`:(count(`resource_url`)) { `app_id` = '<应用 ID>' }") |
| 平均 FPS | R::view:(avg(`fps_avg`)) { `app_id` = '<应用 ID>' } |
| 页面加载平均耗时 | R::view:(avg(`loading_time`)) { `app_id` = '<应用 ID>' } |
| 资源加载平均耗时 | R::resource:(avg(`duration`)) { `app_id` = '<应用 ID>' } |
| 卡顿次数 | R::long_task:(count(`view_id`)) { `app_id` = '<应用 ID>' } |
| 页面错误率 | eval(A/B, alias='页面错误率',A="R::view:(count(`view_name`)) {`view_error_count` > 0, `app_id` = '<应用 ID>' }",B="R::view:(count(`view_name`)) { `app_id` = '<应用 ID>' }") |
4）触发条件：设置告警级别的触发条件：您可任意配置紧急、重要、警告、正常的其中一种触发条件。
配置触发条件及严重程度，当查询结果为多个值时，任一值满足触发条件则产生事件。
更多详情，可参考 事件等级说明。
告警级别
1、告警级别紧急（红色）、重要（橙色）、警告（黄色）：基于配置条件判断运算符。
更多详情，可参考 运算符说明。
2、告警级别正常（绿色）：基于配置检测次数，说明如下：
- 每执行一次检测任务即为 1 次检测，如【检测频率 = 5 分钟】，则 1 次检测= 5 分钟；
- 可以自定义检测次数，如【检测频率 = 5 分钟】，则 3 次检测 = 15 分钟。
| 级别 | 描述 |
|---|---|
| 正常 | 检测规则生效后，产生紧急、重要、警告异常事件后，在配置的自定义检测次数内，数据检测结果恢复正常，则产生恢复告警事件。 恢复告警事件不受告警沉默限制。若未设置恢复告警事件检测次数，则告警事件不会恢复，且一直会出现在事件 > 未恢复事件列表中。 |
5）数据断档：针对无数据状态，支持七种配置策略。
-
联动检测区间时间范围，判断检测指标最近分钟数的查询结果，不触发事件；
-
联动检测区间时间范围，判断检测指标最近分钟数的查询结果，查询结果视为 0；此时查询结果将重新与上方触发条件中配置的阈值做比较，从而判断是否触发异常事件。
-
自定义填充检测区间值，触发无数据事件、触发紧急事件、触发重要事件、触发警告事件及触发恢复事件；选择该类配置策略，自定义无数据时间配置建议 >= 检测区间时间间隔，若配置时间 <= 检测区间时间间隔，可能存在同时满足无数据和异常情况，此情况下仅会应用无数据处理结果。
6）信息生成：开启此选项后，将未匹配到以上触发条件的检测结果生成 “信息” 事件写入。
注意：若同时配置触发条件、数据断档、信息生成时，按照如下优先级判断触发：数据断档 > 触发条件 > 信息事件生成。
步骤二：事件通知¶
1）事件标题：设置告警触发条件的事件名称，支持使用预置的模板变量。
2）事件内容：满足触发条件时发送的事件通知内容。支持输入 Markdown 格式文本信息并预览效果，支持使用关联链接、模板变量。
Warning
最新版本中监控器名称将由事件标题输入后同步生成。旧的监控器中可能存在监控器名称和事件标题不一致的情况，为了给您更好的使用体验，请尽快同步至最新。
不同告警通知对象支持的 Markdown 语法不同，例如：企业微信不支持无序列表。
无数据通知配置：支持自定义无数据通知内容，若没有配置，则自动使用官方默认的通知模版。
3）关联异常追踪：开启关联后，若该监控器下产生了异常事件，将同步创建 Issue。选择 Issue 的等级以及需要投递的目标频道，产生的 Issue 可以前往异常追踪 > 您选定的频道进行查看。
在事件恢复后，可以同步关闭 Issue。
事件内容自定义高级配置¶
观测云支持在事件内容中通过高级配置添加关联日志或错误堆栈，以便查看异常情况发生时的上下文数据情况：
- 添加关联日志：
查询：
如：获取一条索引为 default 的日志 message：
关联日志：
- 添加关联错误堆栈
查询：
{% set dql_data = DQL("T::re(`.*`):(`error_message`,`error_stack`){ (`source` NOT IN ['service_map', 'tracing_stat', 'service_list_1m', 'service_list_1d', 'service_list_1h', 'profile']) AND (`error_stack` = exists()) } LIMIT 1") %}
关联错误堆栈：
步骤三：告警配置¶
告警策略：监控满足触发条件后，立即发送告警消息给指定的通知对象。告警策略中包含需要通知的事件等级、通知对象、以及告警沉默周期。
告警策略支持单选或多选，点击策略名可展开详情页。若需修改策略点击编辑告警策略即可。
步骤四：关联¶
关联仪表板：每一个监控器都支持关联一个仪表板，可快速跳转查看。
示例¶
监控 Skywalking-web-demo 的 Web 端基于服务维度的 JS 错误数。
