The recorder integration in Home Assistant is responsible for registering and storing everything that happens in your home. It is the backbone of the history and logbook features in Home Assistant but it also keeps information in a long-term format to power things like the energy dashboard and other graphs you see in Home Assistant.
Figure 1:Spook adds a service that allows importing data into the recorder.
Devices & entities¶
Spook does not provide any new devices or entities for this integration.
Services¶
Spook adds the following new service to your Home Assistant instance:
Import statistics¶
Manually import long-term statistics into the recorder database of Home Assistant.
| Service properties | |
|---|---|
| Service | Recorder: Import statistics 👻 |
| Service name | recorder.import_statistics |
| Service targets | No targets |
| Service response | No response |
| Spook's influence | Newly added service |
| Developer tools | Try this service
 |
| Service call data | |||
|---|---|---|---|
| Attribute | Type | Required | Default / Example |
has_mean | boolean | Yes | |
has_sum | boolean | Yes | |
name | string | No | None |
source | string | Yes | |
statistic_id | string | Yes | |
unit_of_measurement | string | No | None |
stats | mapping | Yes |
stats attribute mapping | |||
|---|---|---|---|
| Attribute | Type | Required | Default / Example |
start | datetime string | Yes | |
mean | float | No | |
min | float | No | |
max | float | Yes | |
last_reset | datetime string | No | None |
state | float | No | |
sum | float | No |
More information about the mapping/meaning of fields in long-term statistics can be found on the Home Assistant data portal.
Example service call in YAML
1 2 3 4 5 6 7 8 9 10service: recorder.import_statistics data: has_mean: false has_sum: true statistic_id: sensor.some_energy_sensor source: recorder unit_of_measurement: kWh stats: - start: "2023-07-03 21:00:00+02:00" sum: 123123
Repairs¶
Spook has no repair detections for this integration.
Uses cases¶
Some use cases for the enhancements Spook provides for this integration:
- Manually import data into the recorder, for example, historical data from a previous system or an energy provider that provides a CSV file with your historical energy usage.
Blueprints & tutorials¶
There are currently no known blueprints or tutorials for the enhancements Spook provides for this integration. If you created one or stumbled upon one, please let us know in our discussion forums.
Features requests, ideas, and support¶
If you have an idea on how to further enhance this integration, for example, by adding a new service, entity, or repairs detection; feel free to let us know in our discussion forums.
Are you stuck using these new features? Or maybe you’ve run into a bug? Please check the Support page on where to go for help.