# 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.


---

# Agent Instructions: 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:

```
GET https://docs.ecosuite.io/user-guide/modules/energy/asset-status-logic-green-orange-red.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.