ARMS应用监控提供应用链路追踪、本地堆栈诊断、业务日志全息排查等监控功能。如果您想要使用ARMS应用监控开始监控您的应用，那么需要先创建应用监控任务。

背景信息

ARMS应用监控可以监控运行在多种环境下的Java应用和PHP应用。本文以在ECS实例中Tomcat环境下运行的Java应用为例，介绍如何创建一个应用监控任务。针对不同的应用运行环境，ARMS提供手动安装探针、利用脚本快速安装探针和自动安装探针的途径。但是，为了帮助您了解一般性的创建应用监控任务的步骤，本文示例中采用的是手动安装探针的方法。

前提条件

  • 开通ARMS
  • 确保您使用的云服务器ECS实例的安全组已开放8442、8443、8883三个端口的TCP出方向权限。为云服务器ECS开放出方向权限的方法请参见添加安全组规则。
    说明 ARMS不仅可接入阿里云ECS上的应用，还能接入其他能访问公网的服务器上的应用。

步骤一：获取LicenseKey

请按照以下步骤获取licenseKey，接下来的步骤中将会用到这个参数。

  1. 登录 ARMS 控制台。
  2. 在左侧导航栏中选择应用监控 > 应用列表。
  3. 在应用列表页面顶部选择目标地域，在右上角单击新接入应用。
  4. 在新接入应用页面选择以下选项：
    • 使用的语言：Java
    • 使用的环境：默认
    • 接入方式：手动接入
    Download Agent
  5. 在下载探针页签上单击下一步。
  6. 在安装探针页签复制LicenseKey的值。
    Install Agent

步骤二：配置Tomcat运行环境

请按照以下步骤配置Tomcat运行环境，在配置文件中设置必要的参数。

  1. 打开{TOMCAT_HOME}/bin/catalina.sh配置文件。
    说明 如果您的Tomcat版本没有catalina.sh配置文件，则请尝试找到{TOMCAT_HOME}/bin/setenv.sh配置文件并打开。
  2. 在配置文件中添加以下配置。
    说明 请将以下示例代码中的<licenseKey>替换为步骤一中获得的真实值，并将<appName>替换为自定义的应用名称。 
    JAVA_OPTS="$JAVA_OPTS -javaagent:/workspace/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey=<licenseKey> -Darms.appName=<appName>"

配置Tomcat运行环境的代码运行示例如下所示。

步骤三：安装Java探针

请按照以下步骤为应用安装Java探针，以采集所需的监控数据。

  1. 使用wget命令下载Java探针压缩包。
    说明 本示例以杭州地域为例，其他地域的Java探针压缩包下载地址参见操作步骤。 
    # 杭州地域wget "http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
  2. 将Java探针压缩包解压至工作目录下。本示例的工作目录为workspace。 
    unzip ArmsAgent.zip -d /workspace/

安装Java探针的代码运行示例如下所示。

步骤四：重启Tomcat

  1. 进入{TOMCAT_HOME}/bin目录。
  2. 重新启动Tomcat。 
    ./startup.sh

重启Tomcat的代码运行示例如下所示。

结果验证

等待2~3分钟后，如果ARMS控制台的应用监控 > 应用列表页面上出现了您的应用（应用名称为自定义的<appName>），则说明您已成功创建应用监控任务。