使用 ARMS 监控 Java 应用时,如果因为某些原因希望更改应用名称,例如忘记将示例应用名称 Java-Demo 修改为自定义名称,您可以按照本文的说明,在不重启应用、不重装探针的情况下更改应用名称。

前提条件

探针版本为 2.5.8.1 或以上。您可以在探针目录的 Version 文件中查看探针版本。例如,2.5.8_cf020486_20190816150025 表示探针版本为 2.5.8,探针发布时间为 2019 年 8 月 16 日。探针目录的位置因安装探针的方式而异,详情请参见下文内容。
如果您的探针版本低于 2.5.8.1,请先按照卸载流程重新安装(在此过程重命名应用名称即可),2019 年 8 月 20 日之后下载的探针默认都支持该功能。

普通 Java 应用(以普通方式安装探针时)

普通 Java 应用是指除了部署在阿里云 ECS 实例上的 Java 应用之外的应用。如果您是以普通方式安装探针的,则探针目录就是您自定义的位置。

请按照以下步骤更改应用名称。

  1. 请使用以下方法之一下载并解压 Supervisor。
    说明 请根据您的应用所在的地域替换下载地址中的地域。
    • 公网地址
      wget http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/ArmsSupervisor.zip -O ArmsSupervisor.zip
      unzip ArmsSupervisor.zip
    • VPC 地址(公网地址无法下载时使用)
      wget http://arms-apm-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/ArmsSupervisor.zip -O ArmsSupervisor.zip
      unzip ArmsSupervisor.zip
  2. 运行以下命令更改应用名称。
    cd ArmsSupervisor
    ./attach.sh </path/to/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar> <PID> <NewAppName> <LicenseKey>
    • </path/to/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar>:指向探针下同名文件的路径。
    • <PID>:目标进程 ID,可通过 jps/ps 命令获取。
    • <NewAppName>:新的应用名称。
    • <LicenseKey>:ARMS 应用监控中应用的 LicenseKey,可从控制台获取。

如果应用的标准输出打印以下日志,则说明应用名称更改成功。

Name Change Success

部署在容器服务 K8s 集群中的 Java 应用

修改 Deployment 内的 armsPilotCreateAppName 参数并重启 Pod 即可。

部署在 EDAS 上的 Java 应用

目前不支持为部署在 EDAS 上的 Java 应用更改应用名称。

执行结果

应用名称更改成功后稍等片刻,旧名称的应用下将不再有监控数据上报,且新名称的应用下将有监控数据上报。