应用设置

全局设置

基调听云Web的全局设置可统一设置全部应用的应用设置，包含：基本设置、阈值设置、数据过滤设置、URL聚合设置、IP地域设置、跨域设置、评分设置。

在左侧导航栏中单击Web>全局配置，进入全局设置页面。

基本设置

基本设置主要用于设置应用中指标在地图上显示的区间值和对应的颜色值。可设置的指标有：完全加载、FCP、LCP、DCL、用户体验评分、操作时间、操作可用性、HTML加载、JS错误率、DNS、TCP、SSL、首包、剩余包、操作Ajax响应时间、操作服务端响应时间。

指标区间值设置：

单击区间值，然后修改弹窗默认的起始值和终止值，单击确认即可。

区间颜色设置：

单击色块，然后修改色值，可手工输入色值，也可在颜色面板选色。

阈值设置

设置慢页面追踪的性能阈值，单位为毫秒。当页面访问完全加载、FCP、LCP、DCL四个指标任意一个超过该阈值时，浏览器探针将会记录详细的页面加载数据，包含公网IP、网络环境、页面元素加载瀑布图等信息。

数据过滤设置

• 异常数据剔除阈值

  设置异常数据剔除阈值，单位为秒，默认为120秒。未开启时，系统默认过滤规则会生效，规则为DCL或者完全加载大于FCP的10倍并且FCP、LCP、DCL、完全加载四个指标任意一个指标大于60秒时即过滤这次页面性能数据。开启时，过滤规则为FCP、LCP、DCL、完全加载四个指标任意一个指标大于设置值即过滤这次页面性能数据，同时系统默认过滤规则会关闭。符合过滤规则的页面性能数据将剔除掉，不参与页面性能指标计算，但页面发生的JS错误仍然保留且参与JS错误率计算。

  

• 域名白名单

  设置域名白名单，可以过滤掉非白名单内的干扰数据。添加域名白名单，输入完整域名即可。

  

• 过滤机器人数据

  开启后，将过滤掉UA中含"Bot"、 "Spider"、"Crawler"、"Yahoo! Slurp"、"NetworkBench"关键词的访问数据。

• 国家地域白名单

  默认不开启，即采集所有国家地域数据，所有国家地域的数据都计算到应用整体性能中，开启后，勾选某一个或者多个国家，即只采集勾选的国家地域，应用整体性能也只取勾选的国家地域数据进行计算。

• JS错误过滤

  基调听云Web支持按照错误文件关键词、错误信息关键词、UA关键词过滤JS错误，关键词以换行分割，设置后符合过滤规则的JS错误不再统计到JS错误率中去，同时也不再触发对应的JS错误率告警。

  

• Ajax请求状态码忽略

  如需通过请求状态码过滤Ajax，首先开启该功能，然后将状态码配置到下方文本框内，多个状态码请以换行分割。设置后，计算应用Ajax的错误率时，将不再统计这些Ajax请求，系统也不再触发这些Ajax请求的告警。

  

URL聚合规则

用户可以借助通配符自定义应用URL的聚合规则，这个规则可以帮助我们自定义哪些页面聚合，哪些页面不聚合，也可以自定义URL带参数不聚合，若未设置，将采用基调听云默认URL聚合规则。具体可参见控制台功能页面中的说明。

请求内容采集

开启开关后，探针会采集 Http/Https 请求的 Header 和 Body 参数。

需要注意的是 Body 仅采集响应体类型为「text 及 json」数据结构的内容，默认不采集已知涉密的请求头，例如：Authorization、Cookie 和 Proxy-Authorization。

自定义IP地域规则

用户可自定义某些用户IP或者IP段所在地域为某一个省份或城市，若未设置，基调听云会将未识别匹配的外网IP和内网IP默认显示为未知地域。

• 设置备注名，非必填选项

• 选中地域

• IP段，可多项，起始值也可只填一个，若填一个，即为单个IP

用户体验评分设置

用户体验评分是借助FCP、LCP、DCL、慢页面占比、操作时间、操作可用性6个指标维度对用户打开网页的加载速度、单击操作的响应速度以及操作的可用性三个方面体验进行综合评分。用户可自定义6个指标阈值，来建立网站用户体验的评分标准。

用户体验评分公式：

用户体验评分=FCP评分*10% +LCP评分*20% +DCL评分*10%+操作时间评分*20% +操作可用性评分*20%+慢页面占比评分*20%。

单应用设置

在左侧导航栏中单击Web>概览，进入应用列表页面。单击目标应用设置列的设置，即可进入到单应用的设置页面中。

单应用设置的配置项大部分与全局应用相同，配置方法相同，若需要单独配置即关闭全局设置开关单独配置即可，详情请参考全局设置。

以下是单应用设置特有的配置项说明。

自定义应用上传地址

应用可基于配置的上传地址来上传数据，区分内网应用和外网应用。上传地址配置方式如下：

1. 进入MySQL中BR_M_UPLOAD_ADDRESS_CONFIG配置上传地址。

   -- 上传地址配置表
   CREATE TABLE IF NOT EXISTS `BR_M_UPLOAD_ADDRESS_CONFIG` ( 
       `id` int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT 'ID', 
       `agreement_id` int(10) unsigned DEFAULT NULL COMMENT '合同号', 
       `group_name` varchar(256) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL COMMENT '组名', 
       `http_addr` varchar(256) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL COMMENT 'http地址', 
       `https_addr` varchar(256) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL COMMENT 'https地址', 
       `ctime` datetime NOT NULL COMMENT '创建时间', `mtime` datetime NOT NULL COMMENT '修改时间', 
       `status` tinyint(4) NOT NULL DEFAULT '1' COMMENT '状态 1 - 启用 -1 - 已删除', PRIMARY KEY (`id`) 
       ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='上传地址配置表';
   

2. 应用表添加上传地址字段。

   call add_tab_column('venus_conf', 'BR_U_APPLICATION', 'upload_addr_id', 'int', 10, 'unsigned', '0', 'mobile_app_id');
   

   

3. 在页面上的应用上传地址下拉菜单中查看地址。

获取探针

单击页面右侧的原始探针，可下载不含配置的JS探针到本地；单击含配置探针，则可下载包含配置信息的JS探针。单击复制JS按钮，可将上方的浏览器探针内容快速复制到剪切板中。

调用链追踪

受浏览器的同源策略限制，跨域请求无法与后端事务进行跨应用调用链追踪。为解决此问题，需在跨域请求中增加特殊标记（X-Tingyun）来进行校验。

注意：如果开启跨域的跨应用追踪，必须增加跨域配置，否则会导致业务请求失败。

配置跨域的调用链追踪，请按照以下步骤进行操作。

1. 开启APM关联开关。

2. 在自定义请求头部分单击新建配置按钮，设置APM系统请求头，用于关联后端事务。

   配置后系统将生成UUID，Ajax请求会携带相关request header，即可基于该TraceID追踪后端事务。

   • TraceID：追踪到后端的请求头中的唯一标识，用于调用链追踪数据的采集。在悟空平台的请求分析详情列表中，您可以查看通过TraceID关联到的后端请求的性能指标数据。此项为必填项。配置多个TraceID，请使用英文逗号分隔。
   • 追踪URL：由悟空平台跳转到第三方APM的地址。例如：您的第三方追踪平台的URL为https://wukong.tingyun.com/web/server/trace-detail/tx/0101/010101010101?timestamp=1010101010101，需要将追踪URL设置为https:/wukong.tingyun.com/web/server/trace-detail/tx/${appId}/${traceId}?timestamp=${tyTimestamp}。此项为选填项。
   • 备注：对该项配置的说明。此项为选填项。

3. 在服务端配置特殊标记。

4. 验证服务端是否配置正确。

5. 添加跨域域名。

6. 单击页面底部的保存设置按钮。

7. 验证跨域应用是否生效。

   说明：使用自动嵌码的需要重新嵌码。

第3步至第7步的具体配置方法，请参见跨应用跨域设置。

关键请求

开启关键请求规则可以自定义配置某些静态资源、网络请求等元素为关键请求，配置完成后将该元素作为一条关键请求监控。适用于某关键资源下载，用来分析下载服务器、CDN等质量。单个应用最多支持配置20个。

关键请求配置URL地址规则：

例如：
具体请求：androidbutton.png
聚合请求：mall.tingyun.com/mall-admin/orderStting/*

单击提交同步到下方列表中，列表展示序号、URL地址规则、创建时间和操作信息。

自定义维度

配置自定义信息上传自定义维度，然后设置维度白名单，即可在追踪列表中通过自定义维度进行过滤。

注意：使用通用配置将覆盖当前应用配置。

Source Map

Source Map是一个存储源代码与编译代码对应位置映射的信息文件，便于开发人员定位上述代码错误。基调听云提供了Source Map上传来还原代码真正的错误位置，还原JS错误现场。这样使得开发者能够迅速定位出错的源代码位置以及相应的代码块。

SourceMap上传支持两种方式：CLI和Webpack插件。具体说明请参见Source Map。