Ship Home Assistant OS logs to Grafana Loki using Grafana Alloy — the modern replacement for the deprecated Promtail add-on.
The official Promtail add-on (v2.2.0) bundles Promtail 2.6.1, which cannot read the compact journal format introduced in systemd 252+ (HAOS 11+). This means Promtail silently fails to ship logs on modern HAOS installations.
Grafana Alloy is the official successor to Promtail, Grafana Agent, and Grafana Agent Flow. It uses a component-based pipeline architecture and has native systemd journal support that works with all journal formats.
- Open Settings > Add-ons > Add-on Store
- Click the overflow menu (three dots, top-right) > Repositories
- Paste:
https://github.com/ecohash-co/ha-addon-alloy - Click Add > Close
- Find Grafana Alloy in the store and click Install
Set loki_url to your Loki push endpoint:
loki_url: "http://192.168.1.45:3100/loki/api/v1/push"
log_level: infoAll systemd journal entries from HAOS, including:
- Home Assistant Core logs
- Add-on/app container logs
- Supervisor logs
- Host system logs (kernel, networkd, etc.)
Labels applied: unit, hostname, syslog_identifier, transport, container_name, level.
Access the Alloy pipeline inspector at http://<haos-ip>:12345.
MIT