Application Real-Time Monitoring Service:Arthas diagnostics

Application Real-Time Monitoring Service (ARMS) fully integrates all Arthas capabilities and provides the following advantages over a self-managed installation:

• No JDK dependency. You can enable or disable Arthas diagnostics on demand for multiple applications with a single click, without needing to download or install Arthas.

• A web-based UI for common features eliminates the need to memorize commands, look up commands, or write expressions.

• Integration with the ARMS context. You can use the trace command to view the ARMS trace ID.

Enable Arthas diagnostics

1. Log on to the ARMS console. In the left-side navigation pane, choose Application Monitoring > Application List.

2. On the Application List page, select a region at the top of the page and click the name of the target application.

   Note

   The icons in the Language column indicate the following:

   : a Java application connected to Application Monitoring.

   : a Go application connected to Application Monitoring.

   : a Python application connected to Application Monitoring.

   -: an application connected to Managed Service for OpenTelemetry.

3. In the left-side navigation pane, click Application Settings, and then click the Custom Configurations tab.

4. On the Custom Configurations tab, in the Arthas Monitoring section, turn on the Arthas Switch. You can optionally specify the IP addresses of the application instances for which you want to enable Arthas diagnostics.

5. In the lower-left corner of the Custom Configurations tab, click Save.

View Arthas diagnostics

1. Log on to the ARMS console. In the left-side navigation pane, choose Application Monitoring > Application List.

2. On the Application List page, select a region at the top of the page and click the name of the target application.

   Note

   The icons in the Language column indicate the following:

   : a Java application connected to Application Monitoring.

   : a Go application connected to Application Monitoring.

   : a Python application connected to Application Monitoring.

   -: an application connected to Managed Service for OpenTelemetry.

3. In the left-side navigation pane, choose Application Diagnostics > Arthas Diagnostics.

4. From the drop-down list at the top of the Arthas diagnostics page, select the application instance that you want to diagnose.

   • If the agent version of the instance is earlier than 2.7.1.3, you are prompted to upgrade the agent.

   • If the agent version of the instance is 2.7.1.3 or later, the diagnostic information of the instance is displayed.

JVM overview

The JVM overview feature allows you to view JVM-related information for your application, including JVM memory, operating system information, and variable information.

By default, the Arthas diagnostics page displays the JVM Overview tab. On the JVM Overview tab, you can view the following information:

• JVM Memory: information about JVM memory, including heap memory usage, non-heap memory usage, and garbage collection (GC) status.

• Operating System Information: information about the operating system, including the average system load, operating system name, operating system version, and Java version.

• Variable information: information about variables, including system properties and environment variables.

Thread time-consuming analysis

This feature displays all threads in your application and their stack traces to help you quickly identify time-consuming threads.

1. On the Arthas diagnostics page, click the Threading Time Analysis tab.

   The Threading Time Analysis tab displays real-time thread time consumption for the current JVM process and groups similar threads. A summary of thread counts by state is displayed at the top of the page.

2. Click the + icon next to a thread group to expand it and view details for individual threads, including thread ID, CPU usage, and state.

3. To view the stack trace for a specific thread, click View Live Stack in the Actions column for that thread.

   The Thread Details dialog box appears, showing the thread name, running state, and the full stack trace.

Method execution analysis

This feature captures the execution time, input parameters, returned values, and other information for a single execution of a method. You can also drill down into its internal calls. This helps you quickly find the root cause of slow calls, especially for issues that cannot be reproduced offline or have missing logs.

1. On the Arthas diagnostics page, click the Method Execution Analysis tab.

2. On the Method Execution Analysis tab, enter a keyword for the class name in the search box and click the Search icon.

3. From the search results, select the class that you want to diagnose. Then, from the method selection box on the right, select a method of that class and click OK.

   The page displays a randomly captured execution record for the selected method from ARMS or .

   • The Execution Stack section on the left shows the internal call records of the diagnosed method.

     • To drill down into an internal method, click Drill-down in the Actions column.

     • To view the source code, click View Source Code at the top of the Execution Stack section.

       The execution time of each internal method is displayed as a comment in the source code.

   • The Method Execution Result section on the right shows the parameter values, returned value, exception, member variables, and the trace ID for this execution.

   • In the Set Execution Conditions section on the right, to capture a specific method execution record, set the conditions as follows:

     1. Select an overloaded method of the current method.

     2. From the Please select an initial filter key drop-down list, select a key type and click the icon.

        Initial filter key types:

        • params[n]: The n-th parameter of the method.

        • returnObj: The returned value of the method.

        • Method execution time: The duration of method execution.

        • Throw exception: Specifies whether to throw an exception during method execution.

        Note

        If the selected initial filter key is a nested type, you must continue to select its internal fields until you reach a basic type.

     3. Select a filter condition.

     4. Enter a filter value.

     5. Click Add.

        The added filter condition appears in the Current Filter Condition section.

     6. In the upper-right corner of the Execution Stack section, click the Refresh icon to capture a new method execution based on the set conditions.

Object viewer

Use the object viewer to inspect the current state of singleton objects. This is useful for troubleshooting issues related to application state, such as configurations, blacklists or whitelists, and member variables.

1. On the Arthas diagnostics page, click the Object Viewer tab.

2. On the Object Viewer tab, enter a keyword for the class name in the search box and click the Search icon.

3. From the search results, select the class you want to diagnose. Then, from the instance selection box on the right, select an instance of that class and click OK.

   The page then displays the real-time values of the fields in that instance.

   • For simple-type fields, the value is displayed directly in the Details column of the Object field real-time value section.

   • For complex-type fields, click View Details in the Details column of the Object field real-time value section. The field details are displayed in the Field Details section on the right.

     The Field Details section supports deserializing and displaying only one level of a complex field. To view more specific data, Click to view more detailed data for the field.

Real-time dashboard

Use the real-time dashboard to view the real-time status of key components in your system, such as database connection pools and HTTP connection pools. This helps troubleshoot resource-related issues.

1. On the Arthas diagnostics page, click the Live Kanban tab.

2. From the drop-down list on the Live Kanban tab, select a dashboard. Then, from the instance selection box on the right, select an instance for that dashboard and click Add to dashboard.

   The page displays the real-time status for that dashboard. For example, for a Druid connection pool, the dashboard shows real-time status information, including basic configuration, connection pool status, and execution time distribution.

Arthas Shell

For details, see the official open-source documentation.

After you open the Arthas Shell page, select a Line at the top and click Connect. When the connection succeeds, a terminal window appears. You can enter Arthas commands at the command prompt to perform diagnostic operations.