创建一个应用监控任务

本文以一个实例介绍了如何创建一个应用监控任务。

1. 登录 ARMS 控制台，在左侧菜单栏中选择应用监控 > 应用列表。 实例列表页面打开。

2. 在页面右上角或中心单击新接入应用。 新接入应用对话框打开。

3. 在对话框中输入应用名称，并单击确定。 例如，输入 tomcat-demo。

   

   应用设置页面打开。

   

4. 采用以下方法之一下载 Java 探针。

   • 方法 1：直接下载。单击点击下载按钮，下载最新 ZIP 包。

   • 方法 2： wget 命令下载。使用 wget 命令下载 Agent 压缩包。

     请根据地域下载对应的压缩包。

     # 杭州地域
     wget "http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
     # 上海地域
     wget "http://arms-apm-shanghai.oss-cn-shanghai.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
     # 青岛地域
     wget "http://arms-apm-qingdao.oss-cn-qingdao.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
     # 北京地域
     wget "http://arms-apm-beijing.oss-cn-beijing.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
     # 深圳地域
     wget "http://arms-apm-shenzhen.oss-cn-shenzhen.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
     # 新加坡地域
     wget "http://arms-apm-ap-southeast.oss-ap-southeast-1.aliyuncs.com/cloud_ap-southeast-1/ArmsAgent.zip" -O ArmsAgent.zip
     # 金融云环境
     wget "http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/finance/ArmsAgent.zip" -O ArmsAgent.zip

5. 解压并部署探针包。

   1. 切换到 ArmsAgent 探针包所在目录，解压到任意工作目录下。

   2. 在应用设置的安装探针页面查看 arms.licenseKey 和 arms.appId 属性。

      

   3. 在 Java 启动参数中加入 -javaagent 参数，指向探针包中 arms-bootstrap-1.7.0-SNAPSHOT.jar 文件，并在参数后加上 -Darms.licenseKey=*xxx* 和 -Darms.appId=*xxx* 参数。

   • 如为 Tomcat 运行环境，请在 {TOMCAT_HOME}/bin 目录下的 setenv.sh 中加入以下配置。

     JAVA_OPTS="$JAVA_OPTS -javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey=xxx -Darms.appId=xxx"

     注： 如果您的 Tomcat 版本没有 setenv.sh 配置文件，请打开 {TOMCAT_HOME}/bin/catalina.sh，找到 JAVA_OPTS 变量定义，并在该变量定义后加入以下配置。点击下载参考样例：catalina.sh（第 256 行定义）

     注： 在 Windows 环境下，请在 {TOMCAT_HOME}/bin/catalina.bat 中加入：

     set "JAVA_OPTS=%JAVA_OPTS% -javaagent:{user.workspace}\ArmsAgent\arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey=xxx -Darms.appId=xxx"

   • 如为 Jetty 运行环境，请在 {JETTY_HOME}/start.ini 配置文件中加入以下配置：

     --exec    #打开注释 前面的井号去掉即可
     -javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar
     -Darms.licenseKey=xxx
     -Darms.appId=xxx

   • 如为 Spring Boot 运行环境，启动 Spring Boot 进程时，请在启动命令 java 后面加上 -javaagent 参数：

     java -javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey=xxx -Darms.appId=xxx -jar demoApp.jar

     注： demoApp.jar 为原应用 JAR 包名称，请根据实际情况替换。

   • 如为 Windows 运行环境，启动 Java 进程时，请在挂载 Agent 路径中使用反斜杠（\）作为分隔符。

     {CMD}> java  -javaagent:{user.workspace}\ArmsAgent\arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey=XXX -Darms.appId=XXX
     -jar {user.workspace}\demoApp.jar

     注： demoApp.jar 为原应用 JAR 包名称，请根据实际情况替换。

6. 启动任务。 几分钟后 Agent 将自动接入 ARMS 应用监控中。

如需删除应用， 在应用设置页面，单击删除标签页，然后单击删除应用并确认即可。