JS Agent安装配置操作
通过向前端页面注入JS监控应用程序的Web前端页面性能。
登录透视宝,在顶部导航栏选择>Browser应用后打开JS注入引导页面,按照页面中的说明完成JS注入。
手动注入JS
1. 在透视宝平台的>全局设置>Browser>高级设置的数据上报设置页面,配置上报域名及上报协议。
2. 在透视宝平台的>Browser应用的探针部署页面,选择是否为单页面应用。
说明:是否为单页面默认不开启,若为单页面应用则需要开启此配置。
3. 输入Browser应用名称,单击确定,生成BrowserKey和探针代码,
您需要选择一种探针代码粘贴方式:
n 将探针代码粘贴在监控的Web网站的</body>标记前,可最小化对页面加载的影响。
n 将探针代码粘贴在监控的Web网站的<head>标记中,可最大化抓取JS错误及Ajax数据范围。
页面中的命令是根据您的登录信息自动生成的,即不同用户需要执行的代码是不同的。为保证您看到的采集数据是正确的,请务必复制页面中的代码而不是文档或其他位置的代码。
注意:
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以下时的配置文件示例:
l Java Agent版本为2.11.0,APM版本为7.3.0的配置文件示例:
l Java Agent版本为2.11.0以下,APM版本为7.3.0时的配置文件示例:
您需要将图示中”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. 保存配置文件,重启应用。