> For the complete documentation index, see [llms.txt](https://docs.ispecalgo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ispecalgo.com/isa-terminal/baza-znanii/kak-otpravit-bag-report.md).

# Баг-репорт

Баг-репорт — это форма в ISA Terminal, через которую вы сообщаете о проблеме команде поддержки.

Через баг-репорт удобно отправлять проблемы, когда:

* что-то не работает или работает не так;
* приложение вылетело;
* бот не запускается;
* подключение показывает ошибку;
* есть ошибка в интерфейсе;
* после обновления терминал ведёт себя неправильно.

Вы описываете проблему своими словами, а терминал сам прикрепляет технические данные: логи, информацию о системе и другие данные для диагностики.

Баг-репорт не заменяет обращение в чат поддержки, но это самый удобный способ передать проблему с полной диагностикой.

## Как это работает

1. Вы открываете форму баг-репорта в терминале.
2. Заполняете заголовок, описание и контакт.
3. По желанию прикрепляете скриншоты.
4. Нажимаете **Отправить**.
5. Терминал собирает служебную информацию и отправляет отчёт на сервер.
6. На стороне поддержки создаётся задача.
7. Вы видите результат: отчёт отправлен или произошла ошибка отправки.

## Что прикрепляется автоматически

Пользователю не нужно искать и прикладывать эти данные вручную — терминал собирает их сам.

| Что прикрепляется                               | Зачем нужно                                  |
| ----------------------------------------------- | -------------------------------------------- |
| Логи интерфейса и Electron за последние 24 часа | Понять, что происходило в приложении         |
| Логи бэкенда за сегодня и вчера                 | Найти ошибки торговой логики                 |
| История ордеров за последние 2 дня              | Разобрать торговые ситуации                  |
| Файлы критических сбоев, если они были          | Понять причину вылета приложения             |
| Информация о системе                            | Понять, на каком ПК воспроизводится проблема |
| Последние действия в терминале                  | Восстановить сценарий пользователя           |

API-ключи, пароли и API Secret вводить в форму не нужно.

Секретные ключи специально не добавляются в отчёт. При этом в логах могут быть названия ботов, торговые пары и тексты ошибок биржи — это нормально для диагностики.

## Где найти баг-репорт

1. В правом верхнем углу терминала нажмите иконку аккаунта.
2. Откроется панель с email и статусом лицензии.
3. Нажмите **Баг репорт**.

## Как отправить баг-репорт

### Шаг 1. Откройте форму

Откройте:

**Иконка аккаунта → Баг репорт**

### Шаг 2. Заполните поля

| Поле                  | Что писать                                            | Ограничения                 |
| --------------------- | ----------------------------------------------------- | --------------------------- |
| Заголовок             | Коротко суть проблемы: например, «Бот не запускается» | 3–30 символов               |
| Описание              | Что делали, что получилось, что ожидали               | 10–1000 символов            |
| Проблема возникает    | Однократно, периодически или всегда                   | Выберите вариант            |
| Контактная информация | Email или Telegram для связи                          | Укажите рабочий контакт     |
| Скриншоты             | Картинки с ошибкой или ситуацией                      | До 3 файлов, каждый до 2 МБ |

В описании уже есть шаблон. Его удобно заполнить по пунктам:

```
Шаги:
Фактический результат:
Ожидаемый результат:
```

### Пример хорошего описания

```
Шаги:
1. Создал подключение Bybit Spot, включил его.
2. Создал бота GRID на BTCUSDT, таймфрейм 5m.
3. Нажал запуск в «Мои боты».

Фактический результат:
Бот в статусе «ошибка», ордера не выставляются.

Ожидаемый результат:
Бот должен запуститься и начать работу.
```

### Шаг 3. Отправьте

Нажмите **Отправить** и дождитесь результата.

Если появилось сообщение **«Баг репорт успешно отправлен»** — отчёт ушёл, поддержка увидит задачу и сможет разобрать проблему.

Если появилась ошибка отправки:

1. Проверьте интернет.
2. Перезапустите ISA Terminal.
3. Попробуйте отправить ещё раз.
4. Если не помогло — напишите в поддержку вручную.

## Как написать, чтобы быстрее помогли

Хороший баг-репорт отвечает на три вопроса:

* что вы делали;
* что произошло;
* что должно было произойти.

Если проблема связана с торговлей, укажите:

* биржу;
* рынок: Spot или Futures;
* подключение;
* стратегию;
* имя бота;
* тикер;
* таймфрейм;
* как часто повторяется проблема.

Скриншот с ошибкой не обязателен, но часто сильно ускоряет разбор.

## Что не нужно писать

Не пишите в описании:

* API Secret;
* пароли;
* приватные ключи;
* лишние личные данные;
* фразы без деталей вроде «не работает».

Плохой пример:

```
Бот не работает, помогите.
```

Хороший пример:

```
После запуска бота LONGER на Bybit Futures BTCUSDT бот переходит в статус ошибки. Проблема повторяется каждый раз. Скриншот приложил, контакт Telegram указал.
```

## Частые вопросы

### Нужен интернет?

Да. Баг-репорт отправляется на сервер, без интернета он не уйдёт.

### Нужна активная лицензия?

Форма открывается из панели аккаунта. Для отправки нужен авторизованный пользователь, работающий бэкенд и доступ к API.

### Можно отправить без скриншота?

Да. Скриншоты необязательны, но желательны, если на экране есть ошибка или странное поведение.

### Отправятся ли API-ключи и пароли?

Пароли и API Secret вводить в форму не нужно. Секретные ключи специально не добавляются в отчёт.

Прикрепляются технические логи для поиска ошибки. В описании не пишите пароли, API Secret и другие чувствительные данные.

### Сколько ждать ответа?

Ответ придёт на указанный email или Telegram. Срок зависит от загрузки поддержки и сложности проблемы.

### Баг-репорт не отправился — что делать?

1. Проверьте интернет.
2. Перезапустите ISA Terminal.
3. Попробуйте снова.
4. Если не помогло — напишите в поддержку вручную и опишите проблему текстом.

## Краткая шпаргалка

1. Иконка аккаунта в правом верхнем углу.
2. **Баг репорт**.
3. Заголовок: 3–30 символов.
4. Описание: шаги, фактический результат, ожидаемый результат.
5. Как часто возникает проблема.
6. Email или Telegram для связи.
7. Скриншоты по желанию: до 3 файлов, каждый до 2 МБ.
8. **Отправить**.