Короткий опис стану специфікації

OpenTelemetry розробляється на основі сигналів. Трасування, метрики, baggage та логування є прикладами сигналів. Сигнали будуються на основі поширення контексту, спільного механізму для кореляції даних у розподілених системах.

Кожен сигнал складається з чотирьох основних компонентів:

• API
• SDK
• Протокол OpenTelemetry (OTLP)
• Колектор

Сигнали також мають додаткові компоненти, екосистему втулків та інструментів. Всі інструменти використовують однакові семантичні конвенції, щоб забезпечити однакові дані при спостереженні за загальними операціями, такими як HTTP-запити.

Щоб дізнатися більше про сигнали та компоненти, дивіться Огляд специфікації OTel.

Життєвий цикл компонентів

Компоненти проходять через життєвий цикл розробки: Чернетка, Експериментальний, Стабільний, Застарілий, Видалений.

• Чернетка компоненти знаходяться на стадії розробки та ще не додані до специфікації.
• Експериментальні компоненти випущені та доступні для бета-тестування.
• Стабільні компоненти є зворотно сумісними та підтримуються довгостроково.
• Застарілі компоненти стабільні, але можуть бути видалені в майбутньому.

Для повних визначень життєвих циклів та довгострокової підтримки дивіться Версії та стабільність.

Поточний статус

Нижче наведено високорівневий звіт про поточний статус доступних сигналів. Зверніть увагу, що клієнти OpenTelemetry відповідають спільній специфікації, але розробляються незалежно.

Рекомендується перевіряти поточний статус кожного клієнта в README його репозиторію GitHub. Підтримка клієнтів для конкретних функцій може бути знайдена в таблицях відповідності специфікації.

Зверніть увагу, що для кожного з наступних розділів статус Колектора такий самий, як і статус Протоколу.

Трасування

• Специфікація
• API: stable
• SDK: stable
• Protocol: stable
• Примітки:
  • Специфікація трасування тепер повністю стабільна та підтримується довгостроково.
  • Специфікація трасування все ще розширюється, але тільки у зворотно сумісний спосіб.
  • Клієнти OpenTelemetry отримують версію v1.0 після завершення впровадження трасування.

Метрики

• Специфікація
• API: stable
• SDK: mixed
• Protocol: stable
• Примітки:
  • OpenTelemetry Metrics наразі активно розробляється.
  • Модель даних стабільна та випущена як частина протоколу OTLP.
  • Експериментальна підтримка метрик доступна в Колекторі.
  • Підтримка Колектора для Prometheus розробляється у співпраці зі спільнотою Prometheus.

Baggage

• Специфікація
• API: stable
• SDK: стабільний
• Протокол: Н/Д
• Примітки:
  • OpenTelemetry Baggage тепер повністю стабільний.
  • Baggage не є інструментом спостереження, це система для прикріплення довільних ключів та значень до транзакції, щоб їх могли отримати підлеглі служби. Таким чином, немає компонентів OTLP або Колектора для Baggage.

Логування

• Специфікація
• Bridge API: stable
• SDK: stable
• Protocol: stable
• Примітки:
  • Модель даних логів випущена як частина протоколу OpenTelemetry.
  • Обробка логів для багатьох форматів даних була додана до Колектора, завдяки внеску Stanza проєкту OpenTelemetry.
  • Міст API OpenTelemetry дозволяє писати у доповнювачі, які переносять логи з наявних фреймворків логування в OpenTelemetry. Міст API логів не призначений для прямого виклику кінцевими користувачами. Доповнювачі логів розробляються багатьма мовами.
  • SDK логів OpenTelemetry є стандартною реалізацією Мосту API логів. Застосунки налаштовують SDK для вказівки, як обробляти та експортувати логи (наприклад, використовуючи OTLP).
  • The OpenTelemetry Log Bridge API має експериментальну підтримку для публікації записів логів, які відповідають семантичним домовленостям подій.

Профілі

• Специфікація
• Protocol: development