---
read_when:
    - Вам потрібні цільові журнали налагодження без підвищення глобальних рівнів журналювання
    - Вам потрібно зібрати журнали, специфічні для підсистеми, для підтримки
summary: Прапорці діагностики для цільових журналів налагодження
title: Прапорці діагностики
x-i18n:
    generated_at: "2026-04-05T18:02:31Z"
    model: gpt-5.4
    provider: openai
    source_hash: daf0eca0e6bd1cbc2c400b2e94e1698709a96b9cdba1a8cf00bd580a61829124
    source_path: diagnostics/flags.md
    workflow: 15
---

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

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

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

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

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

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

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

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

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

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

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

Вимкнення всіх прапорців:

```bash
OPENCLAW_DIAGNOSTICS=0
```

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

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

```
/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
```

Або стежте за ними під час відтворення:

```bash
tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"
```

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

## Примітки

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