> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/frequently-asked-questions/how-do-i-handle-a-failed-task.md).

# How do I handle a failed task?

When working with workflows in MESA, you may encounter some failed tasks on the [Activity tab](/workflow-activity.md) or by [manually running your workflow](/workflow-builder/testing.md). The workflow will not process the automation completely if an error occurs during any tasks of the workflow.

Follow the steps below on how to troubleshoot an error that occurs during any tasks of the workflow.

### Manual Run Feature <a href="#test" id="test"></a>

While using MESA's [Manual Run feature](/workflow-builder/testing.md), you may encounter some failed tasks. This Manual Run feature is available in the Trigger step of your workflow or the Run workflow button in the Builder tab.

<figure><img src="/files/zrekMbjTtt5bb1wH9tTa" alt="Screenshot of the MESA workflow Builder tab using the Manual Run feature from the Trigger step, spotlight the Run workflow button."><figcaption></figcaption></figure>

If you see an error appearing like below, you can check the error message under the failed task. In this example, the error message states "Please select a connection."

<figure><img src="/files/AoijC5dGDb89MOVFN18Q" alt="Screenshot of a failed task in a MESA manual run showing the error message Please select a connection, spotlight the error message under the failed task."><figcaption></figcaption></figure>

Switch to the **Logs** view in the task options of a run to get more information regarding how the manual run processed. Go back to the **Activity** tab once you are done viewing.

<figure><img src="/files/198IrMDNJopjNXF0Exmk" alt="Screenshot of the task options for a MESA run switched to the Logs view for more information on how the manual run processed, spotlight the Logs view."><figcaption></figcaption></figure>

In this particular case, you will need to select or create a [connection](https://docs.getmesa.com/going-further/credentials) and fill out the Spreadsheet or Sheet Name in the Google Sheets Create Row step. You would make these changes in the Builder tab and save your changes.

Go back to the task in the Activity and click **Replay from this task** in the Task options. Check to see if your changes have resolved the error.

### Logging debug mode <a href="#debug" id="debug"></a>

If you find that you are still unable to resolve the error, you can do additional troubleshooting by turning on Logging debug mode in the workflow's Acitivity tab.

1\. In the Activity tab, turn on **Debug Logs** while troubleshooting any errors. You can turn off debug logs mode once you are done with troubleshooting.

<figure><img src="/files/U0zFMosFfL511g7TQ6Ni" alt="Screenshot of the MESA workflow Activity tab, spotlight the Debug Logs toggle."><figcaption></figcaption></figure>

2\. Scroll or search within the **Activity** tab and locate the failed task which will contain an **Error** status on the left-hand side.

3\. Click on the checkbox to the left of the task to select it.

<figure><img src="/files/NRIkkotjk2xLZJhGr6cL" alt="Screenshot of the MESA Activity tab with a failed task showing an Error status, spotlight the checkbox to the left of the task."><figcaption></figcaption></figure>

4\. Replay the entire workflow starting from the [Trigger](/workflow-builder/triggers.md) while Logging debug mode is turned on. You can click on the Bulk actions while the run is selected. Click **Replay entire workflow** to replay the run.

<figure><img src="/files/6zTB7DCkTxCGhDP6wAeT" alt="Screenshot of the MESA Activity tab with a run selected and the Bulk actions menu open, spotlight the Replay entire workflow option."><figcaption></figcaption></figure>

5\. MESA provides a more detailed layout under the [Logs](/workflow-activity/logs.md) page. Logs enable you to search for past tasks or to view an entire chain of actions and their information for a specific task. You click on the Run Options (three-vertical-dot icon) on the selected run and click on **Logs**.

<figure><img src="/files/Rq0dvp5hq1DQDkJUMZLX" alt="Screenshot of the MESA Activity tab with the Run Options three-dot menu open on the selected run, spotlight the Logs option."><figcaption></figcaption></figure>

Since **Logging** and **Logging debug mode** are turned on, you will see more information related to the failed task appear.

The messages with the red **Error** tag will be the most important to review.

<figure><img src="/files/vORmQ7h5GElGbYZfREtk" alt="Screenshot of the MESA Logs page with Logging debug mode on showing detailed messages for the failed task, spotlight the red Error tagged messages."><figcaption></figcaption></figure>

7\. Once you have made adjustments to your workflow to fix the error, you can replay the failed task.
