> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beam.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Monitoring
> Set rules on an agent that tell your team, in Slack, Microsoft Teams, or email, when a task ends in a status you care about, an evaluation score drifts, or failures pile up.
Monitoring rules tell your team, in Slack, Microsoft Teams, or email, when an agent's work needs attention. Each rule pairs a condition to watch with a place to send it, either the moment it happens or as a scheduled report.
Agent \→\ Configuration \→\ Monitoring
> [!NOTE]
>
> Only owners and admins can open the **Monitoring** tab.
## What monitoring rules are
### The three parts of a rule
| Section | What you pick |
| - | - |
| **Channels** | Where the alert goes: **Email**, **Slack**, **Teams** |
| **Conditions** | What to watch: **Status change**, **Evaluation score**, **Failure count** |
| **Notifications** | When to send: **Real-time** or a **Scheduled report** |
A rule needs at least one channel and one condition. With several conditions, it fires only when all of them are met.
### The conditions
| Condition | Fires when |
| - | - |
| **Status change** | A task ends in a status you pick, such as **Failed** or **Input required** |
| **Evaluation score** | A task or step scores outside the range you set, from 0 to 100 |
| **Failure count** | Failures pass your number within a window, such as **Resets daily** |
### Real-time or scheduled
**Real-time** sends each alert as it happens. **Scheduled report** sends one summary daily, weekly, or monthly at 00:00 UTC. The list groups rules under these two headers.
### Agent learning
The **Agent learning** band above the rules turns what monitoring observes into feedback in the agent's **Learning hub**, so the agent improves from the failures it reports. See [Optimize Outputs](https://docs.beam.ai/04-observability-analytics/optimize-outputs/optimize-outputs.md).
> [!NOTE]
>
> Agent learning is a Pro feature, and the band appears only once the agent has a rule.
### Where rules live
Rules belong to one agent, on its **Monitoring** tab under **Configuration**. A critical agent can page a channel in real time while a low-stakes one sends a weekly digest.
## How to use monitoring rules
### Create a rule
**1. Open the Monitoring tab**
Open the agent, go to **Configuration**, select **Monitoring**, then select **New rule**.
**2. Choose the channels**
In **Channels**, turn on each place the alert should go. For **Email**, pick workspace members. For Slack or Teams, select **Connect Slack** or **Connect Teams** and approve Beam; Teams also needs a team and a channel.
Agent \→\ Configuration \→\ Monitoring \→\ New rule \→\ Channels
**3. Choose what to watch**
In **Conditions**, switch on each condition and fill in its settings. For **Status change**, pick the statuses.
Agent \→\ Configuration \→\ Monitoring \→\ New rule \→\ Conditions
For **Evaluation score**, leave **Task level** on and choose **is below**, **is above**, or **is between** with the scores. To watch a single step, select **Add node**.
Agent \→\ Configuration \→\ Monitoring \→\ New rule \→\ Conditions \→\ Evaluation score
For **Failure count**, enter the number and how often the count resets. Only failures inside that window count.
**4. Choose when to send**
In **Notifications**, choose **Real-time**, or **Scheduled report** and a cadence.
Agent \→\ Configuration \→\ Monitoring \→\ New rule \→\ Notifications
**5. Select Create rule**
Turn on **Include test tasks** only if test runs should trigger the rule, then select **Create rule**. The rule starts watching at once.
### Pause, edit, or remove a rule
Turn off the switch on a rule's row to pause it without losing its settings. Select the row to edit the rule, then select **Save rule**. To delete it, choose **Remove** from the row's menu.
> [!WARNING]
>
> Removing a rule is permanent. To quiet it for a while, use its switch instead.
### Disconnect Slack or Teams
Open the rule and, in **Channels**, select **Disconnect** beside Slack or Teams. If it was the only channel, turn on **Email** first.
### Turn on Agent learning
**1. Create at least one rule**
The **Agent learning** band appears once the agent has a rule.
**2. Turn on the switch in the band**
Turn on the switch at the end of the band. On a free workspace it shows a lock instead; select it to upgrade.
**3. Pick the model, if you want a different one**
Select the settings icon beside the switch, choose a model under **Model**, and select **Save**.
Agent \→\ Configuration \→\ Monitoring \→\ Agent learning settings
## Troubleshooting
> **I cannot open the Monitoring tab**
>
> The tab is limited to owners and admins. Ask one to create the rule, or to make you an **Admin**.
> **Create rule does nothing and a message appears**
>
> A section is missing something. Check that **Email** has a recipient, Teams has a channel, and each condition you switched on has a status, a score, or a number.
> **Select node reads No evaluated nodes**
>
> No step in the agent has evaluation on. Turn it on in the Flow, see [Evaluation Framework](https://docs.beam.ai/04-observability-analytics/evaluation-framework/evaluation-framework.md), or watch the task-level score instead.
## Next steps
> **[Task Executions](https://docs.beam.ai/03-running-operations/task-management/task-executions/task-executions.md)**
>
> Read the task view the alerts point you to.
> **[Evaluation Framework](https://docs.beam.ai/04-observability-analytics/evaluation-framework/evaluation-framework.md)**
>
> Set the evaluation scores that an Evaluation score rule watches.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.