Understanding Health Priority
This page explains how EnergyTrak determines a Site's overall health. Two different models are used depending on the type of equipment at the site:
- Generator Systems — a multi-component priority cascade evaluating Network, Generator, and Grid.
- Battery Systems — a simpler Network + Battery model with no operational-mode logic.
Generator Systems
For generator sites, the Site Status is a combination of three component statuses evaluated in priority order:
┌─────────────────────────────────────────────────────────┐
│ │
│ 🥇 Network ──► 🥈 Generator ──► 🥉 Grid │
│ │ │ │ │
│ └───────────────┴────────────────┘ │
│ │ │
│ ▼ │
│ 📊 Site Status │
│ │
└─────────────────────────────────────────────────────────┘
Network is always evaluated first. If your device can't communicate, nothing else matters—the site will show as Disconnected. Once network connectivity is confirmed, Generator status is evaluated, followed by Grid status.
Health Color Priority
EnergyTrak uses a color-coded health system with a strict priority order. When multiple conditions exist, the highest priority (most severe) color wins.
| Priority | Health | What It Means |
|---|---|---|
| 1st | Ready For Setup | Site has been created but setup has not been completed |
| 2nd | Deactivated | Site has been manually turned off by the user |
| 3rd | Disconnected | No communication with the EnergyTrak device |
| 4th | Pending | Waiting for data or setup to complete |
| 5th | Critical | Immediate attention required (fault detected) |
| 6th | Warning | Something needs attention soon |
| 7th | Notice | Informational alert (e.g., manual mode) |
| 8th | Init | System is initializing |
| 9th | Healthy | Everything is working normally |
| 10th | Unknown | Component status cannot be determined |
If your Generator shows Warning but your Network shows Disconnected, your Site will display as Disconnected—because Disconnected has higher priority than Warning.
Component States at a Glance
Network States
| State | Health |
|---|---|
| Connected | 🟢 Healthy |
| Warning | 🟠 Warning |
| Disconnected | ⚫ Disconnected |
Generator States
| State | Health |
|---|---|
| Running / Standby (Auto) | 🟢 Healthy |
| Running / Standby (Manual) | 🟡 Notice |
| Running / Standby (Init) | 🟣 Init |
| Running / Standby (Warning) | 🟠 Warning |
| Fault | 🔴 Critical |
| Unknown | ⚪ Unknown |
Grid States
| State | Health |
|---|---|
| Online | 🟢 Healthy |
| Offline | 🟠 Warning |
| Unknown | ⚪ Unknown |
Site States Explained
The Site State reflects the combined status of all components. Here's where it gets interesting—the same state can have different health colors depending on conditions.
Example: "Running" Can Be Multiple Colors
The Site state Running can appear in four different health colors:
| Site State | Health | When This Happens |
|---|---|---|
| Running | Healthy | Generator running in Auto mode during a grid outage—exactly as expected |
| Running | Init | Mode detection still initializing—operating mode not yet determined |
| Running | Notice | Generator running in Manual mode—works, but won't auto-start |
| Running | Warning | Generator running but there's a warning condition (e.g., low battery) |
Always look at both the State AND the Health color. The state tells you what is happening; the color tells you how well it's happening.
Complete Site State List
| Site State | Possible Health Colors | Description |
|---|---|---|
| Ready | 🟢🟣 | All systems normal—grid online, generator in standby |
| Running | 🟢🟣🟡🟠 | Generator is producing power |
| Exercising | 🟢🟣🟡🟠 | Generator is running a scheduled exercise |
| Stopped | 🟢🟣🟡🟠 | Generator in standby with grid offline |
| Warning | 🟠 Warning | A warning condition exists |
| Manual | 🟡 Notice | Generator is in manual mode (standby) |
| Fault | 🔴 Critical | An active fault has been detected |
| Pending | 🔵 Pending | Waiting for initial data from device, or a site malfunction has been detected |
| Ready For Setup | 🔵 Ready For Setup | Site created but setup incomplete |
| Disconnected | ⚫ Disconnected | Network connection lost |
| Deactivated | ⚪ Deactivated | Site manually deactivated by user |
If a site that has already been set up shows as Pending, it may indicate a site malfunction — such as a mismatch between the Smart Mode setting configured during commissioning and the status reported by the device. Contact support to investigate.
Battery Systems
Battery sites use a simpler model than generator sites — there is no Grid component, no operational-mode detection, and no Init state. The cascade is:
┌─────────────────────────────────────────────────────────┐
│ │
│ 🥇 Network ──► 🥈 Battery │
│ │ │ │
│ └───────────────┘ │
│ │ │
│ ▼ │
│ 📊 Site Status │
│ │
└─────────────────────────────────────────────────────────┘
How Battery Health Is Determined
The battery's health is computed from device error events using a highest-severity-wins model. Each battery error is assigned a severity based on its notification configuration; the worst severity across all current errors becomes the battery's health.
| If any battery error is... | Battery Health is |
|---|---|
| 🔴 Critical | 🔴 Critical |
| 🟠 Warning (no Criticals present) | 🟠 Warning |
| (no Warnings or Criticals) | 🟢 Healthy |
The battery's health then maps directly to Site health.
Network Override
If the EnergyTrak gateway has not reported for more than 120 minutes, the Site is forced to Disconnected, regardless of the battery's last-known health.
Site States for Battery Sites
| Site State | Health Color | When |
|---|---|---|
| Healthy | 🟢 Healthy | All batteries reporting healthy |
| Warning | 🟠 Warning | At least one battery has a warning-level error, no criticals |
| Critical | 🔴 Critical | At least one battery has a critical fault |
| Pending | 🔵 Pending | Site commissioned but awaiting first telemetry |
| Disconnected | ⚫ Disconnected | Gateway has not reported for more than 120 minutes |
| Ready For Setup | 🔵 Ready For Setup | Site created but no products have been set up |
| Deactivated | ⚪ Deactivated | Site manually deactivated by user |
For the full battery component mapping, see the dedicated Battery Systems page.