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

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

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

Простая архитектура с потоком

Этот сборщик предоставляет два 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 и агентов.