Telemetry Data and Update Frequency

What is Telemetry?

Telemetry in the Covolt API refers to the real-time operational data collected from your battery and solar assets. This data provides insights into the current state, performance, and energy flows of your assets.

Update Frequency

Covolt strives to provide timely telemetry updates for all connected assets:

• Battery Assets: Telemetry data is typically updated every minute under normal conditions.
• Solar Assets: Telemetry data is typically updated every minute depending on the solar inverter type.
• Power Meters: Telemetry data is typically updated every minute under normal conditions.

info

Update frequency may vary based on network conditions, asset type, and connection quality. The measured_at timestamp in telemetry records indicates when the data was collected from the physical device, which may differ from when it was received by our system (created_at).

Accessing Telemetry Data

Latest Telemetry

To retrieve the most recent telemetry data for your assets, use:

For Battery Assets:

GET /v2/battery-assets/telemetry/

For Solar Assets:

GET /v2/solar-assets/telemetry/

For Power Meter Assets:

GET /v2/power-meters/telemetry/

Battery Telemetry Fields

Battery assets provide the following telemetry information:

Field	Description	Units	Notes
state_of_charge	Current battery charge level	%	Range: 0-100%
active_power	Current power flow to/from battery	kW	Positive: discharging, Negative: charging
charged_energy	Cumulative energy charged	kWh	Lifetime total
discharged_energy	Cumulative energy discharged	kWh	Lifetime total
measured_at	Timestamp of measurement	ISO 8601	When data was collected from device

Solar Telemetry Fields

Solar assets provide the following telemetry information:

Field	Description	Units	Notes
active_power	Current power generation	kW	Instantaneous generation
measured_at	Timestamp of measurement	ISO 8601	When data was collected from device

Power Meter Telemetry Fields

Power meter assets provide the following telemetry information:

Field	Description	Units	Notes
import_power	Power meter import in kW	kW	Power imported from the grid
measured_at	Timestamp of measurement	ISO 8601	When data was collected from device

Handling Telemetry Gaps

Occasional gaps in telemetry data may occur due to:

• Temporary network connectivity issues
• Asset maintenance periods
• Communication timeouts

Best practices for handling telemetry gaps:

1. Use the measured_at field to identify when data was actually collected
2. Implement error handling for missing or delayed telemetry
3. Consider implementing an exponential backoff strategy if telemetry is temporarily unavailable
4. For critical applications, cache the last known good values

Telemetry Retention

Covolt retains telemetry data for a period of 12 months. For applications requiring longer data retention, we recommend regularly retrieving and storing telemetry data in your own systems.