Об этом проекте

Helm Analytics — это open-source решение для веб-аналитики, ориентированное на приватность и созданное для разработчиков, маркетологов и компаний, которые хотят полностью контролировать свои данные. В отличие от традиционных сервисов аналитики, которые внедряют тяжелые скрипты отслеживания и монетизируют информацию о посетителях, Helm предоставляет легковесный (<2 КБ) JavaScript-трекер и хранит каждое событие на собственных серверах пользователя. **Ключевые возможности** - **Мониторинг трафика в реальном времени** — просмотр одновременных посетителей, просмотров страниц и потоков событий с задержкой менее секунды. - **Отслеживание с упором на приватность** — атрибуция уникальных посетителей без постоянных cookies или логирования IP; опциональное маскирование конфиденциальных данных в записях сессий. - **Геопространственная и аппаратная детализация** — подробные отчеты по странам, городам, браузерам, ОС и типам устройств. - **UTM и атрибуция кампаний** — автоматическая группировка маркетинговых кампаний для легкого анализа ROI. - **Интеллект сессий** — высокоточное воспроизведение сессий, тепловые карты и оверлеи кликов/скроллов для выявления проблем с UX. - **Воронки конверсии** — построение многоэтапных путей пользователя и определение точек оттока. - **Высокопроизводительный прием данных** — API на базе Go обрабатывает тысячи событий в секунду с ограничением частоты запросов по IP для защиты от злоупотреблений. **Архитектура** - **Ingestion API (Go)** — легковесный, высококонкурентный сервис, который объединяет записи для ClickHouse в пакеты. - **ClickHouse** — колоночная аналитическая база данных, оптимизированная для быстрых OLAP-запросов по массивным логам событий. - **PostgreSQL** — хранит метаданные, такие как учетные записи пользователей, конфигурации сайтов и настройки. - **Frontend (React/Vite)** — адаптивный одностраничный дашборд с графиками и визуализациями в реальном времени. - **Docker и Caddy** — контейнеры обеспечивают изоляцию; Caddy может автоматически выпускать сертификаты Let’s Encrypt. **Варианты развертывания** 1. **Скрипт в один клик** — запустите `curl -sSL https://helm-analytics.com/install.sh | bash` на чистом сервере Ubuntu/Debian. Скрипт установит Docker, загрузит образы, настроит Caddy (если выбран SSL) и запустит стек. 2. **Ручной Docker-Compose** — скачайте предоставленный `docker-compose.yml` и запустите с помощью `docker compose up -d`. 3. **Собственный reverse-proxy** — интеграция с существующими настройками Nginx/Traefik путем открытия портов API и дашборда. **SDK** Helm предлагает серверные SDK для Go, Python и Node.js, настраиваемые через переменные окружения (`HELM_SITE_ID`, `HELM_API_URL`). Примеры кода показывают, как отслеживать просмотры страниц или пользовательские события напрямую из бэкенд-кода. **Сообщество и поддержка** Проект активен в X (Twitter) и предоставляет поддержку по электронной почте. Вклады в развитие приветствуются через pull-запросы на GitHub; код распространяется под лицензией AGPL-3.0, что гарантирует открытость любых модификаций. **Почему стоит выбрать Helm Analytics?** - Полное владение данными — никакой сбора данных третьими сторонами. - Высокая производительность — ClickHouse обеспечивает время выполнения запросов менее секунды даже на высоконагруженных сайтах. - Расширяемость — SDK и API позволяют интегрировать платформу с любым стеком. - Self-hosted — вы контролируете среду, безопасность и масштабирование. Helm Analytics идеально подходит для всех, кому нужна детальная аналитика веб-трафика без ущерба для приватности пользователей или производительности.