{"canonical_url":"https://engineer.company/uk/glossary/logging/","content_markdown":"# Журналювання\n\n## Що це таке\n\nЖурналювання, або логування, — це безперервний облік, який програма веде про\nвласну поведінку, по одному запису на кожну подію: обслужений запит, відхилений\nпароль, повторна спроба, аварійне завершення. Кожен такий запис, рядок журналу,\nмістить щонайменше час і повідомлення, щоб згодом можна було відновити, що\nсталося і в якому порядку. Проєкт OpenTelemetry визначає журнал як текстовий\nзапис із часовою міткою, структурований чи неструктурований, з необов'язковими\nметаданими, і зазначає, що з усіх сигналів телеметрії журнали мають найбільшу\nспадщину.\n\nЦя спадщина має стандарт. Syslog, давній протокол для передавання повідомлень\nпро події до збирача, у березні 2009 року стандартизовано як RFC 5424, що\nзамінив старіший RFC 3164; він присвоює кожному повідомленню один із восьми\nрівнів серйозності, від 0 для Emergency до 7 для Debug. Більшість бібліотек\nжурналювання мають коротшу драбину з тією самою ідеєю: debug, info, warning,\nerror. Модель даних журналів OpenTelemetry відображає їх усі на одне число від 1\nдо 24, у шести смугах від TRACE до FATAL.\n\nНеструктурований рядок — це вільний текст: людині його легко прочитати, а машина\nможе розібрати його лише регулярним виразом, написаним саме під це формулювання.\nСтруктурований рядок дотримується схеми, тож кожен запис має ті самі іменовані\nполя з тими самими типами й призначенням. OpenTelemetry віддає перевагу\nструктурованим журналам у продакшні й додає застереження, яке легко пропустити:\nрядок, закодований як JSON, не стає структурованим лише тому, що він\nрозбирається; структурованим його робить стабільна схема. Тут запис показано в\nкількох рядках, а на диску це один рядок:\n\n```json\n{\n    \"time\": \"2026-09-14T03:12:07.412Z\",\n    \"severity\": \"WARN\",\n    \"service\": \"checkout\",\n    \"event\": \"payment.retry\",\n    \"attempt\": 3,\n    \"trace_id\": \"4bf92f3577b34da6a3ce929d0e0e4736\"\n}\n```\n\nМетрики й трасування — сигнали, які зазвичай збирають поруч із ним. Метрики — це\nчисла, виміряні з плином часу, дешеві для зберігання й добрі для відповіді на\nпитання «як часто». Трасування супроводжує один запит через кожен сервіс, якого\nвін торкається. Журнал зберігає подробиці окремих подій, тож коли спрацювала\nтривога, саме до нього звертаються, щоб дізнатися чому. OpenTelemetry пов'язує\nжурнали з трасуваннями, додаючи до кожного запису ідентифікатори активного\nтрасування й спану.\n\n## Чому це важливо\n\nЖурнал — це єдина розповідь про минуле, яку залишає по собі більшість систем.\nМетрика може показати, що о 03:12 кількість помилок зросла; журнал скаже, який\nсаме запит, від якого сервісу, з яким значенням і що програма зробила далі. Коли\nщось ламається вночі й до ранку відновлюється, журнал — той свідок, що досі на\nмісці.\n\nЦя розповідь має ціну, і сплачують її трьома способами. Кожен рядок коштує місця\nна диску, операцій введення-виведення й процесорного часу, а ще більше — якщо\nйого надсилають до центрального сховища, де хостингова служба зазвичай виставляє\nрахунок за обсягом отриманих даних. Кожен рядок — це також дані про когось:\nжурнал доступу вебсервера містить адреси й браузери всіх, хто до нього\nзвертався. І кожен рядок треба захищати. OWASP Logging Cheat Sheet просить, щоб\nкожна подія фіксувала, коли, де, хто і що, а самі журнали були захищені від\nпідробки та від несанкціонованого доступу, змін і видалення, бо вони можуть\nмістити персональні та інші чутливі дані.\n\nУ масштабі організації NIST Special Publication 800-92, Guide to Computer\nSecurity Log Management, яку написали Karen Kent і Murugiah Souppaya і видали у\nвересні 2006 року, розглядає керування журналами як інфраструктуру й процеси в\nмежах усього підприємства, а не як налаштування однієї програми.\n\nЖурнали також працюють найкраще поруч із числами. Посібник з інструментування\nпроєкту Prometheus радить заводити лічильник для кожного рядка коду\nжурналювання, щоб, коли трапиться цікаве повідомлення, можна було побачити, як\nчасто воно з'являлося і як довго, а також порівнювати кількість рядків info,\nwarning і error між релізами.\n\n## Як це виглядає на практиці\n\nВласний журнал доступу сайту описано рядок за рядком на\n[сторінці про конфіденційність](/uk/privacy/). Для кожного запиту записуються\nсторінка й час, статус відповіді, самоопис браузера, назва сайту, з якого\nприйшов відвідувач, і розмита мережева адреса: останню частину замінюють нулями\nв момент запису рядка, ще до того, як щось потрапить на диск. Рядок живе\nприблизно тридцять днів. Серверна програма закриває кожен файл раз на добу, а\nколи той доростає приблизно до 10 МБ — то й раніше, і видаляє закритий файл\nчерез двадцять вісім днів, а щоночі окрема перевірка перечитує всі файли й\nзавершується помилкою, якщо знаходить рядок, старший за тридцять днів. Двічі тут\nтраплялися збої, і сторінка про конфіденційність розповідає про обидва. У\nвересні 2026 року малоактивні адреси набирали 10 МБ так повільно, що їхні файли\nжодного разу не закривалися й досі містили кожен рядок відтоді, як увімкнули\nжурналювання, тож додали щоденне завдання, яке мало їх закривати. 26 жовтня\n2026 року сім із тринадцяти адрес, що ведуть журнал, і далі писали у файли, які\nзавдання позначило як закриті, а одна з них зберігала закритий файл, якому було\nсорок сім днів. Завдання прибрано, і тепер файли закриває й видаляє сама\nсерверна програма.\n\nПовний тестовий запуск застосунку macOS зафіксував 610 996 рядків журналу ядра програми. Сплеск подій цього журналу зберігався в необмеженому основному потоці й копіювався в потоки підписників, чиї споживачі цих подій не використовували. [Запис про інцидент](/uk/portfolio/an-app-that-ate-41-mb-a-second-stopped/) окремо документує діагностичні звіти про 111 ГБ стиснутих сторінок на машині з 36 ГБ і замір обсягу зайнятої пам'яті зі зростанням приблизно на 41 МБ за секунду під час циклу повторних спроб підключення. Обмежені буфери, підписки з фільтрацією за типом події та бюджет частоти записів до журналу виправили цей шлях обробки подій. У зафіксованому порівнянні повних тестових запусків кількість рядків журналу ядра програми зменшилася до 1 411. Це не бенчмарк у виробничому середовищі й не виміряний показник використання пам'яті після виправлення. Бюджет навмисно відкидає інформацію: повторювані діагностичні події можна пропускати й оновлювати відповідний стан, замість того щоб зберігати необмежену кількість подій. Окремі тайм-аути під час завершення роботи потребували власного виправлення.\n\nНа робочому хості\n[посилення захисту тринадцяти юнітів systemd](/uk/portfolio/cut-systemd-sandbox-exposure-on-every-unit/)\nвиявило директиву, яку з помилкою писали у трьох шаблонах юнітів увесь час,\nскільки існували ці ролі. Менеджер служб відповідає на ключ, якого не розпізнає,\nзаписом у журнал і все одно запускає юніт, тож єдиним слідом помилки було\nпопередження в журналі, а виявили її під час переписування юнітів. Тепер кожен\nюніт під час кожного застосування конфігурації проходить через власний верифікатор менеджера\nслужб, тож така сама помилка зупиняє прогін.\n\n## Де виникають проблеми\n\n**Журнал росте найшвидше, коли система вже дає збій.** Цикл, що записує кожну\nповторну спробу, у добрий день дає жменю рядків, а в поганий — тисячі за\nсекунду, забираючи диск, пам'ять і процесорний час у системи, якій їх і так\nбракує. OWASP просить перевіряти, що журналювання не можна використати для\nвиснаження ресурсів системи, наприклад заповнивши диск. Дайте кожному гарячому\nшляху бюджет, згортайте повторювані повідомлення в один рядок із кількістю\nповторів і тримайте лічильник поруч із повідомленням, щоб частота збереглася,\nколи рядки відкидаються.\n\n**Секрети й персональні дані потрапляють у запис.** Запит, записаний цілком,\nнесе все, що в ньому було. Список OWASP того, що зазвичай слід видалити,\nзамаскувати, гешувати чи зашифрувати, перш ніж воно потрапить до журналу,\nмістить ідентифікатори сесій, токени доступу, паролі, рядки підключення до бази\nданих, ключі шифрування й дані платіжних карток. Робіть це в момент запису\nрядка, як журнал доступу вище робить з адресами, бо поки хтось візьметься за\nприбирання, рядок уже може лежати в резервній копії чи архіві.\n\n**Зовнішнє введення дописує фальшивий рядок.** Значення від користувача з\nсимволом повернення каретки чи переведення рядка, записане без екранування в\nтекстовий журнал, може почати новий рядок, точнісінько схожий на той, що написав\nсам застосунок. OWASP називає це log injection і просить очищати такі символи та\nкодувати дані під формат, у якому їх записують. Структурований логер, що записує\nкожне значення як екранований рядок JSON, робить це самою своєю будовою.\n\n**Журнал, що замовк, виглядає як здорова система.** Повний диск, ротований файл,\nякий програма так і не відкрила знову, чи збирач, що впав, ззовні виглядають\nоднаково: рядки перестають надходити. OWASP просить мати спосіб помітити, що\nжурналювання зупинилося. Рахуйте рядки за хвилину для кожного джерела й ставте\nтривогу на падіння цього числа до нуля, щоб пропуск у журналі сам ставав\nтривогою.\n\n## Що почитати далі\n\n- [Logs](https://opentelemetry.io/docs/concepts/signals/logs/) — OpenTelemetry\n  про те, що таке журнал, чому перевагу віддають структурованим журналам і як\n  журнали пов'язують із трасуваннями.\n- [Logs Data Model](https://opentelemetry.io/docs/specs/otel/logs/data-model/) —\n  поля запису журналу, дві його часові мітки й шкала серйозності від 1 до 24.\n- [RFC 5424: The Syslog Protocol](https://www.rfc-editor.org/rfc/rfc5424) —\n  формат повідомлень syslog і вісім рівнів серйозності.\n- [NIST SP 800-92](https://csrc.nist.gov/pubs/sp/800/92/final) — Guide to\n  Computer Security Log Management.\n- [Logging Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Logging_Cheat_Sheet.html)\n  — OWASP про те, які події записувати, які дані тримати поза журналом і як\n  захистити результат.\n- [Instrumentation](https://prometheus.io/docs/practices/instrumentation/) —\n  практики проєкту Prometheus з інструментування коду, зокрема журналювання.\n\n\u003chttps://engineer.company/uk/glossary/logging/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що має містити рядок журналу, як надати йому структуру, що тримати поза ним і чому журнали ростуть найшвидше, коли система у скруті.","formats":{"gemtext":"https://engineer.company/uk/glossary/logging/index.gmi","gopher":"https://engineer.company/uk/glossary/logging/gophermap","html":"https://engineer.company/uk/glossary/logging/","json":"https://engineer.company/uk/glossary/logging/index.json","markdown":"https://engineer.company/uk/glossary/logging/index.md","pdf":"https://engineer.company/uk/glossary/logging/index.pdf"},"kind":"page","language":"uk","title":"Що таке журналювання?","url":"https://engineer.company/uk/glossary/logging/","version":1}