Skip to content

scriptengine/homeassistant-addon-victoriametrics

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Home Assistant Add-on VictoriaMetrics Time Series Database

If you are looking for an efficient and easy to use way for long term storage of your Home Assistant data - just use VictoriaMetrics.

This Add-on makes it easy to run a Victoria Metrics Time Series Database on Home Assistant OS on ARM64 systems like Raspberry Pi 4.

Replacement for InfluxDB and Prometheus

VictoriaMetrics Time Series Database is 100% compatible with the Prometheus and InfluxDB line protocol. So Homeassistant is able to connect to VictoriaMetrics with the InfluxDB integration. In Grafana you can use the Prometheus or InfluxDB data source to use your data in your Victoria Metrics database.

Much better long term storage

VictoriaMetrics offers an ultra efficient sompression for data storage, is highly optimized for time series data and has low RAM usage. So this is the perfect solution for long term storage of high amounts of data like all sensor values of your smart home.

There are many reasons to switch to Victoria Metrics. Compared to other products Victoria Metrics offers:

  • better compression
  • better performance
  • lower RAM usage
  • fully open source
  • outperfomes other time series databases
  • ease of use

Victoria Metrics on GitHub

VictoriaMetrics wins InfluxDB and Timescale in all the queries by a margin of up to 20x. It especially excels at heavy queries, which scan many millions of datapoints across thousands of distinct timeseries. More info here VictoriaMetrics vs. InfluxDB vs. Timescale

This Add-On continues the work of Andreas Habel whose hassio-victoriametrics Add-On was not updated since 2021. I developed this mainly for my purpose running VictoriaMetrics on my Raspberry Pi 4 running Home Assistant Operating System. The direction of InfluxDB 2.0 was not what I wanted in combination with Grafana so VictoriaMetrics Time Series Database was the best choice.

Installation and configuration

(These instructions are intended for experienced Home Assistant users.)

  1. Add the reposity. (Quick link: Open your Home Assistant instance and show the Supervisor add-on store. )
    1. Add the reposity (click 3 dots on the top right of the screen). Reposity URL: https://github.com/fuslwusl/homeassistant-addon-victoriametrics
    2. Refresh/ reload your browser tab/window
  2. Install the add-on:
    • Find, and install the Victoria Metrics add-on
  3. Read the add-on documentation in the Victoria Metrics documentation tab
  4. Start the Victoria Metrics add-on
  5. Add the influxdb integration to your Home Assistant configuration (The instructions for adding and configuring the influxdb integration are in the add-ons documentation tab. Don't forget to restart Home Assistant.)
  6. (Optional) Install and configure Grafna, or similar to check data is being logged

About

@fuslwusl VictoriaMetrics Add-on for Home Assistant Documentation updates

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Dockerfile 95.3%
  • Shell 4.7%