> For the complete documentation index, see [llms.txt](https://docs.zerowork.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zerowork.io/using-zerowork/using-run-reports.md).

# Using Run Reports

Run Reports display all the actions that the TaskBot took during its run. These reports are essential for troubleshooting failed runs.

### Where to Find Run Reports

1. On the TaskBots list page

<figure><img src="https://3220183989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg9LcR8XM7TGOzOCDGsCS%2Fuploads%2FdOtyZZP3Z4kCZgSdu45D%2FScreenshot%202024-04-05%20at%2015.50.40.png?alt=media&amp;token=a0c7dc7f-1502-4e92-acfe-5015ad77493c" alt=""><figcaption></figcaption></figure>

2. Inside the TaskBot builder page

<figure><img src="https://3220183989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg9LcR8XM7TGOzOCDGsCS%2Fuploads%2FPa1tDX6hs06D5h72zaEy%2FScreenshot%202024-04-05%20at%2015.51.52.png?alt=media&amp;token=a83e6db8-c526-4b70-b192-473935dba4d8" alt=""><figcaption></figcaption></figure>

***

### How Run Reports Are Displayed

Reports provide detailed information about the TaskBot's run, including timestamps, statuses, and actions taken. Here's an example of how they appear:

<figure><img src="https://3220183989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg9LcR8XM7TGOzOCDGsCS%2Fuploads%2FIy69MtpnVxIflleeZF5d%2FScreenshot%202024-04-05%20at%2015.54.03.png?alt=media&amp;token=6a1deff4-8455-4978-af3c-f099352d6c72" alt=""><figcaption></figcaption></figure>

***

### Tip for Easier Troubleshooting

* Click **View Logs** to access the logs of the run.
* Use the **Side View** feature to position the logs next to your TaskBot workflow for easy comparison.
* Click **View Building Block** to zoom in on the block you're inspecting.

<figure><img src="https://3220183989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg9LcR8XM7TGOzOCDGsCS%2Fuploads%2FGSfoGYVz2M52JLRHxCEk%2FScreenshot%202024-05-28%20at%2013.25.00.png?alt=media&amp;token=09c9e37d-e170-4f30-82a3-a6d2fb8d5773" alt=""><figcaption></figcaption></figure>

Here is an example:

<figure><img src="https://3220183989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg9LcR8XM7TGOzOCDGsCS%2Fuploads%2FlLr0ETnOI8PORzwRPnul%2FScreenshot%202024-05-28%20at%2013.22.36.png?alt=media&amp;token=2cf914c7-a4c6-4f05-9c07-4945b7f9e813" alt=""><figcaption></figcaption></figure>

***

### Notifications

You can set up notifications to be sent via **email**, **Slack**, or **custom** **webhook**. Your notifications will always include error reports.

**Notification Types**

* **Email**: Add recipient email addresses. Here's an example:

<figure><img src="https://3220183989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg9LcR8XM7TGOzOCDGsCS%2Fuploads%2FinsAFJplpZ0iNEEMYTW4%2FScreenshot%202024-11-15%20at%2008.43.33.png?alt=media&amp;token=93dd4dfd-9abf-4535-afba-81002a98cfbf" alt=""><figcaption></figcaption></figure>

* **Slack**: Provide your Slack webhook URL. Learn how to get it [**here**](https://api.slack.com/messaging/webhooks). Here's an example:

<figure><img src="https://3220183989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg9LcR8XM7TGOzOCDGsCS%2Fuploads%2FxOh9nxiEMeRpEFKME3Ci%2FScreenshot%202024-11-15%20at%2008.45.10.png?alt=media&amp;token=3dba71a2-f25c-4fc2-9a8c-b52357004990" alt=""><figcaption></figcaption></figure>

* **Webhook**: Add a custom webhook URL to receive POST notifications. Here’s an example of the JSON structure sent via webhook:

```
{
  "agent_version": "1.1.69",
  "taskbot_id": 1,
  "taskbot_name": "Your TaskBot name",
  "taskbot_url": "https://creator.zerowork.io/workflows/1",
  "run_status": "success" | "fail" | "warning" | "unknown" | "manually_stopped",
  "run_type": "webhook" | "scheduled" | "immediate",
  "run_duration": "2.1 hours",
  "run_errors": [
    {
      "id": 1,
      "timestamp": "2024-10-06T13:01:43.755052-04:00",
      "error_message": "Some error message",
      "counter": 5,
      "screenshot": "<screenshot_url>",
      "building_block": {
        "id": "54254235",
        "name": "Your Custom Block Name",
        "type": "Update Data"
      }
    },
    {
      "id": 2,
      "timestamp": "2024-10-06T13:01:45.755052-04:00",
      "error_message": "Some other error message",
      "counter": 1,
      "screenshot": "",
      "building_block": {}
    },
  ]
}
```
