Глосарій

Цей глосарій визначає терміни та [поняття] (/docs/concepts/), які є новими для проєкту OpenTelemetry, а також пояснює специфічне для OpenTelemetry використання термінів, поширених у сфері спостережуваності.

Ми також даємо коментарі щодо правопису та написання великих літер, коли це корисно. Наприклад, див. OpenTelemetry та OTel.

Терміни

Агрегація

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

API

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

Застосунок

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

APM

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

Атрибут

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

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

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

Baggage

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

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

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

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

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

Колектор

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

Правопис: При посиланні на OpenTelemetry Collector, завжди пишіть Collector з великої літери. Використовуйте просто «Колектор», якщо ви використовуєте Колектор як прикметник — наприклад, «конфігурація Колектора».

Contrib

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

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

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

DAG

Спрямований ациклічний граф (Directed Acyclic Graph).

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

Див. Сигнал

Вимір

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

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

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

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

Дистрибутив

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

Подія

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

Експортер

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

Поле

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

gRPC

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

HTTP

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

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

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

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

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

JSON

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

Мітка

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

Мова

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

Бібліотека

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

Журнал

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

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

Запис даних з міткою часу та ступенем важливості. Може також мати Trace ID та Span ID, коли співвідноситься з трасуванням. Див. Записи журналу.

Метадані

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

Метрика

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

OC

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

Observability backend

Компонент платформи спостережуваності, який відповідає за приймання, обробку, зберігання та запит телеметричних даних. Прикладами є інструменти з відкритим кодом, такі як [Jaeger] і [Prometheus], а також комерційні пропозиції. OpenTelemetry не є бекендом спостережності.

Observability frontend

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

OpAMP

Скорочення від Open Agent Management Protocol.

Правопис: Пишіть OpAMP, а не OPAMP чи opamp в описах та інструкціях.

OpenCensus

Попередник OpenTelemetry. Детальніше див. Історія.

OpenTelemetry

Утворена шляхом злиття проєктів OpenTracing та OpenCensus, OpenTelemetry, предмет цього вебсайту — це колекція API, SDK та інструментів, які ви можете використовувати для інструментування, генерації, збору, та експорту телеметричних даних, таких як метрики, журнали та трейси.

Правопис: OpenTelemetry завжди має бути одним словом без дефісів і з великої літери, як показано тут.

OpenTracing

Попередник OpenTelemetry. Детальніше див. Історія.

OT

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

OTel

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

Правопис: Використовуйте OTel, not OTEL.

OTelCol

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

OTEP

Акронім від OpenTelemetry Enhancement Proposal.

Правопис: Пишіть «OTEPs» у формі множини. Не використовуйте OTep або otep в описах.

OTLP

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

Поширювачі

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

Proto

Мовонезалежні типи інтерфейсів. Див. opentelemetry-proto.

Приймач

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

Запит

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

Ресурс

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

REST

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

RPC

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

Вибірка

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

SDK

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

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

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

Сервіс

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

Сигнал

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

Відрізок

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

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

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

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

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

Статус

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

Теґ

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

Трейс

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

Трейсер

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

Транзакція

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

zPages

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