All Products
Search

This Product

    Application Real-Time Monitoring Service:Rename an application

    Document Center

    Application Real-Time Monitoring Service:Rename an application

    Last Updated:Mar 11, 2026

    Application Real-Time Monitoring Service (ARMS) identifies each application by the name that the ARMS agent reports. When you rename an application, ARMS reports all new monitoring data under the new name.

    Important

    After you rename an application, monitoring data is reported by using the new name rather than the previous name.

    The rename method depends on the deployment environment:

    Deployment environmentRename supportedMethod
    Container Service for Kubernetes (ACK) cluster, agent 2.5.8.1 or laterYesUpdate the armsPilotCreateAppName parameter in the Deployment
    ACK cluster, agent earlier than 2.5.8.1YesUninstall and reinstall the agent with a new name
    Enterprise Distributed Application Service (EDAS)NoThe names of Java applications deployed in EDAS cannot be changed.

    Rename a Java application in an ACK cluster

    Check the agent version

    Open the version file in the ARMS agent installation directory. The version string has the following format:

    2.5.8_cf020486_20190816150025

    • 2.5.8 -- agent version.

    • 20190816150025 -- build timestamp (August 16, 2019).

    Note

    All agents downloaded after August 20, 2019 are version 2.5.8.1 or later and support in-place renaming.

    Agent 2.5.8.1 or later: update the Deployment

    If the ARMS agent version is 2.5.8.1 or later, you can rename the application without reinstalling the agent:

    1. In the Deployment YAML, set the armsPilotCreateAppName environment variable to the new name.

         spec:
     containers:
       - name: <your-container>
         env:
           - name: armsPilotCreateAppName
             value: "<new-application-name>"    # Replace with the desired name

    2. Apply the updated Deployment to restart the pods.

    3. After the pods restart, verify that ARMS reports monitoring data under the new name.

    Agent earlier than 2.5.8.1: reinstall the agent

    If the ARMS agent version is earlier than 2.5.8.1, uninstall and reinstall the agent with the new application name:

    1. Uninstall the existing ARMS agent. For more information, see Manually install an ARMS agent for a Java application.

    2. Reinstall the agent and specify the new application name during installation.

    Rename a Java application in EDAS

    The names of Java applications deployed in Enterprise Distributed Application Service (EDAS) cannot be changed.