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

背景信息

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

前提条件

  • 开通 ARMS
  • 公网 ECS 实例的安全组已开放 8442、8443、8883 端口的 TCP 公网出方向权限，VPC 内不需要开通。设置安全组规则的方法请参见添加安全组规则。

步骤一：获取 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>），则说明您已成功创建应用监控任务。