JS Agent安装配置操作

通过向前端页面注入JS监控应用程序的Web前端页面性能。

登录透视宝,在顶部导航栏选择image.png>Browser应用后打开JS注入引导页面,按照页面中的说明完成JS注入。

目前透视宝支持手动注入自动注入两种方法。



手动注入JS

1.      在透视宝平台的1659518857619714.jpg>全局设置>Browser>高级设置数据上报设置页面,配置上报域名及上报协议。

1659518789631631.png

2.      在透视宝平台的1659518890386835.png>Browser应用探针部署页面,选择是否为单页面应用。

说明:是否为单页面默认不开启,若为单页面应用则需要开启此配置。

3.      输入Browser应用名称,单击确定,生成BrowserKey探针代码

您需要选择一种探针代码粘贴方式:

n  将探针代码粘贴在监控的Web网站的</body>标记前,可最小化对页面加载的影响。

n  将探针代码粘贴在监控的Web网站的<head>标记中,可最大化抓取JS错误及Ajax数据范围。

1659518963517645.png

页面中的命令是根据您的登录信息自动生成的,即不同用户需要执行的代码是不同的。为保证您看到的采集数据是正确的,请务必复制页面中的代码而不是文档或其他位置的代码。

注意:

l  未在步骤1设置数据上报域名,则生成的探针代码的<script src>无对应地址。

l  需要将代码粘贴在<meta>后面,所有<script>前面。

l  为方便探针升级,部署JS Agent时禁止将探针包放在客户Web服务器上,作为静态资源加载。



自动注入JS

说明:页面自动注入支持的语言包括Java、Python、Php、Dotnet,配置方式基本相同。以下以Java Agent的配置为例进行说明,其他语言均可参照该配置完成操作。

Java应用在部署Java Agent后可通过探针在页面自动注入JS,目前支持tomcat7、tomcat8、weblogic12容器,配置方式如下:

1.      编辑Java Agent配置文件(conf/agent.properties),根据web容器类型,修改“js”内容为“tomcat7”、“tomcat8”或“weblogic12”。修改“jsEnvAdd”内容中域名为透视宝私有平台相应域名或IP。

l  Java Agent版本为2.11.0以下,APM版本为6.0.0以上7.3.0以下时的配置文件示例:

1659518989781938.png

l  Java Agent版本为2.11.0,APM版本为7.3.0的配置文件示例:

1659519000625780.png

l  Java Agent版本为2.11.0以下,APM版本为7.3.0时的配置文件示例:

1659518989781938.png

您需要将图示中”Js file location”的“jsEnvAdd=http://portal.toushibao.com/rum/EndUserAgentPreload.js”替换为“jsEnvAdd=http://portal.toushibao.com/rum/EndUserAgentPreload.js?license_key=licensekey实际值”。“licensekey实际值”需要与配置文件的licensekey保持一致。

2.      保存配置文件,重启应用。