{"canonical_url":"https://engineer.company/uk/glossary/observability/","content_markdown":"# Спостережуваність\n\n## Що це таке\n\nСпостережуваність — це міра того, наскільки команда здатна зрозуміти, що робить\nпрацююча система, лише з даних, які вона сама надсилає назовні: не розбираючи її\nі не знаючи заздалегідь, що саме зламалося. Вступ до спостережуваності від\nпроєкту OpenTelemetry формулює це через запитання: спостережувана система\nдозволяє ставити їй запитання, не знаючи її внутрішньої будови, зокрема такі,\nпро які ніхто не думав, коли писав код. Головне запитання, на яке вона має\nвідповідати, вступ формулює як «Чому це відбувається?»\n\nОтже, спостережуваність — це властивість системи, а не продукт. Інструмент може\nзберігати й показувати дані, але спершу ці дані має надіслати застосунок.\nДокументація OpenTelemetry каже про це прямо: щоб система була\nспостережуваною, її компоненти мають бути інструментовані, тобто їхній код має\nнадсилати сигнали. Далі вона задає практичну планку: застосунок інструментовано\nяк слід, коли розробникам не потрібно додавати нове інструментування, щоб\nрозібратися з проблемою, бо потрібні відомості вже є.\n\nЦі дані називають телеметрією, і OpenTelemetry поділяє їх на сигнали:\n\n- **Трейси** показують шлях одного запиту крізь систему. Трейс складається зі\n  спанів; кожен спан — це одна одиниця роботи з назвою, часом початку й\n  завершення та атрибутами, як-от HTTP-метод і маршрут. Перший спан кореневий і\n  охоплює запит від початку до кінця.\n- **Метрики** — це вимірювання, зроблені під час роботи й агреговані в часі:\n  частка помилок, кількість запитів, завантаження процесора.\n- **Логи** — це записи подій із позначкою часу. Багато з них не пов'язані з\n  жодним конкретним запитом.\n- **Baggage** — це контекстні відомості, які передаються разом із запитом, щоб\n  ними могли скористатися інші сигнали.\n\nСторінка про сигнали також згадує події (events), окремий різновид логів, і\nпрофілі, що фіксують використання ресурсів на рівні коду, як сигнали, які ще\nрозробляються або перебувають на стадії пропозиції.\n\nПеретворює три купи даних на щось, чому можна ставити запитання, саме зв'язок\nміж ними. OpenTelemetry передає контекст між сервісами, тож спан в одному\nсервісі знає, до якого трейсу належить, а до кожного запису в логах можна\nдодати ідентифікатори активного трейсу й спану. Кожен сигнал також несе\nресурс: атрибути, що визначають, хто його створив, наприклад назву сервісу,\nхост або контейнер. Завдяки цим спільним ключам команда може перейти від\nметрики до запитів, що за нею стоять, а від запиту — до рядків логів, які він\nзалишив.\n\nСпостережуваність і моніторинг перетинаються, але це не одне й те саме.\nМоніторинг стежить за умовами, які хтось заздалегідь вирішив вважати важливими,\nі піднімає тривогу, коли одна з них настає. Спостережуваність — це те, з чим\nкоманда працює, коли тривога вже спрацювала, а причина виявилася такою, якої\nніхто не передбачав.\n\n## Чому це важливо\n\nСучасні системи ламаються так, що це важко передбачити. Запит може пройти крізь\nшлюз, кілька сервісів, чергу й базу даних, перш ніж отримає відповідь, і збій у\nбудь-якій ланці може проявитися як повільність зовсім деінде. Вступ називає\nрозподілене трасування необхідним для таких систем, бо їхні проблеми часто\nнедетерміновані або надто складні, щоб відтворити їх на машині розробника. Коли\nзбій не вдається відтворити, телеметрія, записана під час нього, — єдиний доказ,\nякий є.\n\nДашборди й тривоги відповідають на запитання, які хтось передбачив. Це цінно, і\nце покриває збої, які команда вже бачила. Найважчі інциденти — нові, коли\nпитання не в тому, чи зросла частка помилок, а в тому, чому почали падати\nзапити з одного регіону, через одну версію, до одного платіжного провайдера.\nЯкщо для відповіді треба написати новий код, викотити його й чекати, поки\nпроблема повториться, простій триває рівно стільки, скільки цей обхідний шлях.\n\nСпостережуваність також тримає в полі зору користувача. Вступ визначає\nнадійність як те, чи робить сервіс те, чого від нього очікують користувачі, і\nнаводить приклад: інтернет-магазин може бути доступним весь час і все одно\nненадійним, якщо натискання «додати чорні черевики до кошика» не завжди додає\nдо кошика чорні черевики. Метрика сервера цього ніколи не покаже. Телеметрія\nокремих запитів покаже, і саме з неї будують індикатори рівня обслуговування:\nвимірювання з погляду користувача, які цілі рівня обслуговування потім\nпов'язують із тим, що потрібно бізнесу.\n\nНарешті, вона змінює ціну інциденту. Команда, яка може простежити повільний\nзапит до конкретного виклику, що його затримав, витрачає час на виправлення, а\nне на здогадки, а постмортем після інциденту спирається на докази, а не на\nспогади.\n\n## Як це виглядає на практиці\n\nВізьмімо вигаданий інтернет-магазин. Починаючи з 14:00 невелика частка\nоформлень замовлення триває понад дві секунди. Нічого не лежить, жодна тривога\nне спрацювала, і дашборда саме для цього немає. Ось як із цим упоралася б\nкоманда, у якої сигнали пов'язані між собою. Усі назви, ідентифікатори й числа\nнижче вигадані для прикладу.\n\nПерший крок — гістограма тривалості оформлення замовлення в секундах. У\nтекстовому форматі OpenMetrics бакет може нести exemplar після знака `#`:\nпосилання на дані поза метрикою, найчастіше ідентифікатор трейсу, який\nпотрапив у цей бакет. Два бакети виглядають так:\n\n```text\ncheckout_bucket{le=\"1.0\"} 95\ncheckout_bucket{le=\"2.5\"} 97 # {trace_id=\"3f1c9a77e2b04d18a6c5e0b9d4127f60\"} 2.3\n```\n\nДругий крок — перейти за цим ідентифікатором трейсу. Трейс показує, куди\nпішли 2,3 секунди, спан за спаном:\n\n```text\nPOST /checkout                       2.30 s   service checkout\n  SELECT cart                        0.04 s   service checkout\n  POST /authorise                    2.21 s   service payments\n    event: provider timeout, retrying\n  INSERT order                       0.03 s   service checkout\n```\n\nТретій крок — знайти рядки логів із тим самим ідентифікатором трейсу.\nСпецифікація OpenTelemetry для логів у форматах, відмінних від власного\nпротоколу проєкту, просить записувати ідентифікатори в JSON як поля верхнього\nрівня з назвами `trace_id` і `span_id`, малими літерами в шістнадцятковому\nвигляді:\n\n```json\n{\n    \"timestamp\": 1793110051.402,\n    \"severity\": \"WARN\",\n    \"body\": \"provider timeout after 2000 ms, retrying\",\n    \"provider\": \"acquirer-b\",\n    \"trace_id\": \"3f1c9a77e2b04d18a6c5e0b9d4127f60\",\n    \"span_id\": \"a91c04e7d2f3b658\"\n}\n```\n\nТри кроки — і запитання, якого ніхто не планував, має відповідь: один із двох\nплатіжних провайдерів почав перевищувати час очікування відповіді, і кожне замовлення,\nнадіслане до нього, чекало на повторну спробу. Тепер за тим самим атрибутом\n`provider` можна згрупувати всі недавні трейси й підтвердити закономірність,\nперш ніж хтось торкнеться коду.\n\nНічого з цього не працює, якщо сервіси не називають себе. SDK OpenTelemetry\nза замовчуванням задають ресурсному атрибуту `service.name` значення\n`unknown_service`, і документація радить задавати його явно, у коді або через\nзмінну середовища. Інші атрибути ресурсу додають так само:\n\n```sh\nenv OTEL_SERVICE_NAME=checkout \\\n    OTEL_RESOURCE_ATTRIBUTES=deployment.environment.name=production \\\n    ./checkout\n```\n\nНа цьому сайті три роботи з портфоліо показують, як спостережуваність\nнарощують крок за кроком. Перша описує\n[перший дашборд спостережуваності в компанії](/uk/portfolio/built-the-companys-first-observability-dashboard/),\nякий збирав системні показники, як-от процесор, пам'ять і диск, з віддалених\nLinux-серверів через SSH; згодом другу версію побудували на Grafana і\nPrometheus. Робота, що\n[знизила операційний ризик за допомогою Grafana і Prometheus](/uk/portfolio/cut-operational-risk-with-grafana-and-prometheus/),\nінструментувала ключові сервіси й обрала метрики, які щось означають, замість\nчисел для краси. Пізніша робота,\n[власні моніторинг помилок і трасування](/uk/portfolio/built-first-party-error-monitoring-and-tracing/),\nдодала трасування OpenTelemetry через OTLP, щоб повільний запит можна було\nпростежити крізь фронтенд, API і базу даних, а не вгадувати, а поруч із ним\nпрацює конвеєр помилок, який очищує вміст перед збереженням.\n\n## Де виникають проблеми\n\n**Купити замість вбудувати.** Новий інструмент, у який не надходить нічого\nкорисного, — це порожня кімната. Спостережуваність походить з інструментування\nв коді й бібліотеках, тож закладайте час розробників на те, щоб додати спани,\nатрибути й поля логів, а не лише гроші на ліцензію.\n\n**Три сигнали — три острови.** Метрики в одному інструменті, логи в іншому,\nтрейси в третьому, без спільного ключа між ними, — і команда переписує позначки\nчасу з одного екрана на інший. Додавайте ідентифікатори трейсу й спану до\nкожного запису в логах, прикріплюйте exemplars до гістограм тривалості там, де\nце підтримують ваші інструменти, і давайте всім сигналам однакові атрибути\nресурсу.\n\n**Усі сервіси звуться unknown_service.** Це значення SDK за замовчуванням, і\nцілий парк сервісів з однаковою назвою неможливо розрізнити. Задайте\n`OTEL_SERVICE_NAME` для кожного сервісу. Ресурс прив'язується під час створення\nпровайдерів трейсерів і метрик і згодом не змінюється, тож він має бути\nправильним із самого запуску.\n\n**Інструментовано лише краї.** Інструментування без коду (zero-code) — добрий\nпочаток: воно фіксує, що відбувається на краях застосунку, у його бібліотеках і\nв середовищі, де він працює. Але запитання під час інциденту зазвичай про\nбізнес: який тип клієнта, який провайдер, яке значення мав прапорець функції.\nДля цього потрібні атрибути, додані в коді. Документація OpenTelemetry називає\nінструментування в коді доповненням до zero-code, і обидва можуть працювати\nодночасно.\n\n**Інструментувати посеред інциденту.** Якщо для відповіді знадобилися новий\nрядок у логах і нове розгортання, система не була інструментована як слід за\nмірками самого вступу. Зробіть «що нам довелося додати?» постійним запитанням\nкожного розбору інциденту, а кожну відповідь — окремим завданням на потім.\n\n**Необмежені подробиці не в тому сигналі.** Ідентифікатори користувачів, повні\nURL і тіла запитів належать до спанів і записів у логах, а не до міток метрик,\nде кожне нове значення створює ще один часовий ряд. Стандарт OpenMetrics\nобмежує сукупну довжину назв і значень міток в exemplar 128 символами саме для того,\nщоб exemplars не використовували для перенесення даних спанів, і дозволяє\nприймачеві взагалі відкидати exemplars. Перш ніж покладатися на ці зв'язки,\nперевірте, що вони доживають до екрана на всьому шляху від експортера.\n\n**Телеметрія, що витікає.** Спани й логи фіксують, що було в запитах, а там\nможуть бути адреси, імена й токени. Вирішіть, які атрибути можна записувати,\nвідкидайте решту перед збереженням і захищайте телеметрію так само ретельно, як\nбазу даних, яку вона описує.\n\n## Що почитати далі\n\n- [Observability primer](https://opentelemetry.io/docs/concepts/observability-primer/)\n  — визначення від проєкту OpenTelemetry разом із надійністю, SLI і SLO, спанами\n  та розподіленими трейсами.\n- [Signals](https://opentelemetry.io/docs/concepts/signals/) — трейси, метрики,\n  логи й baggage, а також сигнали, які ще розробляються.\n- [Instrumentation](https://opentelemetry.io/docs/concepts/instrumentation/) —\n  інструментування в коді та без коду і те, як передавання контексту пов'язує\n  сигнали між собою.\n- [Resources](https://opentelemetry.io/docs/concepts/resources/) — атрибути\n  ресурсу, значення `unknown_service` за замовчуванням і змінні середовища, що\n  їх задають.\n- [Trace Context in non-OTLP Log Formats](https://opentelemetry.io/docs/specs/otel/compatibility/logging_trace_context/)\n  — стабільна специфікація того, як записувати ідентифікатори трейсу й спану в\n  syslog, звичайний текст і логи у форматі JSON.\n- [OpenMetrics 1.0](https://prometheus.io/docs/specs/om/open_metrics_spec/) —\n  стандарт формату експонування метрик, зокрема exemplars, з порадами щодо\n  кардинальності.\n\n\u003chttps://engineer.company/uk/glossary/observability/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що таке спостережуваність, як трейси, метрики й логи пов'язуються спільними ідентифікаторами і які звички роблять систему непрозорою.","formats":{"gemtext":"https://engineer.company/uk/glossary/observability/index.gmi","gopher":"https://engineer.company/uk/glossary/observability/gophermap","html":"https://engineer.company/uk/glossary/observability/","json":"https://engineer.company/uk/glossary/observability/index.json","markdown":"https://engineer.company/uk/glossary/observability/index.md","pdf":"https://engineer.company/uk/glossary/observability/index.pdf"},"kind":"page","language":"uk","title":"Що таке спостережуваність?","url":"https://engineer.company/uk/glossary/observability/","version":1}