> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/workflows-and-automation/workflow-health-status-and-alerts.md).

# Workflow Health Status and Alerts

Harmony automatically monitors the resources that each agent depends on and alerts you when something breaks. If a dataset, desk, catalog item, approver employee, or any other linked resource is deleted or an approver is terminated, the affected agent is immediately flagged as unhealthy - so you can find and fix problems before they prevent an agent from running correctly.

This article explains how health statuses work, what triggers an unhealthy state, and where to find health information in the UI and activity log.

***

### How Agent Health Monitoring Works

Every agent in Harmony can depend on one or more external resources, such as:

* **Datasets** - used to source or route work
* **Desks** - used to assign tasks to a team or queue
* **Catalog items** - referenced as part of an agent step
* **Approver employees** - designated to review or approve work items

Harmony continuously checks whether these resources are still available and valid. When all dependencies are intact, the agent has a **Healthy** status. When one or more dependencies are broken, the agent is marked as **Unhealthy**.

This monitoring runs automatically - you do not need to configure it or turn it on.

***

### What Triggers an Unhealthy Status

An agent is marked unhealthy when any of the following occurs:

| Cause                              | Example                                                |
| ---------------------------------- | ------------------------------------------------------ |
| A linked dataset is deleted        | The dataset feeding an agent step no longer exists     |
| A linked desk is deleted           | The desk assigned to receive tasks has been removed    |
| A catalog item is deleted          | A step references a catalog item that no longer exists |
| An approver employee is terminated | A designated approver is no longer an active employee  |

Any one of these conditions is enough to flag the agent as unhealthy, even if all other dependencies are intact.

***

### Viewing Health Status in the UI

Agents with broken dependencies are clearly marked in the agent list and agent detail views with a health indicator. The indicator shows:

* **What is wrong** - the type of dependency that is broken
* **Which resource is affected** - the specific dataset, desk, catalog item, or employee that caused the issue

This lets you immediately understand the problem without having to investigate each step manually.

#### Finding Unhealthy Agents

1. Navigate to **Agents** in the main menu.
2. Look for agents marked with the unhealthy indicator in the list.
3. Select an agent to open its detail view and see the full breakdown of which dependency is broken.

***

### Agent Activity Log and Audit Trail

Every health status change is recorded in the agent's activity log. This gives you a full audit trail that includes:

* When the agent became unhealthy
* Which resource change triggered the status update
* When the agent was restored to a healthy state (after the issue is resolved)

To view the activity log, open the agent detail view and go to the **Activity** tab. You can use this log to understand the history of any health changes and demonstrate compliance or investigate disruptions.

***

### Resolving an Unhealthy Agent

To restore an agent to a healthy state, you need to address the broken dependency. Depending on the cause, this may involve:

* **Replacing a deleted resource** - assign a new dataset, desk, or catalog item to the affected agent step
* **Updating an approver** - replace a terminated employee with an active approver in the agent configuration

Once the broken dependency is resolved and all required resources are valid again, the agent health status returns to **Healthy** and the change is recorded in the activity log.

***

### Summary

| Status        | Meaning                                                                 |
| ------------- | ----------------------------------------------------------------------- |
| **Healthy**   | All dependencies are intact and the agent can run correctly             |
| **Unhealthy** | One or more dependencies are broken and the agent may not run correctly |

Agent health monitoring is always on, requires no setup, and ensures that broken dependencies are surfaced immediately - so your team can act quickly and keep agents running without interruption.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.harmony.io/workflows-and-automation/workflow-health-status-and-alerts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.