ARMS提供一键接入方式为Java应用安装探针,安装成功后无需重启应用即可开始监控,适用于新手用户。当应用重启时,探针会自动加载,该Java应用将自动接入ARMS应用监控。

前提条件

  • 确保您使用的云服务器ECS实例的安全组已开放8442、8443、8883三个端口的TCP出方向权限。为云服务器ECS开放出方向权限的方法,请参见添加安全组规则
    说明 ARMS不仅可接入阿里云ECS上的应用,还能接入其他能访问公网的服务器上的应用。
  • 确保您使用的第三方组件或框架在应用监控兼容性列表范围内,请参见应用监控兼容性列表
  • 若您的应用已经按照手动接入方式接入ARMS应用监控,则需先卸载探针才能正常使用一键接入方式,请参见卸载探针
  • 如果JDK版本为1.8.0_25或者1.8.0_31,可能会出现无法安装探针的情况,请升级至1.8.X最新版本。

操作步骤

  1. 登录ARMS控制台
  2. 在左侧导航栏中选择应用监控 > 应用列表
  3. 应用列表页面顶部选择目标地域,在右上角单击接入应用
  4. 接入应用页面执行以下操作:
    1. 请先选择您使用的语言区域选择Java
    2. 请先选择您使用的环境区域选择默认
    3. 请选择以下接入方式区域选择脚本安装
    Access Agent
  5. 在接入应用页面顶部复制License Key。
  6. 运行您所在地域对应的安装脚本。
    地域 安装脚本
    华东1(杭州)
    wget -O- http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    华东2(上海)
    wget -O- http://arms-apm-shanghai.oss-cn-shanghai.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    华北1(青岛)
    wget -O- http://arms-apm-qingdao.oss-cn-qingdao.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    华北2(北京)
    wget -O- http://arms-apm-beijing.oss-cn-beijing.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    华南1(深圳)
    wget -O- http://arms-apm-shenzhen.oss-cn-shenzhen.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    中国(香港)
    wget -O- http://arms-apm-hongkong.oss-cn-hongkong.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    亚太东南(新加坡)
    wget -O- http://arms-apm-ap-southeast.oss-ap-southeast-1.aliyuncs.com/cloud_ap-southeast-1/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    日本(东京)
    wget -O- http://arms-apm-japan.oss-ap-northeast-1.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    美国(硅谷)
    wget -O- http://arms-apm-usw.oss-us-west-1.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    华东1金融云
    wget -O- http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/finance/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    说明
    • <licenseKey>替换为您的LicenseKey。
    • Java-Demo替换成您的应用名,应用名暂不支持中文。
    • 执行安装脚本后,该脚本会自动下载最新探针。
    • 若您的服务器只有一个Java进程,安装脚本会默认选择该进程安装探针;若您的服务器有多个Java进程,请根据提示选择一个进程安装探针。

结果验证

约一分钟后,若您的应用出现在应用列表中且有数据上报,则说明接入成功。

卸载探针

  1. 当您不需要使用ARMS监控您的Java应用时,执行jps -l命令查看所有进程,并在执行结果中找到com.alibaba.mw.arms.apm.supervisor.daemon.Daemon对应的进程号。
    在本示例中,com.alibaba.mw.arms.apm.supervisor.daemon.Daemon对应的进程号为:62857。Kill Process
  2. 执行命令kill -9 <进程号>
    例如:kill -9 62857
  3. 执行rm -rf /.arms /root/.arms
  4. 重启您的应用。

快速更改应用名称

如果因为某些原因希望更改应用名称,例如忘记将示例应用名称Java-Demo修改为自定义名称,您可以在不重启应用、不重装探针的情况下更改应用名称,详情参见以快速方式安装探针的普通Java应用如何更改应用名称

常见问题

  1. 如果在执行一键接入Java应用脚本时出现以下getcwd相关错误该怎么处理?

    shell-init: error retrieving current directory: getcwd: cannot access parent directories: No such file or directory Error occurred during initialization of VM java.lang.Error: Properties init: Could not determine current working directory. at java.lang.System.initProperties(Native Method) at java.lang.System.initializeSystemClass(System.java:1119)

    可能原因是执行脚本过程中误删了当前目录。解决办法为:先执行cd,然后重新运行脚本。

  2. 使用一键接入方式安装探针后,在哪里查看日志?

    日志的默认目录为:/root/.arms/supervisor/logs/arms-supervisor.log,若此目录下没有日志,请执行命令ps -ef |grep arms查看日志所在目录。

更多信息