Skip to content

piitaya/analytics.home-assistant.io

 
 

Repository files navigation

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/

About

Home of the Home Assistant usage stats.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 93.8%
  • Shell 3.1%
  • HTML 2.8%
  • JavaScript 0.3%