---
read_when:
    - Потрібні точкові журнали налагодження без підвищення глобальних рівнів журналювання
    - Потрібно зібрати журнали конкретної підсистеми для служби підтримки
summary: Прапорці діагностики для цільових журналів налагодження
title: Прапорці діагностики
x-i18n:
    generated_at: "2026-05-02T06:53:26Z"
    model: gpt-5.5
    provider: openai
    source_hash: 1d0ff92d45cf1c5a12a7103ba5b97d656a55a13a7a4f2e86e26ba3a9cfae7687
    source_path: diagnostics/flags.md
    workflow: 16
---

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

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

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

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

```json
{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}
```

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

```json
{
  "diagnostics": {
    "flags": ["telegram.http", "brave.http", "gateway.*"]
  }
}
```

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

## Перевизначення env (одноразове)

```bash
OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload
```

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

```bash
OPENCLAW_DIAGNOSTICS=0
```

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

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

```bash
OPENCLAW_DIAGNOSTICS=timeline \
OPENCLAW_DIAGNOSTICS_TIMELINE_PATH=/tmp/openclaw-timeline.jsonl \
openclaw gateway run
```

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

```json
{
  "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
ls -t /tmp/openclaw/openclaw-*.log | head -n 1
```

Фільтр для діагностики Telegram HTTP:

```bash
rg "telegram http error" /tmp/openclaw/openclaw-*.log
```

Фільтр для діагностики Brave Search HTTP:

```bash
rg "brave http" /tmp/openclaw/openclaw-*.log
```

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

```bash
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)
