Перейти к основному содержанию
Разверните Управляемый ClickStack в ClickHouse Cloud, отправьте тестовое событие через конвейер ингестии и убедитесь, что оно доступно в интерфейсе ClickStack. ClickHouse Cloud управляет backend ClickHouse, а вы сохраняете контроль над конвейером ингестии и схемой. Управляемый ClickStack предоставляет:
  • Автоматическое масштабирование вычислительных ресурсов независимо от хранилища
  • Недорогое и практически неограниченное хранение на базе объектного хранилища
  • Независимую изоляцию рабочих нагрузок чтения и записи с помощью хранилищ
  • Встроенную аутентификацию
  • Автоматические резервные копии
  • Средства безопасности и соответствия требованиям
  • Бесшовные обновления

Перед началом работы

Вы также можете отправлять данные напрямую в ClickHouse, используя поддерживаемую интеграцию и собственную схему.

Создайте сервис ClickHouse Cloud

Выполните шаг «Создание сервиса ClickHouse» в руководстве по быстрому началу работы с ClickHouse Cloud. Прежде чем продолжить, убедитесь, что сервис запущен.
На этой странице показан вариант с OpenTelemetry. Используйте переключатель в верхней части руководства, чтобы выбрать OpenTelemetry (рекомендуется) или Vector.

Подготовьте среду для ингестии

  • Чтобы запустить новый OpenTelemetry Collector, установите Docker. В Kubernetes разверните коллектор с помощью Helm.
  • Чтобы использовать существующий коллектор, запустите его в режиме шлюза и убедитесь, что его дистрибутив включает ClickHouse exporter. В этом руководстве вы добавите необходимую конфигурацию.

Настройка управляемого ClickStack

1

Выберите источник для ингестии и настройте коллектор

В сервисе ClickHouse Cloud запустите ClickStack. На странице ClickStack Начало работы выберите Начать ингестию.
Начать ингестию
На странице Выберите источник ингестии выберите OpenTelemetry.
Рекомендуется OpenTelemetryOpenTelemetry предоставляет преднастроенные схемы для журналов, трассировок, метрик и сеансов.
Выберите OpenTelemetry в качестве источника ингестии
ClickStack генерирует команду запуска коллектора с учетными данными администратора default. Рекомендуется использовать отдельные учетные данные для ингестии, чтобы отделить доступ для ингестии от административного доступа и не зависеть от пароля администратора.
В ClickHouse Cloud откройте SQL-консоль сервиса и выполните:
В сгенерированной команде замените CLICKHOUSE_USER="default" на CLICKHOUSE_USER="clickstack-ingest" и укажите в CLICKHOUSE_PASSWORD пароль этого пользователя.
Чтобы продолжить с учетными данными администратора default, скопируйте команду на вкладке Запустить коллектор. ClickStack автоматически подставляет конечную точку сервиса. Замените заполнитель пароля паролем сервиса. Если он у вас больше не сохранился, получите или сбросьте сведения о подключении.Команда имеет следующий вид:
Замените <host> и <your_password_here> значениями для своего сервиса ClickHouse Cloud, затем выполните команду.Коллектор запускается в интерактивном режиме. Оставьте этот терминал открытым, а для остальных команд из этого руководства используйте второй терминал.
Эта команда открывает порты OTLP без аутентификации и предназначена для локальной оценки. Перед отправкой производственного трафика защитите коллектор.
2

Отправьте тестовые данные

Отправьте тестовую запись журнала с текущей временной меткой:
Если вы используете существующий коллектор, замените http://localhost:4318 на его конечную точку OTLP HTTP. Если приёмник требует аутентификации, добавьте необходимый заголовок в команду curl.При успешном запросе возвращается HTTP/1.1 200 OK.
3

Начните работу и подтвердите приём данных

После того как ClickStack обнаружит источники данных OpenTelemetry, выберите Начать изучение, чтобы открыть представление Search. Найдите ClickStack ingestion test.В результатах должно отображаться тестовое событие с именем сервиса clickstack-docs-test.
Представление журналов ClickStack с тестовым событием ингестии ClickStack
Теперь у вас есть сервис Управляемый ClickStack, настроенный путь ингестии и тестовое событие, которое можно просмотреть в ClickStack.

Следующие шаги

Если для выполнения другого руководства требуются конечная точка ClickHouse Cloud или пароль, получите или сбросьте сведения о подключении, прежде чем продолжить.

Отправка данных приложений и инфраструктуры

Выберите руководство в зависимости от данных, которые хотите отправлять в ClickStack:

Инструментирование приложения

Отправляйте трассировки и журналы приложения с помощью поддерживаемого SDK OpenTelemetry.

Сбор журналов хоста

Пересылайте журналы хоста из OpenTelemetry Collector, работающего в роли агента.

Мониторинг Kubernetes

Собирайте журналы, метрики и трассировки из кластера Kubernetes.

Другие интеграции

Найдите руководства по дополнительным приложениям и источникам телеметрии.

Изучение демонстрационных данных

Используйте демонстрационный датасет, чтобы изучить возможности ClickStack на более насыщенных телеметрических данных:

Демонстрационные журналы, трассировки и метрики

Загрузите данные из публичной демонстрационной среды и диагностируйте проблему. В этом руководстве предполагается, что вы запустили новый локальный OpenTelemetry Collector. Если вы настроили существующий коллектор, адаптируйте параметры конечной точки и аутентификации к вашему развертыванию.

Локальные журналы и метрики

Собирайте локальные файлы и системные метрики в macOS или Linux.

Генерация синтетических данных

Используйте генератор, чтобы протестировать ингестию без готового приложения или датасета:

Генерация данных с помощью otelgen

Отправьте небольшой пакет синтетических журналов, трассировок и метрик OTLP.

Генерация данных с помощью telemetrygen

Генерируйте настраиваемые сигналы OpenTelemetry для нескольких сервисов.
См. все демонстрационные данные и демонстрации ClickStack.

Подготовка к продакшну

Перед использованием ClickStack для постоянных рабочих нагрузок ознакомьтесь с рекомендациями по продакшну и сайзингу:

Переход в продакшн

Ознакомьтесь с рекомендациями по учётным данным для ингестии, безопасности, хранению данных и эксплуатации.

Оценка ресурсов

Определите необходимые вычислительные ресурсы исходя из ожидаемого объёма приёма данных.
Сведения о задачах развертывания см. в руководстве по развертыванию Управляемого ClickStack.