analytics.home-assistant.io
This repository contains the source of the https://analytics.home-assistant.io website and the CloudFlare worker that recieves the payload from the analytics integration
Worker
This recieves the payload from the analytics integration and stores that data in a KV store.
- Entries are kept for a maximum of 60 days since last update.
The worker source are located in the worker directory.
Schedule
There are several scheduled tasks that iterate over the stored data and generate the data that the site uses. These tasks run at different times.
| task | runs | description |
|---|---|---|
PROCESS_QUEUE |
Every 2 min | Processes the current queue untill everything is done, when it's done the site will regenerate with the new data, then it waits untill the next RESET_QUEUE task has run. |
UPDATE_HISTORY |
Every hour | Update history, this will update the installation types, versions, and totals, when it's done the site will regenerate with the new data. |
RESET_QUEUE |
5min past midnight | This will reset the queue if it's empty, so the next PROCESS_QUEUE can start |
Site
The source of the https://analytics.home-assistant.io website.
The website is bundled with Vite and served with Netlify.
The website source are located in the site directory.
Development
To do local development of the website first clone the repository and open the devcontainer.
Once the devcontainer has started run script/develop in the terminal, a preview of the site will open in your default browser.
PR's should target the dev (default) branch.
Sites
| Environment | URL |
|---|---|
| Production | https://analytics.home-assistant.io/ |
| Dev | https://dev--home-assistant-analytics.netlify.app/ |