All Products
Search
Document Center

Application Real-Time Monitoring Service:Troubleshoot ARMS agent log errors

Last Updated:Mar 11, 2026

This topic describes how to locate Application Real-Time Monitoring Service (ARMS) agent logs and resolve common log errors.

Log file location

ARMS agent logs are stored in the ArmsAgent/log directory under the agent installation path.

Resolve the "LicenseKey is invalid" error

The LicenseKey is invalid error means the ARMS agent failed to authenticate with the ARMS backend. This error has two common causes.

Cause 1: Invalid or missing license key

The license key ties the agent to a specific application in the ARMS console. If the key is incorrect or the target application does not exist, authentication fails.

To resolve this issue:

  1. Log in to the ARMS console and verify that the target application exists. If the application was deleted or was never created, create it first.

  2. Verify that the license key specified when the ARMS agent was installed is valid. If the license key is invalid, update it with the correct license key.

Cause 2: Region mismatch between agent and application

ARMS operates across multiple regions. The agent download URL determines which regional endpoint the agent connects to. If the agent was downloaded from a different region than the one where the application is registered, authentication fails.

To resolve this issue:

  1. Log in to the ARMS console and note the region where your application is registered.

  2. Verify that the ARMS agent download URL corresponds to the same region. For example, if the application is registered in the China (Hangzhou) region, the agent must be downloaded from the China (Hangzhou) endpoint.

  3. If the regions do not match, download the ARMS agent from the correct regional endpoint and verify that the LicenseKey is invalid error no longer appears in the ArmsAgent/log directory.