chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-05-04 23:11:59 +00:00
parent 0dc80c5dc4
commit 1ed7774247

View File

@ -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`, щоб побачити їх)
Це зберігає наявні файлові журнали стабільними, водночас роблячи інтерактивний вивід зручним для перегляду.