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

前提条件

  • 确保您使用的公网服务器安全组已开放 8442、8443、8883 三个端口的 TCP 公网出方向权限,VPC 内不需要开通。为阿里云 ECS 开放出方向权限,请参见添加安全组规则
    说明 ARMS 不仅可接入阿里云 ECS 上的应用,还能接入其他能访问公网的服务器上的应用。
  • 确保您使用的第三方组件或框架在应用监控兼容性列表范围内,请参见应用监控兼容性列表
  • 若您的应用已经按照手动接入方式接入 ARMS 应用监控,则需先卸载探针才能正常使用一键接入方式。请参见卸载探针

操作步骤

  1. 登录 ARMS 控制台,在左侧导航栏中选择应用监控 > 应用列表
  2. 应用列表页面右上角单击新接入应用
  3. 新接入应用页面选择使用语言为 Java,选择使用环境为默认环境,选择接入方式为一键接入。 然后查看并保存 LicenseKey。
    Access Agent
  4. 运行您所在地域对应的安装脚本。
    # 杭州地域
    wget -O- http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    # 上海地域
    wget -O- http://arms-apm-shanghai.oss-cn-shanghai.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    # 青岛地域
    wget -O- http://arms-apm-qingdao.oss-cn-qingdao.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    # 北京地域
    wget -O- http://arms-apm-beijing.oss-cn-beijing.aliyuncs.com/install.sh | sh && ~/.arms/supervisor/cli.sh <licenseKey> Java-Demo
    # 深圳地域
    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-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-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. 重启您的应用。

常见问题

  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查看日志所在目录。

更多信息

相关文档