VictoriaLogs is open source user-friendly database for logs from VictoriaMetrics.
This add-on makes it easy to run a VictoriaLogs on Home Assistant OS on ARM64 systems like Raspberry Pi 4 or AMD64.
- VictoriaLogs can accept logs from popular log collectors. See these docs.
- VictoriaLogs is much easier to set up and operate compared to Elasticsearch and Grafana Loki. See these docs.
- VictoriaLogs provides easy yet powerful query language with full-text search capabilities across all the log fields - see LogsQL docs.
- VictoriaLogs can be seamlessly combined with good old Unix tools for log analysis such as
grep
,less
,sort
,jq
, etc. See these docs for details. - VictoriaLogs capacity and performance scales linearly with the available resources (CPU, RAM, disk IO, disk space). It runs smoothly on both Raspberry PI and a server with hundreds of CPU cores and terabytes of RAM.
- VictoriaLogs can handle up to 30x bigger data volumes than Elasticsearch and Grafana Loki when running on the same hardware. See these docs.
- VictoriaLogs supports fast full-text search over high-cardinality log fields such as
trace_id
,user_id
andip
. - VictoriaLogs supports multitenancy - see these docs.
- VictoriaLogs supports out-of-order logs’ ingestion aka backfilling.
- VictoriaLogs provides a simple web UI for querying logs - see these docs.
-
Add the reposity. (Quick link: )
- Add the reposity (click 3 dots on the top right of the screen). Reposity URL: https://github.com/denisgolius/homeassistant-addon-victorialogs
- Refresh/reload your browser tab/window
-
Install the add-on:
- Find, and install the VictoriaLogs add-on
-
Configure VictoriaLogs
Read the addon documentation which can also be found on the Documentation tab of the VictoriaLogs addon in the Home Assistant settings. Check also a list of supported command-line flags with their description.
-
Start the VictoriaLogs add-on
Don't forget to restart Home Assistant!
Well done! You can install and configure Grafana or similar to check data is being logged.