Contact Free trial Login


logo cloud active logo hybrid active logo server disabled logo rtf disabled

Insight is a troubleshooting tool that provides in-depth visibility into business transactions and events on your Mule apps deployed to CloudHub and on-premises servers. Insight tracks everything your data does in an app so you can find and recover from errors that occur during message processing.

For Mule 3 apps only, Insight supports the ability to replay transactions for advanced error recovery. Replay is not supported for Mule 4 apps.

Enabling Insight can significantly impact data processing performance and memory consumption. For this reason, do not enable Insight for long periods for production environments. Use Insight for troubleshooting only.

For information about tools to use for monitoring a production environment, see Monitoring Applications and Servers.

The Insight dashboard enables you to view events that occur within the flows that handle your business transactions. You can drill down into event-related data to analyze the root cause of failures, isolate performance bottlenecks, and test for compliance with company procedures.

Insight helps you answer questions about your integrated apps, such as:

  • What happened with a particular transaction or synchronization?

  • When did the transaction occur? How long did it take?

  • What was the result of a transaction?

  • If something went wrong during processing, at what point did the failure occur?

After you enable Insight, the following items are tracked by default:

  • Data passing through endpoints (inbound and outbound) in your Mule applications

  • Flow initiation and completion

  • Custom business events that you embed in your Mule flows

Limits and Limitations

The following limits apply to events:

  • A single application is limited to 50,000 events per minute.

  • All applications in a single business group are limited to 100,000 events per minute.

Events over these limits are dropped.

Also, no more than 20 custom event definitions per application definition are stored.

Insight does not support visibility into batch processing. See Batch Processing.

Insight does not preserve replay data when switching regions. Ensure that this doesn’t violate any of your compliance requirements.

Logs for applications deployed to on-premises servers contain event information but not message contents.

Data Persistence

Insight does not limit the size of transactions. Insight displays all transactions in your application for 30 days and keeps events for two days.

Replay data for Mule 3 applications created before October 7, 2017, is stored in the default region us-east-1. Data for Mule 3 applications initially deployed, or moved to a different region, after October 7, 2017 is stored in the region where the application is currently deployed.

Payload Transformation

The following MIME types are always mapped as Strings:


For all other types, Mule agent attempts to transform payloads to another format, based on the Stream type that Mule runtime engine exposes to the Mule agent. For example, Mule agent converts CURSOR_STREAM_PROVIDER payloads to a byte array.

Any streams that are not mapped to String by default appear in the logs.

Enable or Disable Insight

To enable Insight to track the events your Mule servers generate:

  1. Sign in to your Anypoint Platform account.

  2. Click Runtime Manager.

  3. Click Applications in the menu on the left, and click the application in the File column to open the management panel on the right side of the page.

  4. In the management panel, click Insight.

  5. Click Settings in the menu on the left, and then click the Insight tab:

    Insight tab in the Settings page
    Figure 1. The arrow shows the Insight tab on the Settings page.
  6. Select one of the tracking options:

    • Disabled to disable Insight

    • Metadata to track only events

    • Metadata and Replay to track events and enable the ability to instantly replay a transaction from the console

      This option is available only for Mule 3 applications deployed to CloudHub. Replay only works for flows that have inbound endpoints.

  7. Select the checkbox to confirm that you want to enable Insight, and click Apply Changes.

  8. Click Apply Changes to save the application settings.

Searching and Filtering Transactions and Events

The Insight dashboard displays information at three tracking levels:

  • Transactions

    Logical groupings of related events that often correspond to a business view of the system

  • Events

    Low-level details of a transaction

    Events map to message processors and endpoints and reveal information about exceptions and any custom business events you might have configured.

  • Metadata

    Customized key-value pairs that you specify as part of custom events in your application

    The detail that Insight tracks at this level provides information about high-level business events.

The following image shows where to find transactions, events, and metadata on the Insight dashboard:

Tracking levels on the Insight dashboard
Figure 2. The screenshot shows (1) the Transactions level, (2), the Events level, and (3), the Metadata level on the Insight dashboard.

Business data, if configured, appears in the Metadata area (3) of the dashboard. See Setting Up Business Events.

Search or Filter Transactions

On the Insight page, you can search or filter data to refine the results displayed. You can search for:

  • A specific transaction by transaction ID

  • Transactions within a specific date range

  • Transactions according to flow name, exception message, processing time, and any custom business data

    To enable the Business Data field your app must have business events configured. See Setting Up Business Events.

To search or filter transactions:

  1. Click Insight in the menu on the left.

  2. Enter your search criteria in the Search field.

  3. Click Advanced in the Search field.

  4. Specify filter options:

    Advanced search filter fields on the Insight dashboard
    Figure 3. The screenshot shows the advanced search filter fields on the Insight dashboard.
    • To display only failed or completed transactions, select Failed or Completed from the menu in the Transaction ID field:

      Advanced search filter fields on the Insight dashboard
      Figure 4. The arrow shows the menu in the Transaction ID field.
    • To display transactions within a specific date range, specify a date or range in the Date & Time fields.

      Alternatively, drag within the graph to select a specific date range:

      Selected transaction range on the Insight dashboard
      Figure 5. The arrow shows the selected transaction range on the Insight dashboard.
  5. Click Apply on the Advanced pane to apply your search criteria.

  6. If you want to save a search, click Save search:

    Save search icon on the Insight dashboard
    Figure 6. The arrow shows the Save search icon on the Insight dashboard.

    Runtime Manager saves the search to the name you specify.

After you save a search, you can:

  • Run a saved search by clicking the search name.

  • Edit a saved search by hovering over the search name and click the Edit link:

    Saved search being edited
    Figure 7. The arrow shows the saved search being edited.

    Click Done to save your changes.

  • Delete a saved search by clicking the Edit link, and then clicking the delete icon (trash can) to the right of the search name.

Filter Events

You can refine the types of events that Insight displays for each transaction.

When debugging, you might find it useful to see all events so that you can drill down into the detailed steps of your flow. If you want to analyze higher-level business information, you can apply a filter to view only your custom business events.

To display the filter options, click the Transaction details menu for a transaction:

Transaction details menu
Figure 8. The arrow shows the Transaction details menu.

The default settings of the events filter depend upon your user role:

  • Support

    The default events filter setting displays only custom events.

  • Admin or Developer

    The default events filter setting displays custom events, endpoint events, and message processor events, but does not display flow events.

Diagnosing Problems and Replaying Transactions

When Insight reports a failed transaction, you can diagnose the problem and fix the root issue.

For Mule 3 applications and flows with inbound endpoints, you can use the Insight message replay feature to replay the transaction that failed.

Transaction Failed Status

For example, when a transaction fails because an application exceeds the limited number of API calls for a Salesforce account, Insight displays the status of the transaction as Failed.

Click to expand the transaction, and then examine the individual events within that transaction. The exception and the error message are listed next to the failed event, as well as an existing stack trace:


Replay Transaction

After investigating the logs and resolving the issue (for example, by purchasing more API capacity) that caused the transaction failure, you can replay the transaction. Replay is available for Mule 3 apps only. It is not supported for Mule 4 apps.

  1. Click the replay transaction icon 2.5% to the right of the first event in the failed transaction to replay it:

    Replay icon and Purge Replay Data button
    Figure 9. The screenshot shows (1) the replay transaction icon and (2) the Purge Replay Data button.
  2. At the prompt, click Replay Transaction to confirm.

    Insight displays an information popup indicating that the transaction was replayed and displays the replayed transactions immediately on the dashboard and in the Logs tab.

Purge Replay Data

To delete all existing replay data for that application, click the Purge Replay Data button.

You can’t restore replay data that has been purged.

Table of Insight Status States

The following table describes the status states that Insight reports:

Status Description


The event failed while being processed and has an associated exception.


The event processed fully and successfully.


The event has started and has not yet completed.


The event has been put on hold due to exceeding the maximum number of events to be processed per transaction (10000). Any event above this number is set as stalled and then processed after the number of events to be processed is no longer exceeded.


If a transaction can’t finish within 24 hours, the events with IN_PROGRESS status change to UNCOMPLETED.

Setting Up Business Events

You can configure business events in your Mule applications by embedding custom business events in flows or by enabling granular event tracking within message processors in your flows.

  • Custom Business Events

    Include custom business event elements at relevant points within the flows of your application to surface the processing information that is most relevant for your business to track.

  • Event Tracking

    Track more granular events by enabling default event tracking for your entire flow or for specific message processors or endpoints within your flow. When you configure the flows in your application, you can explicitly configure the scope for default event tracking. See Configure Default Events Tracking.

Customizing the Transaction ID

For transaction-level events, Insight might display long numeric values in the ID column. You can customize the transaction IDs to display more intuitive values that are relevant to your business requirements.

To do this, use a Mule expression to configure your Mule application to return meaningful information about a transaction, such as order number, tracking number, or employee identification number. See Customize the Transaction ID.

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.