Перейти к основному содержимому
Перейти к основному содержимому

Приём данных в ClickStack

Все данные поступают в ClickStack Open Source или управляемый Managed ClickStack через сборщик OpenTelemetry (OTel). Он выступает основной точкой входа для логов, метрик, трейсов и данных сессий.

Ключевое отличие между архитектурами заключается в том, где размещаются компоненты. В обоих случаях вы запускаете OpenTelemetry collector для приёма телеметрии от ваших приложений. В случае ClickStack Open Source вы также самостоятельно управляете и размещаете как ClickHouse, так и UI ClickStack (HyperDX). В случае Managed ClickStack, ClickHouse и UI HyperDX размещаются и управляются в ClickHouse Cloud, с интегрированной аутентификацией и операционным управлением, выполняемым за вас.

Управляемая архитектура с потоком

В обеих моделях развертывания сборщик предоставляет два OTLP-эндпоинта:

  • HTTP — порт 4318
  • gRPC — порт 4317

Пользователи могут отправлять данные на эти эндпоинты либо напрямую из языковых SDKs, либо из совместимых с OTel агентов сбора данных, например других OTel collectors, которые собирают метрики и логи инфраструктуры.

Подробнее:

  • Языковые SDKs отвечают за сбор телеметрии изнутри вашего приложения — в первую очередь трейсов и логов — и экспорт этих данных в OpenTelemetry collector через OTLP-эндпоинт, который выполняет приём в ClickHouse. Дополнительную информацию о языковых SDKs, доступных в ClickStack, см. в разделе SDKs.

  • Агенты сбора данных — это агенты, развёрнутые на периферии — на серверах, узлах Kubernetes или рядом с приложениями. Они собирают телеметрию инфраструктуры (например, логи, метрики) или получают события напрямую от приложений, инструментированных с помощью SDKs. В этом случае агент работает на том же хосте, что и приложение, часто как сайдкар или ДемонСет. Эти агенты пересылают данные в центральный OTel collector ClickStack, который выступает в роли шлюза, обычно развёртываемого один раз на кластер, дата-центр или регион. Шлюз получает OTLP-события от агентов или приложений и выполняет ингестию в ClickHouse. Подробности см. в разделе OTel collector. Эти агенты могут быть другими экземплярами OTel collector или альтернативными технологиями, такими как Fluentd или Vector.

Совместимость с OpenTelemetry

Хотя ClickStack предоставляет собственные языковые SDKs и модифицированный OpenTelemetry с расширенной телеметрией и дополнительными возможностями, пользователи также могут бесшовно использовать свои существующие OpenTelemetry SDKs и агентов.