创建一个应用监控任务

ARMS 应用监控支持 Java 和 PHP 应用接入。本文将以在 Tomcat 运行环境接入一个 Java 应用的例子来介绍如何创建一个应用监控任务。

前提条件

• Agent 部署环境需要保证 TCP 协议在 8442、8443、8883 端口的权限畅通。
• 确保您使用的第三方组件或框架在应用监控兼容性列表范围内。

步骤一：获取 licenseKey

1. 登陆 ARMS 控制台，在左侧导航栏中选择应用监控 > 应用列表。

2. 在应用监控页面右上角单击新接入应用。

3. 在新应用接入页面选择安装的语言包区域选择 Java 语言，并单击下一步。

4. 在安装探针字页面查看 licenseKey。

   

步骤二：配置 Tomcat 运行环境。

在 {TOMCAT_HOME}/bin 目录下的 setenv.sh 中加入以下配置。

注意： 如果您的 Tomcat 版本没有 setenv.sh 配置文件，请打开 {TOMCAT_HOME}/bin/catalina.sh，找到 JAVA_OPTS 变量定义，并在该变量定义后加入以下配置。

点击下载参考样例：catalina.sh（第 256 行定义）

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

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

```
set "JAVA_OPTS=%JAVA_OPTS% -javaagent:{user.workspace}ArmsAgentarms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey=xxx -Darms.appName=xxx"
```

步骤三：接入 Java 探针

1. 在 ARMS 控制台返回新应用接入页面，采用以下方法之一下载 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

2. 解压探针包。切换到安装包所在目录，解压安装包到 {user.workspace} 目录下。

   unzip ArmsAgent.zip -d /{user.workspace}/

3. 采用以下方法之一添加 appName 以及 licenseKey 参数。

   • 方法一：修改 JVM 参数，在应用服务器的启动脚本中添加以下参数。

     注意： 将 xxx 分别替换成您的 licenseKey 和应用名称，应用名暂不支持中文。

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

   • 方法二：

     1. 修改 arms-agent.config，替换 arms.licenseKey 及 arms.appName 配置定义：

        注意： 将 xxx 分别替换成您的 licenseKey 和应用名称，应用名暂不支持中文。

        arms.licenseKey=xxx arms.appName=xxx

     2. 修改 JVM 参数，在应用服务器的启动脚本中添加以下参数。

        -javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar

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

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

相关文档

• 接入 Java 应用
• 接入 PHP 应用
• 接入 Java 应用常见问题