> For the complete documentation index, see [llms.txt](https://docs.ecosuite.io/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ecosuite.io/user-guide/modules/energy/asset-status-logic-green-orange-red.md).

# Asset status logic (Green, Orange, Red)

Ecosuite monitors the status of each device looking at metrics such as Generation performance and data connectivity. The result of these checks are summarized into one of the following three statuses: 

* <mark style="color:green;">Green</mark>: no issues
* <mark style="color:$warning;">Orange</mark>: connectivity issues (i.e. no communications, but other issues may also be present)
* <mark style="color:red;">Red</mark>: issues exist and need to be resolved

This device level information is propagated upwards from Device -> System -> Site -> Project, with the least healthy state taking precedence (Red is the worst, followed by Orange).

***

The logic for the derivation of these status is currently implemented as follows:

1. **Connectivity (Data Age)**

* <mark style="color:$warning;">Orange</mark>: No data communications in last 24 hours

2. **Reading Validity**

* <mark style="color:red;">Red</mark>: Data received but readings ≤ 0 or undefined for devices that need readings&#x20;
* <mark style="color:green;">Green</mark>: Positive readings for devices that need them&#x20;

3. **Generation Performance**

* <mark style="color:red;">Red</mark>: Generation < 60% of expected  \
  Applies to both 24-hour and 1-hour windows,  Expected generation calculated using irradiance data.

4. **Consumption Performance**

* <mark style="color:$warning;">Orange</mark>: Consumption > 105% of predicted&#x20;

5. **Storage Health (Battery devices)**

* <mark style="color:red;">Red</mark>: State of Health (SOH) < 75%&#x20;

6. **System-Level Checks**

* <mark style="color:red;">Red</mark>: Voltage readings below configured boundary&#x20;
* <mark style="color:red;">Red</mark> Power factor below configured boundary&#x20;

7. **Device Lifecycle**

* <mark style="color:green;">Green</mark>: Decommissioned devices (past end date) are marked as ok regardless of other factors&#x20;

### Devices that have been removed

If a device is physically removed from a system, initially Ecosuite will show this as a comms error since it is no longer possible to communicate with the device (i.e. it will appear <mark style="color:$warning;">Orange</mark> in the UX).  After an extended period of time though, Ecosuite will stop showing these removed devices to avoid confusion with future asset management teams that do not necessariy know the history of the purposefully removed device(s). This period is configured as 120 days, after which the device will no longer appear in data.