Generate Apps Diagnostics and Analyze with Einstein

You can generate diagnostics for your CloudHub apps and run an AI-powered analysis with Einstein. Use one of these options:

Download diagnostics from Runtime Manager
Generate diagnostics with MuleSoft Diagnostics Agent

Understanding Diagnostics

Diagnostics display the Java thread dump of each CloudHub worker in each deployment. These indicate the current state of the server, which is helpful for debugging and support. CloudHub diagnostics include the Diagnostic Information Analysis File (DIAF).

The DIAF is a structured, standardized plain-text file. It centralizes diagnostic data and organizes it for improved automated and manual analysis. The DIAF captures the state of events, operations, and critical application data. See Mule Troubleshooting Plugin.

Diagnostics aren’t available for apps on Mule versions earlier than 3.8.0 (excluding 3.7.4).

DIAF is available for applications running on these Mule versions:

4.6.23 and later 4.6.x versions
4.9.10 and later 4.9.x versions
4.10.x and later

Without DIAF, CloudHub gives you a text file: appName-instance-instanceId-workerNumber-diag.txt. When DIAF is included, you get a .zip file instead. Open the file in a text editor or unzip the archive as needed.

Download Diagnostics from Runtime Manager

To download diagnostics from Runtime Manager:

In the Deployments section, select the date and worker for which you want to download diagnostics.
Click the download icon for the worker.
Select Diagnostics.

To download a diagnostics file directly, use this URL:

api/v2/organizations/{{orgId}}/environments/{{envId}}/applications/{{appName}}/instances/{{instanceId}}/diagnostics

Analyze Diagnostics with Einstein

Before analyzing diagnostics with Einstein:

Connect your MuleSoft organization to a Salesforce account.
Enable Agentforce for your organization. See Enable Agentforce for Your Anypoint Platform Organization.
Enable Einstein entitlement for your Anypoint Platform organization. See Enable Einstein Entitlement and Routing in Anypoint Platform.
Verify that you have either the Mule Developer Generative AI User or Organization Administrator role.
Update your Mule runtime to 4.6.23 LTS, 4.9.10 LTS, 4.10 Edge, or later.
Verify that your Mule application is running.

Run Analyze with Einstein

To run and download the Einstein analysis:

From Anypoint Platform, select Runtime Manager > Applications.
Select the app name.
In the navigation menu, select Logs.
In the Deployments section, select the date and worker for which you want to run the analysis.
Click the download icon for the worker and select Analyze with Einstein.
After the process completes, click the download icon to download an .html file containing the analysis.

Generate Diagnostics with MuleSoft Diagnostics Agent

On the Runtime Manager Diagnostics page, run the MuleSoft Diagnostics Agent to generate diagnostics on demand for a chosen instance. Download the diagnostics for manual inspection, or Analyze with Einstein (or both).

From Anypoint Platform, select Runtime Manager > Applications.
Select the app name.
In the navigation menu, select Diagnostics.
Select an active instance from the dropdown list.
Click the Analyze & Troubleshoot dropdown. You have these options:
- Select Generate Mule Diagnostics to generate and download the diagnostics for manual inspection.
  1. Click Download to download the Mule diagnostics files.
- Select Analyze with Einstein to generate the Mule diagnostics and run the analysis simultaneously.
  1. Click View Analysis to open the analysis page.

Generate Mule Diagnostics

When you choose Generate Mule Diagnostics and click Download, you get a .zip file. The archive contains:

Mule Thread Dumps

A thread dump is a snapshot of all the threads in an instance that shows the current state of the server.

Diagnostic Information Analysis File (DIAF)

Unresolved include directive in modules/ROOT/pages/ch-diagnostics-agent.adoc - include::partial$diagnostics-agent.adoc[]

The DIAF doesn’t replace application logs.

Considerations and Limitations

The MuleSoft diagnostics agent uses Einstein generative AI. Limits for running analyses apply per application and per organization:

10 analyses per application, per hour
50 analyses per organization, per hour
50 analyses per application, per day
200 analyses per organization, per day

CloudHub retains Mule diagnostics for 30 days or up to 150 MB.