# Events

The **Events** tab lets you visualise and explore the raw event data received from the household's connected devices. It combines an interactive time-series graph with a configurable event selector, making it useful for debugging data ingestion issues, verifying sensor readings, and understanding a household's energy profile at a glance.

<figure><img src="/files/KSO6risFFkFawjH5dqIk" alt=""><figcaption></figcaption></figure>

### Event Graph

The main area of the tab displays a **time-series line chart** that plots the selected event types over the date range configured in the page header.

* **Y-axis** — Values in Watts (W). The scale adjusts automatically to fit the data and can include negative values (e.g., when power is fed back into the grid).
* **X-axis** — Timestamps covering the selected date range.
* **Series** — Each selected event type is rendered as a separate coloured line. The legend above the chart shows the event name, source type (e.g., `GATEWAY`), and the device identifier for each series.
* **Pagination** — When more series are selected than can be displayed in the legend at once, use the arrow controls (e.g., `1/2`) in the top-right corner to page through the legend entries.

Common event types plotted on the graph include:

| Event Type               | Description                                                                      |
| ------------------------ | -------------------------------------------------------------------------------- |
| **PowerConsumption**     | Total power consumed by the household at each measurement interval.              |
| **PowerGeneration**      | Power produced by the household's energy generation system (e.g., solar panels). |
| **PowerExcess**          | Surplus power available after self-consumption — typically fed into the grid.    |
| **GridPowerConsumption** | Power drawn from the grid (i.e., consumption minus self-consumed generation).    |

### Event Selection

Below the graph, the **Event Selection** panel lets you choose which data points are displayed on the chart. The panel heading reads *"Select the data points to be displayed"*.

#### Active Event Types

A table lists the event types currently plotted on the graph:

| Column     | Description                                                                                                          |
| ---------- | -------------------------------------------------------------------------------------------------------------------- |
| **Type**   | The event type identifier (e.g., `GRID_POWER_CONSUMPTION`, `POWER_CONSUMPTION`, `POWER_EXCESS`, `POWER_GENERATION`). |
| **Source** | The source system that produced the events (e.g., `GATEWAY`).                                                        |
| **Action** | A remove button (✕) to remove the event type from the graph.                                                         |

#### Adding Event Types

At the bottom of the panel, two dropdown menus allow you to add additional event types to the graph:

* **Event Type** — Select from the available event types for this household.
* **Source Type** — Select the source system (e.g., `GATEWAY`).

Click the **+** button to add the selected combination to the graph. The chart updates immediately to include the new data series.


---

# 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://doc.moost.io/platform-manual/buildings/events.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.