---
schema_version: "1"
id: e8f3f89785af1e7c9cd0fa014101226dfa69919227232525631e612eb41698bd
title: View Log Data
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/cloudhub/viewing-log-data.md
canonical_url: https://docs.mulesoft.com/cloudhub/viewing-log-data
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 69072580aac9311c668abc24e400897535ce849edf5fa2f201c693537c7206b9
description: MuleSoft Documentation Site
latest: true
---
---
product: CloudHub
---

# View Log Data

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

CloudHub provides access to log data that includes deployment messages and events for each worker
and Mule runtime engine logs.

Logs and diagnostics are currently available only for applications deployed to CloudHub workers. For
applications deployed to a local server, you can send data to external analytics software. See
[Export Data to External Analytics Tools](https://docs.mulesoft.com/runtime-manager/sending-data-from-arm-to-external-analytics-software).

For more advanced searching and log management, you can:

- Use Anypoint Monitoring.

  See [Anypoint Monitoring Overview](https://docs.mulesoft.com/monitoring/).

- Integrate your CloudHub app with your logging system using the Log4j configuration.

  See [Integrate with Your Logging System Using Log4j](https://docs.mulesoft.com/cloudhub/custom-log-appender).

## View Logs

To view logs for applications deployed to CloudHub:

1.  In Anypoint Platform, select **Runtime Manager**.

2.  In the Runtime Manager navigation menu, click **Applications**, and then click the application
    name.

3.  In the navigation menu, click **Logs**.

4.  In the **Deployments** section, filter the output by day, deployment, system log, and workers.

    To remove a filter, deselect the checkbox for the date:

    ![Filter log output by deployment in the Deployments section](/mulesoft/current/en-us/cloudhub/_images/cloudhub-logs-deploy.png)

    Figure 1. The arrow shows the checkbox to filter log output by deployment in the **Deployments**
    section.

## Download Logs

For each worker in a CloudHub deployment, you can download logs specific to that worker’s activity:

1.  In the **Deployments** section, select the date and worker for which you want to download logs.

2.  Click the download icon for the worker and select **Logs**:

    ![Download log output by worker in the Deployments section](/mulesoft/current/en-us/cloudhub/_images/cloudhub-logs-download.png)

    Figure 2. The arrow shows the icon to download log output by deployment in the **Deployments**
    section.

CloudHub downloads the log output to a text file in the format
`_deploymentID_._instanceID_-_workerNumber_.log`. Use a text editor to view the log file.

To archive or download CloudHub application logs for audit, analytics, or other purposes at regular
intervals, use the custom log appender to extract logs. See
[Integrate with Your Logging System Using Log4j](https://docs.mulesoft.com/cloudhub/custom-log-appender).

## Download Mule Logs

Mule logs display the logs of the Mule runtime engine for CloudHub. The Mule log contains
information about app and lifecycle events. For example, the log records an entry when a Mule
service or app starts, deploys, stops, or undeploys.

1.  In the **Deployments** section, select the date and worker for which you want to download Mule
    logs.

2.  Click the download icon for the worker and select **Mule Logs**:

    ![Download Mule log output in the Deployments section](/mulesoft/current/en-us/cloudhub/_images/cloudhub-logs-mule-download.png)

    Figure 3. The arrow shows the icon to download Mule log output by deployment in the
    **Deployments** section.

CloudHub downloads the Mule log output to a text file in the format
`_appName_-instance-_instanceID_-_workerNumber_-mule_ee.log`. Use a text editor to view the log
file.

For more information about Mule logs, see
[Runtime Log](https://docs.mulesoft.com/mule-runtime/latest/logging-in-mule#runtime-log).

## Deployment History Persistence

CloudHub stores up to 30 days of inactive deployments history based on the last modified time of the
deployment.

## Log Persistence

CloudHub stores up to 100 MB of log data per application per worker, or up to 30 days, whichever
limit is reached first.

## Log Timezones

CloudHub stores log data in Universal Time (UTC); however, the console displays the log using your
computer’s local time zone.

## Retrieve Logs Using the CloudHub API

To retrieve application logs programmatically, use the CloudHub API log endpoints. See
[CloudHub API Reference](https://docs.mulesoft.com/cloudhub/cloudhub-api-reference).

When filtering by time range, the `startTime` and `endTime` parameters require ISO 8601 UTC format
with microsecond precision (`YYYY-MM-DDTHH:mm:ss.SSSSSSZ`), for example,
`2025-12-25T10:00:00.000000Z`. These parameters don’t accept epoch (Unix) timestamps.

## Search Logs

Search for logs that contain specified values or search for logs by date and priority.

To search logs:

1.  Enter a value in the search box, or click **Advanced** to search for logs for a specified time,
    day, date range, and message priority.

2.  Click **Apply**.

    ![Display Advanced search and Priority on the Logs page](/mulesoft/current/en-us/cloudhub/_images/cloudhub-logs-search-adv.png)

    Figure 4. The screenshot shows (**1**) **Advanced** search and (**2**) **Priority** on the
    **Logs** page.

You can search with queries. For more information, see
[Log Search Syntax](https://docs.mulesoft.com/cloudhub/cloudhub-log-search-syntax).

### Search by Date and Time

The **Date & Time** filter lets you search the log by specifying a date range. Possible values are:

- **Last hour**

- **Last 24 hours**

- **Last week**

- **Last month**

### Search by Message Priority

The **Priority** filter lets you view specific events in the log. You can also specify different
priorities by typing `priority<type>` in the search box, as shown in the **Command** column in the
table.

Possible values are:

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Value</th><th>Description</th><th>Command</th></tr></thead><tbody><tr><td><div><div><p>All Priorities</p></div></div></td><td><div><div><p>List all messages</p></div></div></td><td><div><div><p>N/A</p></div></div></td></tr><tr><td><div><div><p><code>ERROR</code></p></div></div></td><td><div><div><p>List only error messages, such as when an exception occurs.</p></div></div></td><td><div><div><p>priority:ERROR</p></div></div></td></tr><tr><td><div><div><p><code>FATAL</code></p></div></div></td><td><div><div><p>List only fatal messages for when an application fails</p></div></div></td><td><div><div><p>priority:FATAL</p></div></div></td></tr><tr><td><div><div><p><code>INFO</code></p></div></div></td><td><div><div><p>List informative messages</p></div></div></td><td><div><div><p>priority:INFO</p></div></div></td></tr><tr><td><div><div><p><code>SYSTEM</code></p></div></div></td><td><div><div><p>List messages about application and worker startup</p></div></div></td><td><div><div><p>priority:SYSTEM</p></div></div></td></tr><tr><td><div><div><p><code>CONSOLE</code></p></div></div></td><td><div><div><p>List message about console events such as setting the object store</p></div></div></td><td><div><div><p>priority:CONSOLE</p></div></div></td></tr><tr><td><div><div><p><code>WARN</code></p></div></div></td><td><div><div><p>List warning messages</p></div></div></td><td><div><div><p>priority:WARN</p></div></div></td></tr><tr><td><div><div><p><code>DEBUG</code></p></div></div></td><td><div><div><p>List debugging messages</p></div></div></td><td><div><div><p>priority:DEBUG</p></div></div></td></tr></tbody></table>

> [!NOTE] Heap dumps cannot be shared. Instead, our **Support Center** representatives can analyze
> the dumps and share the required information with you.

## See Also

- [Integrate with Your Logging System Using Log4j](https://docs.mulesoft.com/cloudhub/custom-log-appender)

- [Configuring Logging](https://docs.mulesoft.com/mule-runtime/latest/logging-in-mule)

- [Log Search Syntax](https://docs.mulesoft.com/cloudhub/cloudhub-log-search-syntax)

- [Export Data to External Analytics Tools](https://docs.mulesoft.com/runtime-manager/sending-data-from-arm-to-external-analytics-software)

- [Monitor Applications and Servers](https://docs.mulesoft.com/runtime-manager/monitoring)

- [Generate Apps Diagnostics and Analyze with Einstein](https://docs.mulesoft.com/cloudhub/ch-diagnostics-agent)

- [Deployment Options](https://docs.mulesoft.com/runtime-manager/deployment-strategies)
