Contact Free trial Login

Runtime Manager Agent

logo cloud disabled logo hybrid active logo server active

Anypoint Runtime Manager agent is a Mule runtime engine plug-in that exposes the Mule API. 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 Strategies.

Runtime Manager is available only for enterprise versions of Mule, not for community versions. The agent supports Mule 3.6.0 or later.

You can use the agent to monitor and control Mule instances by calling Runtime Manager agent APIs from external systems and having Mule publish its data to external systems. 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

Installation Location

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 Runtime Manager Agent.

Communication Protocols

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 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.

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 .

Connecting 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:

We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used and to tailor advertising. You can read more and make your cookie choices here. By continuing to use this site you are giving us your consent to do this.