salesforce Dreamforce On-Demand
Contact Us 1-800-596-4880
  1. Homepage
  2. Monitoring
  3. Get Started

  4. Configure Anypoint Monitoring for Mule Apps (CloudHub)

Configure and Enable Anypoint Monitoring for Mule Apps (CloudHub)

To start monitoring Mule apps that are managed in CloudHub, you must deploy them to a supported version of Mule runtime engine and set the runtime version in your Mule app.

Anypoint Monitoring is enabled by default for all CloudHub 2.0 applications.

Supported Versions of Mule Deployed to CloudHub

Use the following Mule runtime engine versions with Anypoint Monitoring:

  • Mule 3 versions 3.8.7 and later
    Versions 3.8.6 and earlier are not supported. Additionally, all runtime versions that have the -AM suffix are deprecated.
    Inbound and outbound metrics are unavailable for hybrid proxy apps that use Mule runtime engine version 3.9.5 or earlier.

  • Mule 4
    To use enhanced metrics for API Analytics, use Mule runtime engine version 4.1.6 or later.

Anypoint Monitoring with Mule runtime engine images receive patch updates as soon as they are available. Because Anypoint Monitoring -AM images are no longer receiving patch updates, switch to a Mule runtime engine (non-AM) image if your production environment requires a Mule runtime engine patch.

Metrics and logs are supported in the following Mule versions:

  • 4.x.x

  • 3.9.x

  • 3.8.7

Metrics are used by graphs and other charts within Dashboards.

Logging in Anypoint Monitoring is available only if your organization has the Anypoint Integration Advanced package or a Titanium subscription to Anypoint Platform.

Set the Runtime Version

To set or change the runtime version for your Mule app:

  • For new and existing Mule apps:

    1. Go to Settings in Runtime Manager for that app.

    2. Choose the new runtime from the Runtime Version selector.

      If you do not see a supported runtime version in the drop-down menu, scroll down to Show Old Patch Releases, click, and select a runtime for your app.

  • For Anypoint CLI deployments:

    If you are using the Anypoint CLI to deploy your Mule app (for example, through a build pipeline), you need to include the --runtime parameter with an appropriate value, for example:

    anypoint-cli --username="..." --password="..."
 --organization="Mythical, Inc"
 --environment="Production" runtime-mgr cloudhub-application deploy
 --runtime="3.9.4" helloworld ~/demoproj2.zip

  • For Maven deployments:

    If you are using Maven for deployment, you must modify the <muleVersion> tag in the pom.xml file. For example, you can change <muleVersion>3.9.3</muleVersion> to <muleVersion>3.9.4</muleVersion>).

Enable Automatic Monitoring for Apps That You Plan to Deploy to CloudHub

If you want your Mule apps to be monitored by default when you deploy them to CloudHub, configure this feature in Anypoint Monitoring before you deploy your apps. If your organization has the Anypoint Integration Advanced package or a Titanium subscription to Anypoint Platform, this feature is enabled by default.

To configure automatic monitoring for each Mule app as it is deployed to CloudHub:

  1. Log in to Anypoint Platform.

  2. In the navigation bar or the main Anypoint Platform screen, click Monitoring.

  3. In the Anypoint Monitoring navigation menu, click Settings:

    monitoring settings screen

  4. Select CloudHub.

  5. Click Enable Anypoint Monitoring for newly deployed CloudHub applications.

If you deployed Mule apps to CloudHub before you enabled this feature, you must enable monitoring for those apps manually. This feature does not retroactively enable monitoring for previously deployed apps.

Enable Monitoring for Apps Previously Deployed to CloudHub

You can enable monitoring for Mule apps running on non-AM versions of Mule in the Anypoint Monitoring Settings page, the application’s Settings page, or by using the Anypoint CLI for continuous integration and delivery (CI/CD).

For supported versions of Mule, see Configure Anypoint Monitoring for Mule Apps.

Enable Monitoring Using the UI

You can use the Settings page in Anypoint Monitoring to enable or disable apps deployed to CloudHub and running on Mule.

  1. Log in to Anypoint Platform.

  2. In the navigation bar or the main Anypoint Platform screen, click Monitoring.

  3. In the Anypoint Monitoring navigation menu, click Settings:

    monitoring settings screen

  4. Select CloudHub.

  5. In the Environment list, select the environment where the application is running.
    A list of running applications is shown for the selected environment.
    You can search for a specific application using the List of resources search box.

  6. Next to the application, click Enable to enable monitoring for the application.

Enable Monitoring in CloudHub Settings

You can enable monitoring for Mule apps running on supported versions of Mule by adding a property to an application deployed to CloudHub.

  1. Log in to Anypoint Platform.

  2. In the navigation bar or the main Anypoint Platform screen, click Runtime Manager.

  3. In the list of applications, select the application for which to enable monitoring.
    The application must be deployed to CloudHub and running on a supported version of Mule.

  4. In the navigation menu, click Settings.

  5. Click Properties, and add the following property:
    anypoint.platform.config.analytics.agent.enabled=true

    enable monitoring cloudhub

    To disable monitoring, change the value to false.

  6. Click Apply Changes.

Enable Monitoring for CI/CD Deployments

Use the Anypoint CLI and set the following property during your CI/CD deployment: anypoint.platform.config.analytics.agent.enabled=true

Performance Impact

Enabling Anypoint Monitoring can impact CPU utilization and memory utilization, which varies depending upon specific application behavior, such as inbound and outbound call rates. For a typical application, expected CPU utilization impact is less than 5%. For an accurate impact analysis specific to your application, test and estimate any performance impact in your pre-production environment prior to enabling monitoring in your production environment.

See Also