{"canonical_url":"https://engineer.company/uk/glossary/metrics/","content_markdown":"# Метрика\n\n## Що це таке\n\nМетрика — це вимірювання працюючого сервісу, зроблене в певний момент і\nзбережене як значення з позначкою часу та кількома мітками, щоб ту саму\nвеличину можна було прочитати знову через хвилину, добу чи місяць. Одна названа\nвеличина — це метрика; збережена як послідовність значень у часі, вона стає\nчасовим рядом; а OpenTelemetry відносить метрики до своїх сигналів, поряд із\nтрасами й журналами. Обслужені запити, зайнята пам'ять і завдання, що чекають у\nчерзі, — типові метрики.\n\nВід інших сигналів метрики відрізняє агрегація. Журнал зберігає один рядок на\nподію, а траса стежить за одним запитом крізь систему. Метрика згортає багато\nвимірювань у кілька статистик за часове вікно: кількість, суму, поточне\nзначення, розподіл за кошиками. Документація OpenTelemetry називає результат\nстатистичною інформацією в сукупності, і в цьому і сила, і межа: метрика каже,\nскільки запитів завершилися помилкою за останню хвилину, а журнал — які саме.\n\nOpenTelemetry і Prometheus сходяться на невеликому наборі форм, і вибір\nправильної — це більша частина проєктування:\n\n- **Лічильник** (counter) накопичує і лише зростає, як одометр в автомобілі:\n  обслужені запити, надіслані байти, помічені помилки. Prometheus допускає один\n  виняток — скидання до нуля, коли процес перезапускається.\n- **Двонапрямний лічильник** (up-down counter), у термінах OpenTelemetry,\n  накопичує, але може й зменшуватися, як довжина черги, коли робота надходить і\n  йде.\n- **Датчик** (gauge) — поточне значення, прочитане в момент читання, як\n  покажчик пального в тому ж автомобілі: зайнята пам'ять, температура, запити в\n  обробці.\n- **Гістограма** розкладає вимірювання за кошиками і зберігає їхню кількість і\n  суму, тож може відповісти, скільки запитів тривали менше за секунду.\n\nPrometheus має ще й тип summary, що обчислює квантилі всередині програми. Модель\nданих OpenTelemetry зберігає його лише як застарілий тип, бо summary не завжди\nможна змістовно об'єднати.\n\nТекстовий формат, який збирає Prometheus, показує всі частини разом: рядок\nдовідки, рядок типу, а далі по рядку на кожну комбінацію міток з іменем,\nмітками, значенням і необов'язковою позначкою часу в мілісекундах від епохи.\n\n```text\n# HELP http_requests_total The total number of HTTP requests.\n# TYPE http_requests_total counter\nhttp_requests_total{method=\"post\",code=\"200\"} 1027 1395066363000\nhttp_requests_total{method=\"post\",code=\"400\"} 3 1395066363000\n```\n\n## Чому це важливо\n\nМетрики досить дешеві, щоб тримати їх для всього. Пам'ять, якої вони потребують,\nзростає з кількістю різних комбінацій міток, а не з трафіком; документація\nOpenTelemetry каже про це прямо, протиставляючи метрики журналам. Лічильник,\nзбільшений мільярд разів, — це все одно одне число. Саме це дає команді змогу\nрахувати кожен запит, а не вибірку, і тримати підрахунки достатньо довго, щоб\nпорівняти цей місяць із попереднім.\n\nВони перетворюють суперечки на вимірювання. Чи достатньо великий хост, чи\nсповільнив реліз відповіді, як скоро заповниться диск: на кожне питання є\nвідповідь у ряді, записаному ще до того, як хтось запитав. На тих самих числах\nбудують сповіщення, бо правило сповіщення — це умова над метрикою, через яку,\nяк хтось вирішив, варто прокинутися.\n\nВони також переживають код, що їх видає, тож форму варто зробити правильною.\nПорадник Prometheus з іменування просить одну одиницю й одну величину на\nметрику, у базових одиницях, як-от секунди й байти, а не мілісекунди чи\nмегабайти, з одиницею як суфіксом у множині й `_total` для накопичуваної\nкількості. Тоді імена на кшталт `http_request_duration_seconds` і\n`process_cpu_seconds_total` самі кажуть, що в них.\n\nВажить і те, як мандрують підсумки. Prometheus передає кумулятивні підсумки,\nтож прогалини від збору, що час від часу збоїть, усереднюються, а ціна — пам'ять\nу відправника пропорційно до його комбінацій міток. StatsD передає дельти, тобто\nзміну від останнього звіту, і це виносить ці витрати за межі процесу.\n\n## Як це виглядає на практиці\n\nВласний хост публічних сервісів компанії — одноядерна машина з 512 МБ пам'яті, з яких придатні близько 464 МБ, і на ній пам'ять стала аргументом, що визначав рішення. Звітність там працює на запит: сім команд, які зчитують стан хоста і формують Markdown, нічого не змінюють та виконуються лише на запит. Коли постало питання, [чи витримає цей один хост із 512 МБ ще й onion-сервіс](/uk/portfolio/a-whole-company-on-one-small-server/), відповідь спиралася не на думку, а на вибірки вимірювань, зафіксовані протягом доби: доступна пам'ять не опускалася нижче приблизно 310 МБ із 464, використання підкачування трималося на 2,6%, а процесор 99,7% часу простоював.\n\nЗгодом ці звіти мали сказати, чого варті їхні числа.\n[Шість збирачів лише для читання тепер кажуть, чого вони не прочитали](/uk/portfolio/made-six-collectors-state-what-they-skipped/),\nвідколи стало ясно, що сліпий збір і здоровий хост дають ту саму сторінку:\nдзеркало, чий демон змінив формат журналу, давало той самий нуль, що й дзеркало,\nякого ніхто не відвідував. Пороги підігнали до 116 зразків, які звіт метрик уже\nвиміряв, а поряд із межами записали спостережені діапазони, і звіт розрізняє три\nнаслідки: порушення, відсутність порушення і неоцінено, бо ніщо цього не\nвиміряло. Кожен збирач повідомляє свій час роботи і свою сліпоту, як-от кількість\nпрочитаних файлів і файлів, які не вдалося прочитати, навіть коли відповідь нуль. Межі застосовуються до середніх добових\nзначень, які можуть приховати однохвилинний сплеск. Перемикач, що\nзапускається кожні п'ятнадцять хвилин, під час кожного запуску перевіряє\nдоступну пам'ять і вільне місце на диску, але короткочасне порушення межі між\nперевірками все одно може залишитися непоміченим.\n\nНайкорисніші метрики часто походять від задачі, а не від хоста. Нотатка про\n[продаж обмеженого запасу без продажів понад залишок](/uk/notes/selling-limited-stock-without-overselling/)\nзбирає на одній панелі очікування блокувань, резерви, що спливли, і розрив між\nчислом шлюзу та числом бази, а інваріант `available + held + sold = total`\nзапускає за розкладом, з графіком і тривогою на будь-яке розходження. Кожне з\nцих чисел походить зі знання того, як саме цей продаж іде не так.\n\n## Де виникають проблеми\n\nМетрики рідко ламаються гучно. Графік далі малюється, а число на ньому тихо\nозначає щось інше, ніж каже його назва.\n\n**Значення, що спадає, публікують як лічильник.** Сторінка Prometheus про типи\nметрик радить не використовувати лічильник для того, що може зменшуватися, як-от\nкількість запущених процесів: це датчик. Функції запитів сприймають будь-яке\nпадіння лічильника як перезапуск і виправляють його, тож значення, що спадає\nнавмисно, з'являється як зростання, якого ніколи не було.\n\n**Одиниці розходяться між сервісами.** Один сервіс звітує тривалість у\nмілісекундах, інший — у секундах, і панель, що їх порівнює, помиляється в тисячу\nразів. Порадник з іменування каже, що метрика мусить стосуватися однієї одиниці\nй має використовувати базові одиниці. Перевести один раз, біля джерела,\nдешевше, ніж пам'ятати різницю в кожному запиті.\n\n**Сума за мітками нічого не означає.** Емпіричне правило порадника з\nіменування: сума чи середнє за всіма мітками метрики має бути змістовним. Його\nвласний приклад: місткості кількох черг належать до однієї метрики, а місткість\nчерги та її поточна довжина — ні.\n\n**Невиміряне читається як нуль.** Збирач, що перестав читати свій вхід, лишає\nнуль або відсутній рядок, що виглядає точнісінько як спокійна система. Модель\nданих OpenTelemetry має прапорець для точки без записаного значення, свій\nвідповідник маркера застарілості Prometheus, бо відсутні дані й нульове\nзначення — різні факти. Звітуйте їх по-різному й дайте «неоцінено» окремий\nнаслідок, як це роблять збирачі вище.\n\n**Вікно ховає сплеск.** Датчик — це зразок у певний момент, і модель даних\nOpenTelemetry передає лише останнє значення в кожному інтервалі, тож сплеск між\nдвома зразками не лишає сліду. Денне середнє так само згладжує хвилину біля\nстелі. Обирайте вікно з огляду на збій, який треба побачити, і тримайте швидку\nперевірку поряд із повільною, коли важливі обидві.\n\n**Переповнення занижує відфільтрований запит.** SDK OpenTelemetry за\nзамовчуванням відстежує щонайбільше 2000 різних комбінацій атрибутів на потік\nметрики, а всі наступні згортає в одну точку даних з позначкою\n`otel.metric.overflow=true`. Загальний підсумок лишається правильним, але\nпереповнення замінює всю комбінацію, а не лише її шумну частину. У власному\nприкладі документації лічильник запитів несе `url.path` і `success`; коли він\nпереповнюється, запит на `success=false` дає занижену кількість, і сповіщення\nпро частку помилок, побудоване на ньому, може перестати спрацьовувати. Тримайте\nатрибути в малих, відомих наборах і стежте за позначкою переповнення.\n\n## Що почитати далі\n\n- [OpenTelemetry: Metrics](https://opentelemetry.io/docs/concepts/signals/metrics/)\n  — види інструментів, агрегація та обмеження кардинальності.\n- [OpenTelemetry: Metrics data model](https://opentelemetry.io/docs/specs/otel/metrics/data-model/)\n  — датчики, суми, гістограми, темпоральність і прапорець відсутнього значення.\n- [Prometheus: Metric types](https://prometheus.io/docs/concepts/metric_types/)\n  — counter, gauge, histogram і summary.\n- [Prometheus: Metric and label naming](https://prometheus.io/docs/practices/naming/)\n  — базові одиниці, суфікси одиниць і `_total`.\n- [Prometheus: Histograms and summaries](https://prometheus.io/docs/practices/histograms/)\n  — де обчислюються квантилі і які з них можна поєднувати.\n- [Prometheus: Exposition formats](https://prometheus.io/docs/instrumenting/exposition_formats/)\n  — текстовий формат рядок за рядком.\n\n\u003chttps://engineer.company/uk/glossary/metrics/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як лічильники, датчики й гістограми перетворюють працюючий сервіс на числа, яким можна довіряти, як їх називати і як метрика непомітно перестає казати правду.","formats":{"gemtext":"https://engineer.company/uk/glossary/metrics/index.gmi","gopher":"https://engineer.company/uk/glossary/metrics/gophermap","html":"https://engineer.company/uk/glossary/metrics/","json":"https://engineer.company/uk/glossary/metrics/index.json","markdown":"https://engineer.company/uk/glossary/metrics/index.md","pdf":"https://engineer.company/uk/glossary/metrics/index.pdf"},"kind":"page","language":"uk","title":"Що таке метрика?","url":"https://engineer.company/uk/glossary/metrics/","version":1}