Understanding Metrics

A metric is a measurement collected from an asset and recorded over time. Every few seconds, the gateway reads values from your equipment - how many kilowatts the solar panels are producing, how charged the battery is, how much power is being drawn from the grid - and sends them to the platform.

Because readings are stored continuously, you can view what is happening right now, review what happened yesterday, or compare this week's energy flows with last week's.

What Gets Measured

Each asset type produces measurements relevant to what it does:

Asset	What is measured
Battery	Charge level (%), power flowing in or out (kW), total energy charged/discharged (kWh), temperature, health indicators
Solar	Current power output (kW), cumulative energy generated (kWh), inverter status
Grid	Power imported or exported (kW), energy totals (kWh), voltage and frequency
Inverter	DC and AC power levels, operating status
Building / Load	Current consumption (kW), energy used (kWh)
Charger	Charging state, power delivered (kW), session energy (kWh)

Units at a Glance

What you see	Unit	Means
Power right now	kW	Kilowatts - how fast energy is flowing
Energy over time	kWh	Kilowatt-hours - how much energy has flowed
Battery fill level	%	Percentage of total capacity
Electrical pressure	V	Volts
Grid frequency	Hz	Hertz - how stable the grid frequency is
Temperature	°C	Degrees Celsius

INFO

kW vs kWh: Power (kW) is the rate - like speed. Energy (kWh) is the total amount - like distance travelled. A battery might be charging at 10 kW and have received 5 kWh after 30 minutes.

Viewing Metrics

In the platform, you can:

• See live values for each asset on its detail page
• View a chart of any metric over a chosen time range
• Compare totals across a day, week, or month
• See when a metric went outside a normal range (via alerts, coming soon)

For developers

For the full metric catalog, key naming conventions, and query API, see Metrics in the developer documentation.