RepoRadar ClickStack: платформа для наблюдения и анализа проблем в приложениях
ClickStack — это открытая платформа для наблю observability, которая помогает выявлять проблемы в продакшене, объединяя сессии воспроизведения, логи, метрики, трассировки и ошибки с помощью ClickHouse и OpenTelemetry.
Основная задача ClickStack — облегчить инженерам исследование и анализ проблем, возникающих в работе приложений. Она позволяет быстро искать и визуализировать данные о производительности и состоянии системы, что делает её полезной для разработчиков и команд, отвечающих за стабильность приложений. В отличие от полных решений как Kibana, ClickStack ориентирован на работу с ClickHouse, что может оказаться удобнее для пользователей, уже использующих эту базу данных.
Проект написан на JavaScript и развертывается с помощью Docker. Убедись, что у тебя уже есть рабочий экземпляр ClickHouse, так как ClickStack работает поверх него. Обрати внимание, что это всё ещё ранняя версия, так что могут быть баги. Если ты ищешь инструмент для улучшения наблюдаемости своих приложений с возможностями быстрого поиска и визуализации, ClickStack может оказаться хорошим вариантом.
ClickStack — это инструмент, который помогает инженерам быстро выявлять причины сбоев в продакшене, позволяя легко искать и визуализировать логи и трассировки на базе любого кластера ClickHouse. Его можно сравнить с Kibana, но для ClickHouse.
Особенности
- Поиск и корреляция логов, метрик и трассировок в одном месте.
- Не зависит от схемы: работает с существующей схемой ClickHouse.
- Оптимизированные для ClickHouse быстрые поиски и визуализации.
- Интуитивно понятный полнотекстовый поиск с опциональным SQL.
- Анализ трендов аномалий с помощью дельт событий.
- Настройка алертов в несколько кликов.
- Создание дашбордов без сложного языка запросов.
- Поддержка OpenTelemetry из коробки.
Установка и запуск
ClickStack предоставляет упаковку, которая включает ClickHouse, пользовательский интерфейс ClickStack, OpenTelemetry Collector и MongoDB. Чтобы запустить ClickStack, используй следующую команду:
docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.clickhouse.com/clickhouse/clickstack-all-in-oneПосле этого ты можешь получить доступ к интерфейсу ClickStack по адресу http://localhost:8080. Если у тебя есть существующий экземпляр ClickHouse, ты можешь выбрать другие варианты развертывания, описанные в документации.
Инструментирование приложения
Чтобы передавать логи, метрики и трассировки в ClickStack, нужно инструментировать приложение. Есть набор SDK и опций интеграции, включая:
ClickStack также совместим с OpenTelemetry, что позволяет легко интегрировать различные языки и платформы.
Использование CLI
Если ты предпочитаешь работать в терминале, ClickStack предоставляет командный интерфейс ({`@hyperdx/cli`}), который позволяет обращаться к данным ClickStack:
npm install -g @hyperdx/cli
hdx auth login
hdx tuiCLI поддерживает интерактивный интерфейс, аналитику и простые SQL-запросы.
Ограничения и сбор данных
ClickStack собирает анонимизированные данные об использовании для поддержки своей миссии по обеспечению наблюдаемости для всех команд. Если ты хочешь отключить сбор данных, установи переменную окружения USAGE_STATS_ENABLED в false.
Рекомендуется выделить серверу минимум 4 ГБ ОЗУ и 2 процессора для тестирования.
Радар проекта: 85 из 100 — зрелый и живой проект
- Импульс 43 ≈ 9 звёзд в день
- Темп разработки 100 400 коммитов за 12 недель
- Зрелость 100 проекту 3 года, больше 100 релизов
- Сообщество 81 111 участников, 520 форков
- Свежесть 99 последний коммит — 1 день назад
- Быстрый старт 70 есть: команда установки, Docker, сайт/демо
- Готовность к продакшену 80 релиз @hyperdx/otel-collector@2.43.1, автосборка
- Безопасность и доверие 100 лицензия MIT, SECURITY.md, организация
- Документация 94 README 8 тыс. знаков, 9 разделов, папка docs
- Экосистема 78 30 подписчиков на обновления, 19 тем
Как считаем
Только открытые данные GitHub на 11.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: ClickHouse/ClickStack →
