From 1ed77742477b53cee53030b5fbf2a64a1ae090b6 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 4 May 2026 23:11:59 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/gateway/logging.md | 97 +++++++++++++++++++++----------------- 1 file changed, 54 insertions(+), 43 deletions(-) diff --git a/docs/uk/gateway/logging.md b/docs/uk/gateway/logging.md index eca2deed9..6782854af 100644 --- a/docs/uk/gateway/logging.md +++ b/docs/uk/gateway/logging.md @@ -1,14 +1,14 @@ --- read_when: - - Зміна виводу журналювання або форматів + - Зміна виводу або форматів журналювання - Налагодження виводу CLI або Gateway -summary: Поверхні логування, файлові логи, стилі WS-логів і форматування консолі +summary: Поверхні журналювання, файлові журнали, стилі журналів WS і форматування консолі title: Журналювання Gateway x-i18n: - generated_at: "2026-05-01T22:18:30Z" + generated_at: "2026-05-04T23:11:26Z" model: gpt-5.5 provider: openai - source_hash: eb5f5ccd77909e82bd2938a33514ce8361c69910eb945c731d9b2c8266174c13 + source_hash: d49ca112d3cc4ec76ecfc8b14d16dae64f74ca1f761fdb2b7bb470f73b66a246 source_path: gateway/logging.md workflow: 16 --- @@ -19,86 +19,97 @@ x-i18n: OpenClaw має дві «поверхні» журналювання: -- **Консольний вивід** (те, що ви бачите в терміналі / Debug UI). +- **Вивід у консоль** (те, що ви бачите в терміналі / Debug UI). - **Файлові журнали** (рядки JSON), які записує журналювач Gateway. +Під час запуску Gateway записує в журнал визначену модель агента за замовчуванням разом із +типовими режимами, що впливають на нові сеанси, наприклад: + +```text +agent model: openai-codex/gpt-5.5 (thinking=medium, fast=on) +``` + +`thinking` береться з агента за замовчуванням, параметрів моделі або глобального значення агента за замовчуванням; +якщо його не задано, у підсумку запуску показується `medium`. `fast` береться з +агента за замовчуванням або параметрів моделі `fastMode`. + ## Файловий журналювач -- Стандартний ротаційний файл журналу розташований у `/tmp/openclaw/` (один файл на день): `openclaw-YYYY-MM-DD.log` +- Типовий файл журналу з ротацією розташований у `/tmp/openclaw/` (один файл на день): `openclaw-YYYY-MM-DD.log` - Дата використовує локальний часовий пояс хоста Gateway. -- Активні файли журналу ротуються при `logging.maxFileBytes` (стандартно: 100 MB), зберігаючи - до п’яти пронумерованих архівів і продовжуючи запис у новий активний файл. +- Активні файли журналу ротуються за `logging.maxFileBytes` (типово: 100 MB), зберігаючи + до п’яти нумерованих архівів і продовжуючи запис у новий активний файл. - Шлях до файлу журналу та рівень можна налаштувати через `~/.openclaw/openclaw.json`: - `logging.file` - `logging.level` Формат файлу: один об’єкт JSON на рядок. -Вкладка журналів у Control UI відстежує цей файл через Gateway (`logs.tail`). +Вкладка Logs у Control UI відстежує цей файл через Gateway (`logs.tail`). CLI може робити те саме: ```bash openclaw logs --follow ``` -**Детальний режим і рівні журналювання** +**Докладність vs. рівні журналювання** - **Файлові журнали** керуються виключно `logging.level`. -- `--verbose` впливає лише на **детальність консолі** (і стиль журналів WS); він **не** - підвищує рівень файлового журналу. -- Щоб записувати у файлові журнали деталі, доступні лише в детальному режимі, установіть `logging.level` на `debug` або +- `--verbose` впливає лише на **докладність консолі** (і стиль журналів WS); він **не** + підвищує рівень файлового журналювання. +- Щоб записувати у файлові журнали деталі, доступні лише в докладному режимі, встановіть `logging.level` у `debug` або `trace`. -- Журналювання trace також включає діагностичні підсумки часу для вибраних гарячих шляхів, - наприклад підготовки фабрики інструментів Plugin. Див. +- Журналювання рівня trace також включає діагностичні підсумки часу для вибраних гарячих шляхів, + як-от підготовка фабрики інструментів Plugin. Див. [/tools/plugin#slow-plugin-tool-setup](/uk/tools/plugin#slow-plugin-tool-setup). ## Захоплення консолі CLI захоплює `console.log/info/warn/error/debug/trace` і записує їх у файлові журнали, -одночасно продовжуючи друкувати у stdout/stderr. +одночасно продовжуючи друк у stdout/stderr. -Детальність консолі можна налаштовувати незалежно через: +Докладність консолі можна налаштовувати незалежно через: -- `logging.consoleLevel` (стандартно `info`) +- `logging.consoleLevel` (типово `info`) - `logging.consoleStyle` (`pretty` | `compact` | `json`) -## Редагування чутливих даних +## Редагування секретів -OpenClaw може маскувати чутливі токени до того, як журнальний або транскриптний вивід залишить -процес. Ця політика редагування журналів застосовується до консолі, файлового журналу, OTLP -записів журналу та текстових приймачів транскриптів сесії, тому відповідні секретні значення +OpenClaw може маскувати чутливі токени до того, як вивід журналу або транскрипту залишить +процес. Ця політика редагування секретів у журналах застосовується до приймачів тексту консолі, файлового журналу, записів журналу OTLP +і транскриптів сеансів, тому відповідні секретні значення маскуються до запису рядків JSONL або повідомлень на диск. -- `logging.redactSensitive`: `off` | `tools` (стандартно: `tools`) -- `logging.redactPatterns`: масив рядків regex (перевизначає стандартні значення) - - Використовуйте сирі рядки regex (авто `gi`) або `/pattern/flags`, якщо потрібні власні прапорці. +- `logging.redactSensitive`: `off` | `tools` (типово: `tools`) +- `logging.redactPatterns`: масив рядків regex (перевизначає типові значення) + - Використовуйте необроблені рядки regex (автоматично `gi`) або `/pattern/flags`, якщо потрібні власні прапорці. - Збіги маскуються зі збереженням перших 6 + останніх 4 символів (довжина >= 18), інакше `***`. - - Стандартні значення покривають поширені присвоєння ключів, CLI прапорці, поля JSON, bearer-заголовки, блоки PEM, популярні префікси токенів і назви полів платіжних облікових даних, як-от номер картки, CVC/CVV, спільний платіжний токен і платіжні облікові дані. + - Типові значення охоплюють поширені присвоєння ключів, прапорці CLI, поля JSON, заголовки bearer, блоки PEM, популярні префікси токенів і назви полів платіжних облікових даних, як-от номер картки, CVC/CVV, спільний платіжний токен і платіжні облікові дані. -Деякі межі безпеки завжди редагують чутливі дані незалежно від `logging.redactSensitive`. +Деякі межі безпеки завжди редагують секрети незалежно від `logging.redactSensitive`. Сюди входять події викликів інструментів Control UI, вивід інструмента `sessions_history`, -експорти діагностичної підтримки, спостереження помилок провайдерів, відображення команди -схвалення exec і журнали протоколу Gateway WebSocket. Ці поверхні все ще можуть використовувати +експорти діагностичної підтримки, спостереження за помилками провайдера, відображення команд +схвалення exec і журнали протоколу WebSocket Gateway. Ці поверхні все ще можуть використовувати `logging.redactPatterns` як додаткові шаблони, але `redactSensitive: "off"` не змушує їх виводити необроблені секрети. -## Журнали Gateway WebSocket +## Журнали WebSocket Gateway Gateway друкує журнали протоколу WebSocket у двох режимах: - **Звичайний режим (без `--verbose`)**: друкуються лише «цікаві» результати RPC: - помилки (`ok=false`) - - повільні виклики (стандартний поріг: `>= 50ms`) + - повільні виклики (типовий поріг: `>= 50ms`) - помилки розбору -- **Детальний режим (`--verbose`)**: друкує весь трафік запитів/відповідей WS. +- **Докладний режим (`--verbose`)**: друкує весь трафік запитів/відповідей WS. ### Стиль журналів WS -`openclaw gateway` підтримує перемикач стилю для окремого Gateway: +`openclaw gateway` підтримує перемикач стилю для кожного Gateway: -- `--ws-log auto` (стандартно): звичайний режим оптимізований; детальний режим використовує компактний вивід -- `--ws-log compact`: компактний вивід (парні запит/відповідь) у детальному режимі -- `--ws-log full`: повний вивід для кожного кадру в детальному режимі +- `--ws-log auto` (типово): звичайний режим оптимізовано; докладний режим використовує компактний вивід +- `--ws-log compact`: компактний вивід (парні запит/відповідь) у докладному режимі +- `--ws-log full`: повний покадровий вивід у докладному режимі - `--compact`: псевдонім для `--ws-log compact` Приклади: @@ -122,14 +133,14 @@ openclaw gateway --verbose --ws-log full Поведінка: - **Префікси підсистем** у кожному рядку (наприклад, `[gateway]`, `[canvas]`, `[tailscale]`) -- **Кольори підсистем** (стабільні для кожної підсистеми) плюс забарвлення рівнів -- **Колір, коли вивід є TTY або середовище схоже на насичений термінал** (`TERM`/`COLORTERM`/`TERM_PROGRAM`), враховує `NO_COLOR` -- **Скорочені префікси підсистем**: прибирає початкові `gateway/` + `channels/`, залишає останні 2 сегменти (наприклад, `whatsapp/outbound`) -- **Піджурналювачі за підсистемою** (автопрефікс + структуроване поле `{ subsystem }`) -- **`logRaw()`** для QR/UX виводу (без префікса, без форматування) +- **Кольори підсистем** (стабільні для кожної підсистеми) плюс забарвлення рівня +- **Колір, коли вивід є TTY або середовище схоже на багатий термінал** (`TERM`/`COLORTERM`/`TERM_PROGRAM`), з урахуванням `NO_COLOR` +- **Скорочені префікси підсистем**: відкидає початкові `gateway/` + `channels/`, зберігає останні 2 сегменти (наприклад, `whatsapp/outbound`) +- **Піджурналювачі за підсистемою** (автоматичний префікс + структуроване поле `{ subsystem }`) +- **`logRaw()`** для QR/UX-виводу (без префікса, без форматування) - **Стилі консолі** (наприклад, `pretty | compact | json`) -- **Рівень журналювання консолі** окремий від рівня файлового журналу (файл зберігає повну деталізацію, коли `logging.level` встановлено на `debug`/`trace`) -- **Тіла повідомлень WhatsApp** журналюються на рівні `debug` (використовуйте `--verbose`, щоб їх бачити) +- **Рівень журналювання консолі** окремий від рівня файлового журналювання (файл зберігає повні деталі, коли `logging.level` встановлено в `debug`/`trace`) +- **Тіла повідомлень WhatsApp** записуються на рівні `debug` (використовуйте `--verbose`, щоб побачити їх) Це зберігає наявні файлові журнали стабільними, водночас роблячи інтерактивний вивід зручним для перегляду.