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

# App Health

> Monitor automation performance and system health

App Health provides real-time monitoring and insights into your automation performance and system health. This dashboard helps administrators track system performance, identify issues, and optimize automation efficiency.

<Info>
  Health monitoring is also available on Elements, where it appears as **Element Health** in the left navigation menu.
</Info>

## Overview

The App Health dashboard gives you a quick health overview with real-time error tracking and detailed drill-down insights to help you:

* **Monitor System Performance:** Track overall system health and identify potential issues
* **Automation Health Tracking:** View automation success/failure rates and performance metrics
* **Error Detection:** Get real-time error tracking with detailed diagnostic information
* **Performance Optimization:** Identify bottlenecks and optimize automation efficiency
* **Resource Management:** Monitor system resource usage and capacity

## Getting Started

<Steps>
  <Step title="Open your app or element">
    Navigate to the object you want to monitor.
  </Step>

  <Step title="Open Health">
    Click <Icon icon="briefcase-medical" size={16} /> **Overview** under **App Health** (or **Element Health**) in the left navigation menu.
  </Step>

  <Step title="Review the health calendar">
    Check the calendar view for recent green (success) and red (failure) indicators to get a snapshot of automation performance.
  </Step>

  <Step title="Investigate failures">
    Click on a failed execution to view its timestamp, triggering entity, and error details. Use this information to diagnose and resolve the issue.
  </Step>

  <Step title="Configure alerts">
    Set up alert thresholds and notification routing so your team is notified when failure rates or execution times exceed acceptable levels.
  </Step>

  <Step title="Establish a review cadence">
    Schedule regular reviews — daily health checks and weekly trend analysis — to catch issues early and identify optimization opportunities.
  </Step>
</Steps>

## Automation Health

The Automation Health section provides comprehensive monitoring of all automation activities:

### Health Metrics

The Overview gives you a quick glance at your automation performance with the following metrics:

* **Successful Executions:** Count of automations that completed successfully
* **Failed Executions:** Count of automations that encountered errors
* **Performance Trends:** Visual calendar view showing automation health over time

### Health Calendar

The health calendar provides a visual representation of automation performance over time:

* **Green indicators:** Successful automation runs
* **Red indicators:** Failed automation runs
* **Daily aggregation:** See patterns in automation success/failure
* **Monthly overview:** Track long-term trends and seasonal patterns

### Detailed Automation History

Click on the red squares in the calendar — days with failed automations — to drill into the details for that day. Each entry includes:

* **Execution Timestamps:** When each automation ran
* **Record:** The record that triggered the automation
* **Automation Name:** Which automation was involved
* **Automation Status:** Whether the run succeeded or failed

For deeper insight into failed automations, see [Interventions](#interventions).

## Interventions

The <Icon icon="heart-pulse" size={16} /> **Interventions** page lets you investigate failed automations, assign them for review, and track resolution progress. It surfaces key failure statistics at a glance and provides a structured workflow for triaging errors.

### Summary Cards

At the top of the page, four cards provide a real-time snapshot of automation failures:

* **Needs Review:** Total number of interventions awaiting investigation
* **New in Last 24h:** Recent failures with a comparison to the previous period
* **Error Rate (7d):** Percentage of failed runs over the last seven days, along with total run count
* **Most Errors:** The automation with the highest failure count, helping you prioritize fixes

### Active Interventions

Below the summary cards, the Active Interventions table lists every failed automation run with the following details:

* **Status:** Current triage state (e.g., Needs Review)
* **Assigned To:** Assign a team member to investigate the failure
* **Record:** The record type and source that triggered the automation
* **Automation & Action:** The automation name and the specific action that failed
* **Error:** The error message describing what went wrong, with **Resolve** and **Ignore** actions

Use the search bar and the **All Statuses** and **All Assignees** filters to narrow down the list. For bulk operations, select multiple interventions and use **Mark All As Resolved** or **Ignore All**.

## Best Practices for App Health Monitoring

<Tabs>
  <Tab title="Regular Monitoring">
    * **Daily Health Checks:** Review automation health metrics daily
    * **Weekly Performance Reviews:** Analyze trends and identify optimization opportunities
    * **Monthly Capacity Planning:** Assess system capacity and growth requirements
    * **Quarterly Performance Audits:** Comprehensive review of automation efficiency
  </Tab>

  <Tab title="Proactive Maintenance">
    * **Error Prevention:** Use error patterns to prevent future issues
    * **Performance Tuning:** Optimize slow-running automations
    * **Capacity Management:** Plan for system growth and peak usage
    * **Documentation Updates:** Keep automation documentation current
  </Tab>

  <Tab title="Alert Management">
    * **Threshold Setting:** Configure alerts for critical performance metrics
    * **Escalation Procedures:** Define response procedures for different alert types
    * **Notification Routing:** Ensure alerts reach the appropriate team members
    * **Alert Fatigue Prevention:** Balance alert sensitivity with usefulness
  </Tab>
</Tabs>

## Integration with Automation System

App Health integrates seamlessly with the [Automation System](/workflows/automation-system) to provide:

* **Unified Monitoring:** Combined view of automation design and performance
* **Context-Aware Insights:** Performance data linked to specific automation configurations
* **Optimization Recommendations:** Actionable suggestions based on health data
* **Troubleshooting Support:** Direct links from errors to automation configuration