Дистрибутиви

Проєкти OpenTelemetry складаються з декількох компонентів, які підтримують декілька сигналів. Референсна реалізація OpenTelemetry доступна як:

• Бібліотеки інструментування для конкретних мов
• Бінарний файл Collector

Будь-яка референсна реалізація може бути налаштована як дистрибутив.

Що таке дистрибутив?

Дистрибутив — це налаштована версія компонента OpenTelemetry. Дистрибутив — це обгортка навколо вихідного репозиторію OpenTelemetry з деякими налаштуваннями. Дистрибутиви не слід плутати з форками.

Налаштування в дистрибутиві можуть включати:

• Скрипти для полегшення використання або налаштування для конкретного бекенду або постачальника
• Зміни до стандартних налаштувань, необхідні для бекенду, постачальника або кінцевого користувача
• Додаткові варіанти пакування, які можуть бути специфічними для постачальника або кінцевого користувача
• Тестування, продуктивність та безпека, що перевищують те, що надає OpenTelemetry
• Додаткові можливості, що перевищують те, що надає OpenTelemetry
• Менше можливостей, ніж надає OpenTelemetry

Дистрибутиви загалом поділяються на наступні категорії:

• “Чистий”: Ці дистрибутиви надають ту ж функціональність, що й вихідний код, і є на 100% сумісними. Налаштування зазвичай покращують зручність використання або пакування. Ці налаштування можуть бути специфічними для бекенду, постачальника або кінцевого користувача.
• “Плюс”: Ці дистрибутиви надають додаткові функціональні можливості поверх вихідного коду через додаткові компоненти. Прикладами є бібліотеки інструментування або експортери постачальників, які не були включені до проєкту OpenTelemetry.
• “Мінус”: Ці дистрибутиви надають підмножину функціональності вихідного коду. Прикладами є видалення бібліотек інструментування або приймачів, процесорів, експортерів або розширень, знайдених у проєкті OpenTelemetry Collector. Ці дистрибутиви можуть бути надані для покращення підтримки та безпеки.

Хто може створити дистрибутив?

Будь-хто може створити дистрибутив. Сьогодні кілька постачальників пропонують дистрибутиви. Крім того, кінцеві користувачі можуть розглянути можливість створення дистрибутиву, якщо вони хочуть використовувати компоненти з Реєстру, які не були включені до проєкту OpenTelemetry.

Внесок чи дистрибутив?

Перш ніж ви прочитаєте далі та дізнаєтеся, як створити свій власний дистрибутив, запитайте себе, чи будуть ваші доповнення до компонента OpenTelemetry корисними для всіх і тому повинні бути включені до референсних реалізацій:

• Чи можуть ваші скрипти для “зручності використання” бути узагальнені?
• Чи можуть ваші зміни до стандартних налаштувань бути кращим варіантом для всіх?
• Чи дійсно ваші додаткові варіанти пакування є специфічними?
• Чи можуть ваші тестування, продуктивність та безпека працювати з референсною реалізацією?
• Чи перевіряли ви зі спільнотою, чи можуть ваші додаткові можливості бути частиною стандарту?

Створення власного дистрибутиву

Collector

Посібник про те, як створити свій власний дистрибутив, доступний у цьому блозі: “Створення власного дистрибутиву OpenTelemetry Collector”

Якщо ви створюєте свій власний дистрибутив, то OpenTelemetry Collector Builder може бути хорошою відправною точкою.

Бібліотеки інструментування для конкретних мов

Існують механізми розширення для конкретних мов для налаштування бібліотек інструментування:

• Java агент

Дотримуйтесь рекомендацій

Використовуючи матеріали проєкту OpenTelemetry, такі як логотип і назва для вашого дистрибутиву, переконайтеся, що ви дотримуєтеся Маркетингових рекомендацій OpenTelemetry для організацій, що роблять внесок в проєкт.

Проєкт OpenTelemetry наразі не сертифікує дистрибутиви. У майбутньому OpenTelemetry може сертифікувати дистрибутиви та партнерів аналогічно до проєкту Kubernetes. При оцінці дистрибутиву переконайтеся, що використання дистрибутиву не призводить до привʼязки до постачальника.

Будь-яка підтримка дистрибутиву надається авторами дистрибутиву, а не авторами OpenTelemetry.