{"canonical_url":"https://engineer.company/uk/glossary/opentelemetry/","content_markdown":"# OpenTelemetry\n\n## Що це таке\n\nOpenTelemetry — це відкритий стандарт разом із бібліотеками та інструментами,\nякий дає змогу програмам під час роботи видавати трейси, метрики й логи та\nпередавати їх системі, що їх зберігає і показує. Інженери часто скорочують\nназву до OTel. Проєкт належить до Cloud Native Computing Foundation і виник зі\nзлиття двох давніших ініціатив, OpenTracing та OpenCensus.\n\nНайважливіше — розуміти межі цього стандарту. OpenTelemetry не є бекендом\nспостережуваності: він не зберігає даних, не малює дашбордів і не надсилає\nсповіщень. Цим займаються Jaeger, Prometheus і комерційні платформи. Тож\nпитання «OpenTelemetry чи Prometheus?» порівнює трубу з пунктом призначення, і\nвідповідь зазвичай — обидва: OpenTelemetry там, де дані виникають, і бекенд на\nвибір команди там, де вони зберігаються.\n\nПроєкт складається з кількох частин, які доповнюють одна одну:\n\n- **специфікація**, що визначає API, SDK і формат даних для всіх мов;\n- **OTLP**, протокол, який передає телеметрію через gRPC або HTTP у кодуванні\n  Protocol Buffers;\n- **семантичні конвенції**, тобто спільні назви для спільних речей, щоб маршрут\n  HTTP чи запит до бази даних мали однакові позначення в Go, Java і Python;\n- **API та SDK для кожної мови**, а з ними бібліотеки інструментування й\n  автоматичне інструментування для поширених фреймворків;\n- **Collector**, окремий процес, який приймає телеметрію, обробляє її та\n  пересилає далі.\n\nЗ усіх сигналів найбільше пояснень потребують трейси. Трейс — це шлях одного\nзапиту крізь усі сервіси, яких він торкається. Кожен крок на цьому шляху є\nспаном: назва, час початку, тривалість, набір атрибутів та ідентифікатор спану,\nщо спричинив цей крок. Коли запит переходить від одного сервісу до наступного,\nідентифікатор мандрує разом із ним у заголовку, типово в тому, який визначає\nW3C Trace Context:\n\n```text\ntraceparent: 00-a0892f3577b34da6a3ce929d0e0e4736-f03067aa0ba902b7-01\n```\n\nЧотири поля — це версія формату, ідентифікатор трейсу, спільний для всіх спанів\nзапиту, ідентифікатор спану, який зробив виклик, і прапорці; кінцеве `01`\nозначає, що трейс відібрано для збереження. Метрики й логи доповнюють картину,\nа четвертий сигнал, baggage, несе разом із запитом невеликі пари «ключ —\nзначення», щоб сервіс за три переходи далі теж міг їх побачити.\n\n## Чому це важливо\n\nЗберігання — найпомітніша стаття витрат на спостережуваність. Значно важче\nпозбутися іншої: інструментування. Хтось має додати виклики в кожен сервіс,\nкожною мовою, і підтримувати їх у міру того, як змінюється код. Коли кожен\nпостачальник мав власного агента й власний API, зміна постачальника означала\nзробити всю цю роботу заново. З OpenTelemetry код звертається до одного API, а\nвибір бекенду переходить у конфігурацію: експортер у SDK або маршрут у\nCollector. Проєкт формулює принцип прямо: дані, які створює система, належать\nтому, хто її експлуатує.\n\nЦя власність практична, а не лише договірна. Collector стоїть між застосунками\nта бекендом, тож саме тут зручно фільтрувати, семплювати, перейменовувати чи\nвилучати атрибути, перш ніж щось вийде назовні. Тут же той самий потік можна\nнадсилати у два бекенди, поки триває переїзд. Перехід від одного постачальника\nдо іншого стає зміною однієї конфігурації Collector, а не сотні сервісів.\n\nОбсяг — ось витрата, яку варто планувати. Кожен запит може породити десятки\nспанів, і на справжньому трафіку рахунок за зберігання їх усіх здатен перерости\nвартість самого сервісу, за яким стежать. Типовий семплер SDK,\n`ParentBased(root=AlwaysOn)`, відбирає кожен новий трейс і повторює рішення\nвикликача для решти, тож у стандартному налаштуванні зберігається все. Скільки\nзалишати, команда має вирішити свідомо.\n\nЗрілість залежить від сигналу та мови. OTLP стабільний для трейсів, метрик і\nлогів, але SDK кожної мови рухається у своєму темпі, а сторінка статусу проєкту\nпоказує, на якому етапі кожен із них. Перегляньте її, перш ніж прив'язувати до\nOTel сервіс, написаний менш поширеною мовою.\n\nІ потрібен він далеко не завжди. Окремий застосунок зі структурованими логами та\nкількома метриками мало що виграє від розподіленого трасування. OpenTelemetry\nокуповується тоді, коли запит перетинає межі процесів, проходячи крізь\nфронтенд, API, чергу й базу даних, а щоб відповісти на питання «куди подівся\nчас?», доводиться збирати нараду.\n\n## Як це виглядає на практиці\n\nНа одній платформі моніторинг збудували самі замість купити, і OpenTelemetry\nвідповідає в ньому за трасування.\n[Трасування працює через OTLP, тож повільний запит можна простежити крізь фронтенд, API і базу даних](/uk/portfolio/built-first-party-error-monitoring-and-tracing/),\nа не вгадувати, де він застряг. Поруч працює власний конвеєр помилок із двох\nсервісів, errmon та ingest. Він очищує дані перед збереженням, групує помилки в\nповторювані проблеми й виявляє сплески та регресії з періодом охолодження, щоб\nодин невдалий деплой не піднімав нікого сорок разів. Ще він відновлює символічні імена в\nмініфікованих стеках викликів із фронтенду й запускає синтетичний heartbeat, який\nдоводить, що сам конвеєр живий.\n\nРезультати потрапляють у власну базу даних платформи як події помилок, групи\nпомилок, вхідна черга, затримка API та зразки стеків. Оператори працюють з 11\nпредставленнями над цими даними, і одне з них присвячене цілям рівня\nобслуговування. Сторінка чесно називає ціну: побудова забрала реальний час і\nдодала ще одну систему, яку треба підтримувати, а куплений трекер запрацював би\nтого ж дня. Натомість чутливі дані залишаються на платформі. А правила\nсповіщень написано саме під цю платформу, а не під якусь типову.\n\n## Де виникають проблеми\n\n**Трейс обривається на межі.** Контекст легко проходить HTTP-виклики, бо\nбібліотеки інструментування записують і читають заголовок з обох боків. Черга\nповідомлень, заплановане завдання чи проксі, що відкидає невідомі заголовки,\nрозривають ланцюжок, якщо контекст ніхто не перенесе вручну. Трейс розпадається\nнадвоє, і повільна половина виглядає не пов'язаною із запитом, який її\nспричинив. Кладіть контекст у метадані повідомлення й перевіряйте, що всі\nсервіси використовують той самий пропагатор.\n\n**Атрибути витікають або розростаються.** Атрибут спану додати легко, і\nнайлегше додати якраз не ті значення: адреси електронної пошти, повні URL із\nтокенами в рядку запиту, SQL з підставленими значеннями. Для метрик небезпека\nінша — кардинальність. Атрибут із мільйонами різних значень, як-от ідентифікатор\nкористувача, множить кількість часових рядів, а з ними й рахунок. Дотримуйтеся\nсемантичних конвенцій, не додавайте ідентифікатори до метрик і чистьте дані в\nCollector як другу лінію захисту.\n\n**Семплювання стається випадково.** Head sampling ухвалює рішення на початку\nзапиту, ще до того, як відомо, чи буде він повільним або завершиться помилкою.\nТож хто зберігає 1% трейсів, той зберігає й лише близько 1% рідкісних повільних.\nTail sampling вирішує, коли бачить спани трейсу разом, і може залишити кожну\nпомилку й кожен повільний запит, але компонент, який це робить, мусить тримати\nвсі ці дані, поки чекає. Це сервіс зі станом, і його потужність теж треба\nпланувати та моніторити.\n\n**Конвеєру довіряють наосліп.** OTLP підтверджує доставку по одному переходу за\nраз; наскрізна доставка лежить поза межами протоколу. Collector, якому\nзабракло пам'яті або який не встигає за власною чергою експорту, губить\nтелеметрію, а застосунки, що надсилають у нього дані, працюють далі так, наче\nвсе гаразд. Стежте за власними метриками Collector, запускайте більше одного\nекземпляра й сприймайте прогалину в трейсах як збій, який треба пояснити, а не\nяк тиху годину.\n\n## Що почитати далі\n\n- [What is OpenTelemetry?](https://opentelemetry.io/docs/what-is-opentelemetry/)\n  — власне визначення проєкту, його складники і те, чим він свідомо не є.\n- [OTLP Specification](https://opentelemetry.io/docs/specs/otlp/) — сам\n  протокол: транспорти, кодування, стиснення й підтвердження.\n- [Trace Context](https://www.w3.org/TR/trace-context/) — рекомендація W3C, на\n  якій стоїть заголовок `traceparent`.\n- [Context propagation](https://opentelemetry.io/docs/concepts/context-propagation/)\n  — як трейс іде за запитом крізь межі процесів.\n- [Semantic conventions](https://opentelemetry.io/docs/concepts/semantic-conventions/)\n  — спільні назви для атрибутів, метрик і ресурсів.\n- [Sampling](https://opentelemetry.io/docs/concepts/sampling/) — head і tail\n  sampling і скільки коштує кожен із них в експлуатації.\n\n\u003chttps://engineer.company/uk/glossary/opentelemetry/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як OpenTelemetry дає змогу інструментувати код один раз для будь-якого бекенду, що роблять OTLP і Collector та де зазвичай буксує трасування.","formats":{"gemtext":"https://engineer.company/uk/glossary/opentelemetry/index.gmi","gopher":"https://engineer.company/uk/glossary/opentelemetry/gophermap","html":"https://engineer.company/uk/glossary/opentelemetry/","json":"https://engineer.company/uk/glossary/opentelemetry/index.json","markdown":"https://engineer.company/uk/glossary/opentelemetry/index.md","pdf":"https://engineer.company/uk/glossary/opentelemetry/index.pdf"},"kind":"page","language":"uk","title":"Що таке OpenTelemetry?","url":"https://engineer.company/uk/glossary/opentelemetry/","version":1}