--- schema_version: "1" id: 8d529de7203ac16004b556b463d1e69a3e1cfbf84c40533faf9927098dae8559 title: Runtime Manager Agent collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/runtime-manager/runtime-manager-agent.md canonical_url: https://docs.mulesoft.com/runtime-manager/runtime-manager-agent source_site: docs.mulesoft.com content_type: documentation content_hash: d3d0c5cc9d6da46b33c2c0c235cc3bd8441d98188a118403d929c447a65db989 description: MuleSoft Documentation Site latest: true --- --- product: Runtime Manager keywords: agent, mule, servers, monitor, notifications, external systems, third party, get status, metrics --- # Runtime Manager Agent > For the full documentation index, see: https://docs.mulesoft.com/llms.txt [![logo hybrid active](/mulesoft/current/en-us/_/img/icons/hybrid-cloud.svg "Hybrid")Hybrid](deployment-strategies#hybrid-deployments)[ ![logo server active](/mulesoft/current/en-us/_/img/icons/server-cloud.svg "Anypoint Platform PCE")Private Cloud Edition](deployment-strategies#anypoint-platform-private-cloud-edition) The Anypoint Runtime Manager agent is a Mule runtime engine plug-in that enables communication with Mule runtime engine. Runtime Manager (both the cloud console managed by MuleSoft and Anypoint Platform Private Cloud Edition) uses this agent to communicate with its registered Mule instances. For information about how the Runtime Manager agent communicates with Runtime Manager, see [Deployment Options](https://docs.mulesoft.com/runtime-manager/deployment-strategies). The Runtime Manager agent is available only for enterprise versions of Mule, not for community versions. You can use the agent to monitor and control Mule instances by calling the Runtime Manager agent APIs from external systems and having Mule publish its data to external systems. The Runtime Manager agent features include: - Controlling applications, domains, and services: - List, deploy, undeploy, get status of, start, or stop applications - List, deploy, undeploy, or redeploy domains (REST transport only) - Publishing Mule metrics to external analytics systems ## Prerequisites - The current version of Mule is installed. To download the latest agent, see [Download the Agent From MuleSoft Help Center](https://docs.mulesoft.com/runtime-manager/installing-and-configuring-runtime-manager-agent#download-the-agent-from-the-support-portal). > [!IMPORTANT] You must have an Enterprise support account to download the agent. - Your enterprise license is current. For information about obtaining and installing an enterprise license, see [Install an Enterprise License](https://docs.mulesoft.com/on-premises/latest/installing-an-enterprise-license). ## Installation Location The Runtime Manager agent is installed into your `$MULE_HOME/plugins` directory and reads its configuration from a single `mule-agent.yml` file. For installation instructions and download links, see [Install or Update the Runtime Manager Agent](https://docs.mulesoft.com/runtime-manager/installing-and-configuring-runtime-manager-agent). ## Communication Protocols The Runtime Manager agent supports two communication protocols: - **WebSockets** Establishes a connection from the agent to Runtime Manager (cloud-based or PCE console). When you register the agent with Runtime Manager, the agent first makes an outbound HTTPS connection to Runtime Manager. This connection establishes a new secure, full-duplex WebSocket connection between Runtime Manager and the agent. When Mule starts, the agent securely connects to Runtime Manager, enabling you to monitor and manage Mule remotely using the Runtime Manager console. If this link goes down while Mule is still running, statistics and analytics are buffered until the WebSocket connection is reestablished. Additionally, a reconnection strategy is in place in case the WebSocket connection drops. For more information, see [Install or Update the Runtime Manager Agent](https://docs.mulesoft.com/runtime-manager/installing-and-configuring-runtime-manager-agent). - **REST** Allows direct REST connections (either secure or insecure) between Mule and any external client. This enables external clients to access and manage Mule directly using the [Runtime Manager agent REST API](https://docs.mulesoft.com/runtime-manager/runtime-manager-agent-api). For more information, see [Configure REST Connections with amc\_setup Parameters](https://docs.mulesoft.com/runtime-manager/rtm-agent-REST-connections). You can manually edit the `mule-agent.yml` file to configure the agent with both communication connections. See [Enable Both REST Agent Transport and WebSocket Transport](https://docs.mulesoft.com/runtime-manager/rtm-agent-config-yaml#enable-both-rest-agent-transport-and-websocket-transport) . ## Connect to External Systems You can configure the agent plug-in to connect Mule to external systems. Use parameters in the installation script (`amc_setup`) to choose communication methods and external systems. Additionally, MuleSoft provides several open-source Runtime Manager agent modules to enable monitoring outside of Runtime Manager. These modules are provided as-is and receive no support from MuleSoft. To access these modules, see these GitHub repositories: Agent Modules (general) - [Mule 4.x Agent](https://github.com/mulesoft/mule-agent-plugin/tree/master-mule-4.x/mule-agent-modules) JMX Publisher Modules - [Mule 4.x Agent](https://github.com/mulesoft/mule-agent-plugin/tree/master-mule-4.x/mule-agent-modules/mule-agent-monitoring-publishers) ## See Also - [Install or Update the Runtime Manager Agent](https://docs.mulesoft.com/runtime-manager/installing-and-configuring-runtime-manager-agent) - [amc\_setup Parameters](https://docs.mulesoft.com/runtime-manager/installing-and-configuring-runtime-manager-agent#amc_setup-parameters) - [Runtime Manager Agent Architecture](https://docs.mulesoft.com/runtime-manager/runtime-manager-agent-architecture) - [JMX Service](https://docs.mulesoft.com/runtime-manager/jmx-service) - [Extend the Runtime Manager Agent](https://docs.mulesoft.com/runtime-manager/extending-the-runtime-manager-agent)