Глосарій

Проєкт OpenTelemetry використовує термінологію, з якою ви можете бути не знайомі. Крім того, проєкт визначає термінологію по-іншому, ніж інші. Ця сторінка містить термінологію, що використовується в проєкті, та її значення.

Загальна термінологія

Агрегація

Процес обʼєднання кількох вимірювань у точну або оцінену статистику про вимірювання, що відбулися протягом інтервалу часу під час виконання програми. Використовується Метрикою, Джерелом даних.

API

Інтерфейс прикладного програмування. У проєкті OpenTelemetry використовується для визначення того, як генеруються дані телеметрії для кожного Джерела даних.

Застосунок

Один або кілька Сервісів, призначених для кінцевих користувачів або інших застосунків.

APM

Моніторинг продуктивності застосунків (Aplication Performance Monitoring) — це моніторинг програмного забезпечення, його продуктивності (швидкість, надійність, доступність тощо) для виявлення проблем, сповіщення та інструменти для пошуку першопричини.

Атрибут

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

Автоматична інструменталізація

Належить до методів збору телеметрії, які не вимагають від кінцевого користувача змінювати вихідний код застосунку. Методи варіюються залежно від мови програмування, прикладами є інʼєкція байт-коду або monkey-патчинг.

Baggage

Механізм для поширення Метаданих, щоб допомогти встановити причинно-наслідковий звʼязок між подіями та сервісами. Див. специфікацію baggage.

Клієнтська бібліотека

Див. Інструментована бібліотека.

Клієнтський застосунок

Компонент Застосунку, який не працює всередині приватної інфраструктури та зазвичай використовується безпосередньо кінцевими користувачами. Прикладами клієнтських застосунків є браузерні застосунки, мобільні застосунки та застосунки, що працюють на IoT-пристроях.

Колектор

Незалежна від постачальника реалізація того, як отримувати, обробляти та експортувати телеметричні дані. Один бінарний файл, який може бути розгорнутий як агент або шлюз.

Також відомий як OpenTelemetry Collector. Більше про Колектор тут.

Contrib

Кілька Бібліотек інструменталізації та Колектор пропонують набір основних можливостей, а також спеціальний репозиторій contrib для неосновних можливостей, включаючи Експортери постачальників.

Поширення контексту

Дозволяє всім Джерелам даних використовувати спільний механізм контексту для зберігання стану та доступу до даних протягом усього життєвого циклу Транзакції. Див. специфікацію поширення контексту.

DAG

Орієнтований ациклічний граф (Directed Acyclic Graph).

Джерело даних

Див. Сигнал

Вимір

Термін, що використовується спеціально для Метрик. Див. Атрибут.

Розподілене трасування

Відстежує прогрес одного Запиту, що називажться Трейсом, коли він обробляється Сервісами, що складають Застосунок. Розподілений трейс перетинає процеси, мережеві та безпекові межі.

Див. Розподілене трасування.

Дистрибутив

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

Подія

Щось, що сталося, де представлення залежить від Джерела даних. Наприклад, Відрізки.

Експортер

Забезпечує функціональність для передачі телеметрії споживачам. Експортери можуть бути на основі дій push або pull.

Поле

Термін, що використовується спеціально для Записів журналу. Метадані можуть бути додані через визначені поля, включаючи Атрибути та Ресурси. Інші поля також можуть вважатися Метаданими, включаючи інформацію про важливість та трасування. Див. специфікацію полів.

gRPC

Високопродуктивний, відкритий універсальний RPC фреймворк. Більше про gRPC тут.

HTTP

Протокол передачі гіпертексту. Скорочення від Hypertext Transfer Protocol.

Інструментована бібліотека

Визначає Бібліотеку, для якої збираються телеметричні сигнали (Трейси, Метрики, Журнали). Див. більше.

Бібліотека інструменталізації

Позначає Бібліотеку, яка забезпечує інструменталізацію для даної Інструментованої бібліотеки. Інструментована бібліотека та Бібліотека інструменталізації можуть бути однією і тією ж Бібліотекою, якщо вона має вбудовану інструменталізацію OpenTelemetry. Див. специфікацію бібліотеки.

JSON

Скорочення від JavaScript Object Notation.

Мітка

Термін, що використовується спеціально для Метрик. Див. Метадані.

Мова

Мова програмування.

Бібліотека

Колекція поведінки, специфічна для мови, викликана інтерфейсом.

Журнал

Іноді використовується для позначення колекції Записів журналу. Може бути неоднозначним, оскільки люди іноді також використовують Журнал для позначення одного Запису журналу. Де можлива неоднозначність, використовуйте додаткові кваліфікатори, наприклад, Запис журналу. Див. більше

Запис журналу

Запис Події. Зазвичай запис включає часову мітку, що вказує, коли сталася Подія, а також інші дані, що описують, що сталося, де це сталося тощо. Див. більше.

Метадані

Пара ключ-значення, наприклад foo="bar", додана до сутності, що генерує телеметрію. OpenTelemetry називає ці пари Атрибутами. Крім того, Метрики мають Виміри та Мітки, а Журнали мають Поля.

Метрика

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

OC

Скорочення від OpenCensus.

OpenCensus

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

OpenTracing

Незалежні від постачальника API та інструменталізація для розподіленого трасування. Попередник OpenTelemetry. Див. більше.

OT

Скорочення від OpenTracing.

OTel

Скорочення від OpenTelemetry.

OTelCol

Скорочення від OpenTelemetry Collector.

OTLP

Скорочення від OpenTelemetry Protocol.

Поширювачі

Використовуються для серіалізації та десеріалізації конкретних частин телеметричних даних, таких як контекст відрізка та Baggage у Відрізках. Див. більше.

Proto

Мовонезалежні типи інтерфейсів. Див. більше.

Приймач

Термін, що використовується Колектором для визначення того, як отримуються телеметричні дані. Приймачі можуть бути на основі дій push або pull. Див. більше.

Запит

Див. Розподілене трасування.

Ресурс

Захоплює інформацію про сутність, що генерує телеметрію, як Атрибути. Наприклад, процес, що генерує телеметрію, який працює в контейнері на Kubernetes, має імʼя процесу, імʼя Podʼа, простір імен і, можливо, імʼя розгортання. Всі ці атрибути можуть бути включені в Ресурс.

REST

Скорочення від Representational State Transfer.

RPC

Скорочення від Remote Procedure Call (Віддалений виклик процедур).

Вибірка

Механізм для контролю кількості даних, що експортуються. Найчастіше використовується з Трасуванням Джерелом даних. Див. більше.

SDK

Скорочення від Software Development Kit. Відноситься до телеметричного SDK, що позначає Бібліотеку, яка реалізує OpenTelemetry API.

Семантичні домовленості

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

Сервіс

Компонент Застосунку. Зазвичай для високої доступності та масштабованості розгортається кілька екземплярів Сервісу. Сервіс може бути розгорнутий у кількох місцях.

Сигнал

Один з Трейсів, Метрик або Журналів. Більше про Сигнали тут.

Відрізок

Представляє одну операцію в межах Трейсів. Див. більше.

Посилання на відрізок

Посилання на відрізок — це посилання між причинно повʼязаними відрізками. Для деталей див. Посилання між відрізками та Визначення посилань.

Специфікація

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

Статус

Результат операції. Зазвичай використовується для вказівки, чи сталася помилка. Див. більше.

Теґ

Див. Метадані.

Трейс

Орієнтований ациклічний граф Відрізків, де ребра між Відрізками визначаються як відношення батько-дитина. Див. більше.

Трасер

Відповідальний за створення Відрізків. Див. більше.

Транзакція

Див. Розподілене трасування.

zPages

Альтернатива зовнішнім експортерам в процесі. Коли вони включені, вони збирають та агрегують інформацію про трасування та метрики у фоновому режимі; ці дані відображаються на вебсторінках за запитом. Див. більше.