Collector Ключ-АСТРОМ
Collector — это сетевое приложение, которое можно использовать для пакетной обработки и преобразования телеметрических данных. Оно действует как прокси-сервер и может принимать запросы OTLP, а также данные из других источников, преобразовывать эти запросы в соответствии с заданными правилами и пересылать их на сервер.
Преимущества использования Collector
В целом, использование Collector вместе с вашим сервисом может быть преимуществом, поскольку позволяет вашему сервису быстро выгружать данные и берет на себя дополнительную обработку, такую как повторные попытки, пакетирование, шифрование или фильтрация конфиденциальных данных. Он централизует общие задачи обработки, а не дублирует их в каждом приложении.
Вам следует использовать Collector, если:
- Вам необходимо собирать данные из разных источников в разных форматах, и вам нужен простой способ заставить их все передавать свои данные на серверную часть, которая в противном случае была бы несовместимой.
- Вам необходимо иметь общую обработку атрибутов ваших телеметрических данных.
Collector — относительно легкий компонент, поэтому команды могут развертывать его самостоятельно, чтобы избежать использования одной и той же конфигурации.
Конфигурация коллектора (Collector) настраивается в одном YAML-файле. Это устраняет необходимость просмотра множества файлов и упрощает обслуживание. Подробнее о настройке см. в разделе Конфигурация коллектора.
Распределения
Collector поставляется в различных вариантах дистрибуции и с различными вариантами настройки и развертывания.
Collector Ключ-АСТРОМ
Дистрибутив OpenTelemetry Collector от Ключ-АСТРОМ представляет собой специализированную сборку, предоставляемую Ключ-АСТРОМ и адаптированную для типичных случаев использования в контексте Ключ-АСТРОМ. Он поставляется с оптимизированным и проверенным набором компонентов Collector.
Преимущества Ключ-АСТРОМ Collector
Ключ-АСТРОМ Collector предлагает следующие преимущества по сравнению с дистрибутивами OpenTelemetry Collector:
- Охват поддержки Ключ-АСТРОМ (x86-64 и ARM64)
- Компоненты Collector проверены Ключ-АСТРОМ
- Исправления безопасности, независимые от выпусков OpenTelemetry Collector
Вы можете загрузить релиз Ключ-АСТРОМ Collector из нашего репозитория.
Он также доступен в виде образа контейнера на сайте Github Packages и может быть извлечен с помощью следующей команды Docker:
| docker pull ghcr.io/dynatrace/dynatrace-otel-collector/dynatrace-otel-collector:0.37.0 |
Включенные компоненты
По умолчанию Ключ-АСТРОМ Collector поставляется со следующими компонентами Collector.
| Exporters | ||
| debugexporter | otlpexporter | otlphttpexporter |
| Extensions | |
| healthcheckextension | zpagesextension |
| Connectors | |
| forwardconnector | spanmetricsconnector |
Примеры конфигурации
Ознакомьтесь с примерами использования Collector для конкретных вариантов использования и конфигураций отдельных компонентов.
Дистрибутивы OpenTelemetry
Существует два основных дистрибутива OpenTelemetry Collector:
- Collector Core
- Collector Contrib
Кроме того, OpenTelemetry также предоставляет Collector Builder, который позволяет вам создавать свой собственный, настроенный двоичный файл Collector.
| Поддержка Ключ-АСТРОМ
Ключ-АСТРОМ обеспечивает ограниченную поддержку только для установок Core, Contrib и Builder, охватывая только компоненты и их версии, включенные в Ключ-АСТРОМ Collector. Полностью поддерживаемый дистрибутив Collector можно найти в разделе Ключ-АСТРОМ Collector (выше). |
Collector Core
Дистрибутив Core содержит базовую прокси-службу и несколько основных компонентов службы:
- Приемник для OTLP через HTTP и gRPC
- Процессоры для пакетной обработки запросов и обеспечения ограничений использования памяти
- Экспортеры для консольного журналирования и OTLP через HTTP и gRPC
Collector Contrib
Дистрибутив Contrib создан на основе Core и расширяет его функциональность за счет поставки большого количества дополнительных приемников, процессоров и экспортеров, предоставленных третьими сторонами.
Учитывая, что дистрибутив Contrib представляет собой комплексный пакет и поставляется со всеми предварительно скомпилированными компонентами сервиса, он может потреблять больше системных ресурсов (хранилища и памяти), чем оптимизированная сборка Collector. Как правило, мы рекомендуем использовать дистрибутив Contrib для тестирования и пользовательскую сборку Collector (см. Builder (ниже)) в рабочей среде.
Collector Builder (ocb)
В дополнение к двум дистрибутивам OpenTelemetry также предлагает Collector Builder — инструмент командной строки, позволяющий вам создать собственную настроенную версию Collector.
Какой дистрибутив следует использовать?
| Тип | Когда следует его использовать? |
|---|---|
Collector Ключ-АСТРОМ рекомендуется
|
Предпочтительный выбор для большинства случаев использования. Поставляется с набором проверенных и стабильных компонентов Collector, обычно используемых с установками Ключ-АСТРОМ. |
| Custom Builder version | Когда вам необходимо полностью настроить экземпляр Collector и запустить только те компоненты, которые необходимы для вашего варианта использования. |
| Core | Если вы в первую очередь хотите выполнить преобразование между протоколами OTLP (HTTP ↔ gRPC), обеспечьте ограничения по использованию памяти или примените пакетную обработку запросов. |
| Contrib | Идеально подходит для тестовых конфигураций, поскольку содержит все сторонние компоненты и не требует специальной сборки. Как правило, не рекомендуется использовать в производственных системах, поскольку обычно потребляет больше ресурсов и может быть менее стабильным, чем оптимизированный экземпляр Builder. |
Компоненты
Приемник
Приёмник — это компонент, обеспечивающий поступление данных в Сборщик. Он может получать данные из нескольких источников. Многие приёмники поставляются с настройками по умолчанию и не требуют особой настройки.
Список доступных приемников и их базовую конфигурацию см. в официальной документации OpenTelemetry по приемникам.
Процессор (необязательный)
Процессор — это необязательный компонент, который решает, что делать с данными.
Список доступных процессоров и их базовую конфигурацию см. в официальной документации OpenTelemetry по процессорам. В OpenTelemetry есть список рекомендуемых процессоров, но они необязательны.
Экспортер
Экспортёр — это компонент, который отправляет обработанные данные на один или несколько бэкендов. Экспортёры могут поддерживать более одного источника данных.
Поскольку для многих экспортеров требуется дополнительная настройка (например, конечная точка), обязательно ознакомьтесь с официальной документацией OpenTelemetry по экспортерам для получения списка доступных экспортеров и их конфигураций.
Сервисы
Сервисы используются для определения конвейеров, передающих данные через коллектор. Они определяют, какие компоненты совместно обрабатывают данные OpenTelemetry.
