Skip to main content
КраткоВ этом руководстве показано, как отправлять телеметрию в ClickStack из коллекторов OpenTelemetry, управляемых Telflo. Вы узнаете, как:
  • Создать конфигурацию коллектора в визуальном редакторе Telflo или через CLI
  • Отправлять телеметрию в ClickStack с открытым исходным кодом или в Управляемый ClickStack, либо записывать её напрямую в ClickHouse
  • Удалённо развёртывать конфигурации на парк коллекторов
  • Убедиться, что телеметрия попадает в ClickStack или в ваши таблицы ClickHouse
Требуемое время: 15–20 минут

​
Что такое Telflo?

Telflo — это независимый от поставщика control plane для OpenTelemetry Collector, обеспечивающий централизованное управление конфигурацией коллекторов в масштабах всего парка. Визуальный редактор, тесты конвейеров и удалённое развёртывание конфигураций делают крупные парки управляемыми. Telflo работает со стандартными upstream-сборками OpenTelemetry Collector: нет ни отдельной сборки Telflo, ни проприетарного агента, поэтому коллекторы, которые уже запущены у ваших команд, остаются на той же сборке. Telflo доступен не только в браузере, но и через интерфейс командной строки. Объедините его с MCP-сервером ClickStack — и тот же агент, который выполняет запросы к вашей телеметрии, сможет исправить конвейер, который её сформировал.

​
Почему Telflo + ClickStack?

ClickStack обеспечивает ингестию, хранение и аналитические запросы на больших объёмах данных. Telflo централизованно управляет парком OpenTelemetry Collector, которые его наполняют, — на хостах, в кластерах и регионах. Telflo предоставляет:
  • Централизованное управление OpenTelemetry Collector на хостах, в контейнерах и в Kubernetes
  • Визуальное редактирование конвейеров с контролируемым развёртыванием на весь парк или на отдельную группу
  • Проверку изменений на образцах телеметрии до того, как они попадут на продакшн-коллекторы
  • Маршрутизацию одной и той же телеметрии одновременно в ClickStack и другие пункты назначения
  • Обзор парка: какие коллекторы онлайн, что запущено на каждом из них и где конфигурация разошлась с эталонной
Ключевые выводы
  • ClickStack принимает, хранит и обрабатывает запросы в большом масштабе
  • Telflo управляет парком коллекторов, которые его наполняют

​
Предварительные требования

​
Интеграция ClickStack с Telflo

1

Создайте конфигурацию коллектора

  1. Войдите в Telflo. В списке Configurations нажмите New Configuration, затем Blank configuration.
  2. В поле Name Your Configuration введите имя и нажмите Create.
  3. Добавьте приёмники: для каждого типа собираемой телеметрии перетащите на холст соответствующий элемент из палитры.
  4. Добавьте процессоры: Memory Limiter и Batch, а также любые другие, необходимые для приведения данных к нужному виду перед отправкой из коллектора. См. полный список процессоров, поддерживаемых Telflo.
2

Добавьте экспортёр

Все три варианта используют один и тот же редактор, один и тот же шаг публикации и один и тот же парк агентов; различается только exporter. Выберите вкладку, соответствующую вашему развертыванию: ClickStack с открытым исходным кодом принимает OTLP с ключом ингестии; Управляемый ClickStack и самоуправляемый ClickHouse принимают прямую запись в таблицы ClickStack.
  1. Перетащите экспортёр OTLP/HTTP на холст.
  2. Укажите в поле Endpoint конечную точку OTLP HTTP вашего ClickStack, например http://clickstack.example.com:4318.
  3. В разделе HTTP Headers нажмите Add header, затем введите authorization в поле Header name и ${env:CLICKSTACK_INGESTION_KEY} в поле Header value. Telflo запрашивает это значение при установке коллекторов, поэтому ключ никогда не сохраняется в конфигурации.
Для gRPC используйте экспортёр OTLP на порту 4317 с тем же заголовком в разделе gRPC Metadata Headers.
Проведите связи от приёмников через процессоры к экспортёру — по одному конвейеру на каждый тип сигнала. В строке состояния отображается config valid либо количество ошибок, которые нужно исправить, а на вкладке YAML — сгенерированная конфигурация.Перед развёртыванием вы можете пропустить через конфигурацию тестовую телеметрию и посмотреть, что получится на выходе. См. тестирование в Telflo. Кроме того, вы можете описать, чего хотите добиться, и ИИ-ассистент Telflo, который открывается кнопкой AI на панели инструментов, сам построит, проверит и протестирует конфигурацию. Ваш собственный агент может сделать то же самое через Telflo CLI.
3

Опубликовать версию

Нажмите Publish на панели инструментов. Опубликованные версии доступны только для чтения; чтобы продолжить доработку, нажмите Create New Version.
4

Создайте группу агентов и разверните её

  1. Перейдите в раздел Fleet, нажмите New Fleet и выберите, где будут работать ваши collectors — на ВМ или в Kubernetes. Укажите Name и нажмите Create fleet.
  2. На вкладке Deploy Groups этого парка нажмите Assign для группы Default и выберите опубликованную configuration и её version.
  3. Нажмите Install для группы и укажите значение для каждой переменной окружения, на которую ссылается ваша configuration; Telflo добавит их в команду установки. Выполните эту команду там, где должны работать collectors, следуя инструкциям по установке Telflo. Команда содержит install token парка вместе с вашим значением, поэтому обращайтесь с ней как с конфиденциальными данными.
  4. На вкладке Collectors collectors сообщают о состоянии Pending pickup, затем Applying и, наконец, In sync.
Чтобы выполнить rollout изменения, опубликуйте новую version и назначьте её группе; чтобы откатиться, назначьте ранее развёрнутую version.
5

Проверьте телеметрию

Откройте HyperDX и найдите один из своих сервисов в представлении Search; для метрик используйте Chart Explorer. В случае Managed ClickStack откройте свой сервис в консоли ClickHouse Cloud и нажмите Launch ClickStack. В случае самоуправляемого ClickHouse обращайтесь к таблицам ClickStack напрямую, например: SELECT ServiceName, count() FROM otel_logs GROUP BY ServiceName.

​
Расширенная конфигурация

​
Fan-out маршрутизация

Одни и те же данные телеметрии могут одновременно отправляться в ClickStack для долговременного хранения, на другую платформу во время миграции и в SIEM для анализа безопасности. Добавьте экспортёры на холст и подключите их к конвейерам, которые должны передавать в них данные, либо начните с готового конвейера из библиотеки потоков Telflo.

​
Сжатие и производительность

  • Экспортеры OTLP/HTTP и OTLP: оставьте для Compression значение gzip.
  • ClickHouse exporter: оставьте Async Insert включённым, для Compression — значение lz4, и добавьте перед ним в конвейере процессор Batch. См. Оптимизация вставок.

​
Дальнейшие шаги

  • Создайте панели мониторинга: создавайте визуализации в HyperDX для журналов, метрик и трейсов
  • Настройте алерты: настройте в ClickStack алерты для критических условий
  • Доработайте с помощью AI assistant: попросите его скорректировать конвейер или предложить тесты
  • Переходите от другого поставщика: flows берут на себя cutover — заменяют агентов, уже развёрнутых на вашем парке машин, и параллельно отправляют данные в оба backend-соединения, пока вы их сравниваете

​
Дополнительные материалы

Последнее изменение 26 сентября 2026 г.