Contact Free trial Login

Insight

logo cloud active logo hybrid active logo server disabled logo pcf disabled

Insight is not supported on Anypoint Platform Private Cloud Edition.

Insight is a troubleshooting tool that gives you in-depth visibility into business transactions and events on your Mule apps deployed through Runtime Manager. Insight makes information searchable and helps you find and recover from any errors that occurred during message processing by tracking everything your data does in an app and replaying your transactions instantly.

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?

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

When Insight is enabled, data processing performance is affected. Do not enable Insight for long periods of time for production environments. To monitor a production environment, use the tools listed in the monitoring section.

Insight does not support visibility into batch processing.

Limitations

With Insight:

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

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

Do not leave Insight enabled for extended periods of time in production environments. Insight should be used for troubleshooting purposes only.

Enabling Insight

To enable Insight on apps that run on on-premises servers, you must obtain special entitlements for your account. Contact your MuleSoft sales representatives to obtain the required enablements.

To track, aggregate, and store Mule events by default, Insight requires some processing and network overhead. Complete the following procedure to enable Insight to track the events your Mule servers generate.

  1. Sign into your Anypoint Platform account.

  2. Click Runtime Manager.

  3. Click Applications in the menu on the left, and select an application to open its 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 select the Insight tab:

    insight 320c1
  6. Select one of the tracking options:

    • Disabled to not use Insight

    • Metadata to track only events

    • Metadata and Replay to track events and enable the ability to instantly replay a transaction from the console. For more information, see Diagnosing Problems and Replaying Transactions.

      Metadata and Replay is only available on Mule 3 applications deployed to CloudHub, and replay only works for flows that have inbound endpoints.
  7. Click Apply changes to apply the settings.
    After you enable Insight, the following events are tracked by default:

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

    • Flow initiation and completion

    • Custom business events you embed in your Mule flows

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

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.

When deploying your application on Runtime Manager, you must make sure that in the Insight tab you select either Metadata or Metadata and Replay.

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 may have configured.

  • Metadata: Customized key/value pairs that you specify as part of custom events in your application. The information that Insight tracks at this level presents information about high-level business events.

The following image illustrates where to find transactions, events, and metadata on the Insight dashboard.

CHInDash2

Customizing the Transaction ID

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

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.

Searching or Filtering Transactions

On the Insight tab of the Runtime Manager console, you can use a search tool or filter data to refine the results displayed. This table lists how to specify search or filter criteria:

Action To Apply

Display a specific transaction

Click Insight. Click Advanced in the Search field and in Transaction ID, type the ID value. Click Apply.

CHInTransID

Display only transactions which failed

Indicate Any, Completed, or Failed.

CHInAny

Display transactions within a specific date range

  • Click Advanced > Date & Time to specify a date or a range:

CHInDateTime2
  • Click and drag within the graph to select a specific date range

CH_date+range+click+drag

Locate transactions according to flow name, exception message, processing time, and/or any custom business data

In your application, click Advanced in the Search field to locate additional search parameters.

CHInBizData
To enable the Business Data field your app must have business events.

Save Search

To save a search, click Save search:

CHSaveSearch

Filtering Events

Within transactions, use the Transaction Details to further refine the types of events that Insight displays for each transaction. Click the events Transaction Details dropdown to reveal possible filter criteria. If you are debugging, you may find it useful to see all events so that you can drill down into the detailed steps of your flow. If you are interested in analyzing higher level business information, you may wish to apply a filter so as to view only your custom business events.

CHTransactionDetails

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

  • If your user role is Support, the default events filter setting display only custom events.

  • If your user role is Admin or Developer, the default events filter setting displays custom events, endpoint events, and message processor events, but does not display flow events.

Data Persistence

Insight does not have a size limit and displays all transactions in your application for a period of 30-days. Events are kept for a period of 2-days.

Replay data for applications created before Oct 7, 2017 are stored in the default region: us-east-1.
New applications and applications whose region changed after Oct 7, 2017 use region-specific storage. Insights Replay Data is not preserved when switching regions. Verify that this doesn’t violate any of your compliance requirements.

Diagnosing Problems and Replaying Transactions

Insight’s message replay feature enables advanced error recovery. When you encounter a failed transaction (as displayed on Insight’s dashboard), you can diagnose the problem, fix the root issue, then replay the transaction that failed. The following example demonstrates this functionality.

Transaction Failed

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

CHExcMsg

Fix Then Replay

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.

Currently, the replay feature is supported only for Mule 3 applications and for flows that have inbound endpoints.

Click the replay icon (circular arrow) next to the first event in the failed transaction to replay it:

CHReplayButton

Insight requests for confirmation (below, top), then confirms that it has replayed the message during which the transaction first failed (below, bottom). Insight displays replayed transactions immediately on the dashboard and in the Logs tab.

CH_replay_transaction_sure
CH_replay-transaction-replayed

Purge Replay Transaction Data

In the Insight tab for an application, click Purge Replay Data to delete all existing replay data for that application.

This action cannot be reversed.