Skip to content

home-assistant/analytics.home-assistant.io

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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/