Stats is a high-performance, standalone analytics provider designed for self-hosting, enabling the collection and viewing of event data from websites, apps, and more through a web API. It comes with a real-time dashboard and is ideal as a minimal and privacy-preserving analytics solution for small to medium traffic services.
Current status: it works, but it's not finished.
- Real-time analytics and dashboard
- Lightweight and efficient, with minimal resource usage
- Easy integration with websites, mobile apps, and other platforms
To get started with Stats, you'll need to compile an executable for your server, run it, and host it. While this guide focuses on using Nginx as a reverse proxy, Stats is versatile enough to be deployed in various environments, including Docker containers, for enhanced portability and scalability.
Run in development-mode
RUST_LOG=debug cargo run
Build production release
cargo build --release
This will create the executable file you need in the /target/release/ folder
Embed events collector
You use this to automatically collect pageviews or other events triggered by calling stats_collect('event_name', 'optinal_url_override')
from javascript once the script below is initialized.
When you add this script to a new domain, you must add them to the CORS_DOMAINS
list on the backend so the server can receive data from them.
<script>
// Stats analytics
var head = document.head || document.getElementsByTagName("head")[0];
var script = document.createElement("script");
script.setAttribute("src", "http://localhost:5775/stats.js"); // REPLACE WITH ACTUAL URL
script.setAttribute("onload", () => window.collectStats());
script.setAttribute("type", "text/javascript");
script.setAttribute("charset", "utf8");
script.setAttribute("async", "");
head.appendChild(script);
</script>
Minimum set of folders & files required to run this application.
stats/
├── data/
│ ├── GeoLite2-City.mmdb
│ ├── cities5000.txt
│ └── stats.sqlite
├── ui/
├── stats // copy executable from target/release/stats
└── .env
These options must be defined in a .env
file before starting the server.
Variable | Default | Summary |
---|---|---|
APP_URL | http://localhost:5775 | Full domain you are hosting this service on |
SERVICE_PORT | 5775 | Port you want the service to be hosted from |
DATABASE_URL | /data/stats.sqlite | Path to .sqlite file to use as database. |
CORS_DOMAINS | http://localhost:5775,https://udara.io | Comma-separated list of allowed domains. The service will only accept analytics events from these domains. |
PROCESSING_BATCH_SIZE | 500 | Max limit for events buffer used to queue and batch analytics events for processing. When the limit is hit, new events are dropped until items are processed from the queue. |