> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring & Troubleshooting

> Track Agent execution, manage tasks, and resolve issues

## Agent Dashboard

Access the dashboard via the **three-dots menu** next to the Activate button, then select **Agent Dashboard**.

<Frame caption="Agent Dashboard with execution metrics">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/monitoring-1.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=8d6e317ce78a41b9d5f412ba8962b8f5" width="2560" height="1392" data-path="images/guide/agents/monitoring-1.png" />
</Frame>

### Key metrics

| Metric               | Description                        |
| -------------------- | ---------------------------------- |
| **Agent Schedule**   | Scheduled time and next run        |
| **Executions**       | Total number of runs               |
| **Average Duration** | Mean runtime across all executions |
| **Total Tasks**      | Cumulative tasks generated         |

<Frame caption="Dashboard details with run history">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/monitoring-2.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=318b64c79c1f47dcd58f640847f0252b" width="241" height="181" data-path="images/guide/agents/monitoring-2.png" />
</Frame>

Select individual runs to review results, or click **View Results** for a detailed breakdown.

## Report

The Report page shows execution-level data:

<Frame caption="Execution report with timestamps and status">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/monitoring-3.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=e1967b3f3bdee2679cef0c39d8c91ebf" width="803" height="479" data-path="images/guide/agents/monitoring-3.png" />
</Frame>

| Field                     | Description                 |
| ------------------------- | --------------------------- |
| **Run At / Completed At** | Start and finish timestamps |
| **Run By**                | Who triggered the run       |
| **Status**                | Success or failure          |
| **Number of Results**     | Records matching filters    |

## Tasks

<Frame caption="Task list showing individual task statuses">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/monitoring-4.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=2d83ddc1169622774eae9d3c294e1b99" width="1667" height="448" data-path="images/guide/agents/monitoring-4.png" />
</Frame>

Each matched record generates a separate task. Monitor:

* **Status** - Success, Failed, or Pending
* **Error messages** - permission issues, invalid data, field mismatches

<Frame caption="Task detail with error information">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/monitoring-5.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=c39a007567271a8fbca396004eb7a628" width="1737" height="1091" data-path="images/guide/agents/monitoring-5.png" />
</Frame>

<Frame caption="Expanded task output view">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/monitoring-6.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=2395d007908c01181345d806d43460ab" width="2560" height="1392" data-path="images/guide/agents/monitoring-6.png" />
</Frame>

## Data load status

Before an Agent can run, both metadata and data must be loaded for the relevant entities.

<Frame caption="Checking data and metadata load status">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/monitoring-7.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=72dc6177a2df5e8d66344379a8042b37" width="2560" height="1392" data-path="images/guide/agents/monitoring-7.png" />
</Frame>

### Verify load status

1. Go to **Integrations** and find the relevant entity
2. Check that **Data Status** shows **Done**
3. Check that **MetaData Status** shows **Done**

### Trigger a manual reload

If data has changed significantly:

<Frame caption="Manual reload option in the integration menu">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/monitoring-8.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=6a1c263f08b5a139fa36c55620078af0" width="1267" height="418" data-path="images/guide/agents/monitoring-8.png" />
</Frame>

1. Click the **three-dots menu** next to the Test button
2. Select **Load Metadata** - wait for completion
3. Select **Load Data** to fetch recent updates

<Frame caption="Load status after manual reload">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/monitoring-9.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=3020f8dd4219f3175b858bb214f363fc" width="1273" height="421" data-path="images/guide/agents/monitoring-9.png" />
</Frame>

## Troubleshooting

| Problem                        | Solution                                                     |
| ------------------------------ | ------------------------------------------------------------ |
| Too many tasks generated       | Narrow your filter conditions                                |
| Tasks failing with data errors | Check field mapping, data types, and integration permissions |
| Agent not running              | Verify data/metadata load status is "Done"                   |
| Unexpected task volume spike   | Review filter logic for overly broad conditions              |