Предварительные требования
- Кластер Kubernetes (рекомендуется v1.20+) с как минимум 32 GiB оперативной памяти и 100 GB дискового пространства, доступными на одном узле для ClickHouse.
- Helm v3+
kubectl, настроенный для взаимодействия с вашим кластером
Варианты развертывания
-
ClickStack с открытым исходным кодом: разверните ClickStack целиком в своем кластере Kubernetes, включая:
- ClickHouse
- HyperDX
- MongoDB (используется для хранения состояния и конфигурации панели мониторинга)
- Управляемый ClickStack, где ClickHouse и интерфейс ClickStack (HyperDX) управляются в ClickHouse Cloud. Это избавляет от необходимости запускать ClickHouse или HyperDX внутри вашего кластера.
Установите cert-manager (необязательно)
Разверните OpenTelemetry Demo (необязательно)
otel-demo. Каждое развертывание включает:- Автоматическое инструментирование с OTel и ClickStack SDKS для трассировок, метрик и журналов.
- Все сервисы отправляют данные своего инструментирования в коллектор OpenTelemetry
my-hyperdx-hdx-oss-v2-otel-collector(не развернут) - Пересылка тегов ресурсов для корреляции журналов, метрик и трассировок через переменную среды
OTEL_RESOURCE_ATTRIBUTES.
Running:Архитектура демо

Добавьте репозиторий Helm-чарта ClickStack
Развертывание ClickStack
ClickStack с открытым исходным кодом (самоуправляемый)
ClickStack с открытым исходным кодом (самоуправляемый)
otel-demo. Helm-чарт развертывает:- Экземпляр ClickHouse
- HyperDX
- Дистрибутив OTel collector от ClickStack
- MongoDB для хранения состояния приложения HyperDX
storageClassName в соответствии с конфигурацией вашего кластера Kubernetes.Управляемый ClickStack
Управляемый ClickStack
Running. Обратите внимание: если вы используете Управляемый ClickStack, ClickHouse будет отсутствовать:Откройте интерфейс HyperDX
ClusterIP и по умолчанию недоступен извне.Чтобы открыть интерфейс HyperDX, настройте проброс порта с 3000 на локальный порт 8080.Получение ключа API для приёма данных
Team Settings и скопируйте Ingestion API Key из раздела API Keys. Этот ключ API обеспечивает безопасную ингестию данных через OpenTelemetry Collector.Создание секрета Kubernetes с ключом API
Добавьте Helm-репозиторий OpenTelemetry
Развёртывание компонентов коллектора Kubernetes
k8s_deployment.yaml и k8s_daemonset.yaml — работают совместно и обеспечивают полный сбор телеметрических данных из вашего кластера Kubernetes.-
k8s_deployment.yamlразворачивает единственный экземпляр OpenTelemetry Collector, отвечающий за сбор событий и метаданных всего кластера. Он собирает события Kubernetes, метрики кластера и обогащает телеметрические данные метками и аннотациями подов. Этот коллектор работает как автономное Развертывание с одной репликой, чтобы избежать дублирования данных. -
k8s_daemonset.yamlразворачивает коллектор в виде ДемонСет, который запускается на каждом узле кластера. Он собирает метрики на уровне узла и пода, а также журналы контейнеров, используя такие компоненты, какkubeletstats,hostmetricsи процессоры Kubernetes Attribute Processor. Эти коллекторы обогащают журналы метаданными и отправляют их в HyperDX с помощью экспортера OTLP.
k8s_deployment.yaml
k8s_deployment.yaml
k8s_daemonset.yaml
k8s_daemonset.yaml
Просмотр данных Kubernetes в HyperDX
Управляемый ClickStack
Управляемый ClickStack
ClickStack с открытым исходным кодом
ClickStack с открытым исходным кодом
/kubernetes, например: http://localhost:8080/kubernetes.Каждая из вкладок — Pods, Nodes и Namespaces — должна быть заполнена данными.