> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Прапорці діагностики

Прапорці діагностики дають змогу ввімкнути цільові журнали налагодження без увімкнення детального логування всюди. Прапорці вмикаються явно й не мають ефекту, якщо підсистема їх не перевіряє.

## Як це працює

* Прапорці є рядками (без урахування регістру).
* Ви можете ввімкнути прапорці в конфігурації або через перевизначення змінною середовища.
* Підтримуються шаблони:
  * `telegram.*` відповідає `telegram.http`
  * `*` вмикає всі прапорці

## Увімкнення через конфігурацію

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}
```

Кілька прапорців:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "diagnostics": {
    "flags": ["telegram.http", "brave.http", "gateway.*"]
  }
}
```

Перезапустіть Gateway після зміни прапорців.

## Перевизначення через змінну середовища (одноразово)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload
```

Вимкнути всі прапорці:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_DIAGNOSTICS=0
```

`OPENCLAW_DIAGNOSTICS=0` — це перевизначення вимкнення на рівні процесу: воно вимикає
прапорці як зі змінної середовища, так і з конфігурації для цього процесу.

## Прапорці профілювання

Прапорці профайлера вмикають цільові інтервали вимірювання часу без підвищення глобальних
рівнів логування. За замовчуванням вони вимкнені.

Увімкнути всі інтервали, керовані профайлером, для одного запуску Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_DIAGNOSTICS=profiler openclaw gateway run
```

Увімкнути лише інтервали профайлера для dispatch відповідей:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_DIAGNOSTICS=reply.profiler openclaw gateway run
```

Увімкнути лише інтервали профайлера запуску сервера застосунку Codex, інструментів і потоків:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_DIAGNOSTICS=codex.profiler openclaw gateway run
```

Увімкнути прапорці профайлера з конфігурації:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "diagnostics": {
    "flags": ["reply.profiler", "codex.profiler"]
  }
}
```

Перезапустіть Gateway після зміни прапорців конфігурації. Щоб вимкнути прапорець профайлера,
видаліть його з `diagnostics.flags` і перезапустіть. Щоб тимчасово вимкнути кожен
прапорець діагностики, навіть коли конфігурація вмикає прапорці профайлера, запустіть процес із:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_DIAGNOSTICS=0 openclaw gateway run
```

## Артефакти часової шкали

Прапорець `timeline` записує структуровані події вимірювання часу запуску та виконання для
зовнішніх QA harnesses:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_DIAGNOSTICS=timeline \
OPENCLAW_DIAGNOSTICS_TIMELINE_PATH=/tmp/openclaw-timeline.jsonl \
openclaw gateway run
```

Ви також можете ввімкнути його в конфігурації:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "diagnostics": {
    "flags": ["timeline"]
  }
}
```

Шлях до файлу часової шкали все одно береться з
`OPENCLAW_DIAGNOSTICS_TIMELINE_PATH`. Коли `timeline` увімкнено лише з
конфігурації, найраніші інтервали завантаження конфігурації не створюються, бо OpenClaw ще
не прочитав конфігурацію; наступні інтервали запуску використовують прапорець конфігурації.

`OPENCLAW_DIAGNOSTICS=1`, `OPENCLAW_DIAGNOSTICS=all` і
`OPENCLAW_DIAGNOSTICS=*` також вмикають часову шкалу, бо вони вмикають кожен
прапорець діагностики. Віддавайте перевагу `timeline`, коли вам потрібен лише JSONL-артефакт
вимірювання часу.

Записи часової шкали використовують оболонку `openclaw.diagnostics.v1`. Події можуть містити
ідентифікатори процесів, назви фаз, назви інтервалів, тривалості, ідентифікатори Plugin, кількість залежностей,
зразки затримки циклу подій, назви операцій провайдера, стан завершення дочірнього процесу
та назви/повідомлення помилок запуску. Розглядайте файли часової шкали як локальні діагностичні
артефакти; переглядайте їх перед передаванням за межі вашого комп'ютера.

## Куди потрапляють журнали

Прапорці записують журнали у стандартний файл журналу діагностики. За замовчуванням:

```
/tmp/openclaw/openclaw-YYYY-MM-DD.log
```

Якщо ви задали `logging.file`, натомість використовуйте цей шлях. Журнали мають формат JSONL (один JSON-об'єкт на рядок). Редагування чутливих даних і далі застосовується на основі `logging.redactSensitive`.

## Витягування журналів

Виберіть найновіший файл журналу:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ls -t /tmp/openclaw/openclaw-*.log | head -n 1
```

Відфільтруйте діагностику HTTP Telegram:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
rg "telegram http error" /tmp/openclaw/openclaw-*.log
```

Відфільтруйте діагностику HTTP Brave Search:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
rg "brave http" /tmp/openclaw/openclaw-*.log
```

Або відстежуйте журнал під час відтворення:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"
```

Для віддалених Gateway також можна використовувати `openclaw logs --follow` (див. [/cli/logs](/uk/cli/logs)).

## Примітки

* Якщо `logging.level` задано вище за `warn`, ці журнали можуть бути пригнічені. Типове значення `info` підходить.
* `brave.http` записує URL-адреси запитів Brave Search/параметри запиту, стан/час відповіді та події потрапляння/промаху/запису кешу. Він не записує API-ключі або тіла відповідей, але пошукові запити можуть бути чутливими.
* Прапорці безпечно залишати ввімкненими; вони впливають лише на обсяг журналів для конкретної підсистеми.
* Використовуйте [/logging](/uk/logging), щоб змінити призначення журналів, рівні та редагування чутливих даних.

## Пов'язане

* [Діагностика Gateway](/uk/gateway/diagnostics)
* [Усунення несправностей Gateway](/uk/gateway/troubleshooting)