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>),则说明您已成功创建应用监控任务。