Troubleshoot the Runtime Manager Agent | MuleSoft Documentation
# Troubleshoot the Runtime Manager Agent
Private Cloud Edition 
Connection issues between your on-premises Mule runtime engine and the Runtime Manager agent might cause discrepancies, such as metrics not appearing in the server monitoring dashboard in Runtime Manager.
`$MULE_HOME` is environment variable that specifies the location where you installed Mule. These instructions use paths for Mac or Linux. If you are using Windows, replace the `$MULE_HOME` path with `%MULE_HOME%`.   
---  
## Troubleshoot Connection Issues Between the Agent and Mule
To troubleshoot connection issues:
  1. Check the JVM you are using.
If you are using the IBM JVM, you must use a different truststore file than the default truststore installed by the Runtime Manager agent.
  2. Ensure you are using the latest agent version.
    1. Check the agent version.
In the Runtime Manager navigation menu, select **Servers** and then click the server name. The agent version appears on the **Dashboard** page:
Figure 1. The arrow shows the Runtime Manager agent version on the server **Dashboard** page.
    2. Check the Runtime Manager Agent Release Notes to determine the latest agent version compatible with your Mule version.
    3. Update the agent, if necessary.
See Update the Agent.
  3. Verify that the license and certificate are not expired.
    1. In the Runtime Manager navigation menu, select **Servers** and then click the server name. The expiration dates appear on the **Dashboard** page:
Figure 2. The arrow shows the expiration dates on the server **Dashboard** page.
To view the dashboard for a server in a server group or cluster, click the server name in the details pane.
       * If the license has expired, see Install an Enterprise License.
       * If the certificate has expired, see Renew Server Certificates.
  4. Verify connectivity with all required hosts.
    1. Ensure that you allow access to required hosts and ports for Anypoint Platform services.
See Ports, IP Addresses, and Hostnames to Allow.
    2. Verify that your firewall or proxy server is not intercepting the Runtime Manager certificate.
See Verify That the Proxy Server Does Not Modify the Runtime Manager Certificate.
  5. Verify that the `mule-agent.yml` file is not corrupted or empty.
The `mule-agent.yml` file contains configuration information for the agent. If the `$MULE_HOME/conf/mule-agent.yml` file contains non-ASCII characters or is empty:
     * If you have a backup, use it to restore the corrupted `mule-agent.yml` file.
     * If you don’t have a backup, follow these steps:
       1. Remove the Mule server from Runtime Manager.
See Shut Down, Restart, or Delete Servers.
       2. Uninstall the agent.
See Uninstall the Agent.
       3. Update the agent to the latest supported version.
See the Runtime Manager Agent Release Notes and Update the Agent.
       4. Add the Mule server to Runtime Manager.
See Add Servers to Runtime Manager.


## Collect Agent Installation Information for Support
You can use the `$MULE_HOME/bin/amc_debug` script to collect information used by Support to troubleshoot the Anypoint Runtime Manager agent installation issues. If following the troubleshooting steps doesn’t solve your problem with the Runtime Manager agent, run the script and save the output before filing a support ticket.
The `amc_debug` script performs the following actions:
  1. Discovers the Mule agent JVM process
  2. Extracts the thread dump (not forced if possible)
  3. Optionally extracts the heap dump (if you specify the `-heap` option)
This step can cause delays in running applications.
  4. Extracts the Java version, CPU usage, memory usage, and disk usage
  5. Copies all logs
  6. Copies the configuration files for the Runtime Manager agent
  7. Archives all the information collected in a ZIP file


### Run the amc_debug Script
To run the `amc_debug` script to collect information about the agent installation:
  1. Open a terminal window and change to the `$MULE_HOME/bin` folder.
  2. Run the script:
`./amc_debug`
Include the `-heap` option to extract the heap in addition to the other data.
After the script finishes, the folder `$MULE_HOME/bin` contains a ZIP file with a name similar to `snapshot_202103161626.zip`.
  3. Send the ZIP file to Support.


The `amc_debug` script is currently available on Linux/Unix-based systems only.   
---  
## See Also
  * Install or Update the Runtime Manager Agent
  *   * Runtime Manager Agent Notifications
  * Extend the Runtime Manager Agent
  * Internal Handler Buffering