> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/help-center/reshenie-problem/diagnostika/otpravka-diagnosticheskikh-logov-v-iexexchanger.md).
# Отправка диагностических логов в iEXExchanger
Эта настройка позволяет автоматически отправлять очищенные диагностические логи разработчикам iEXExchanger.
Она нужна, чтобы быстрее находить причины технических проблем и помогать клиенту без долгого ручного поиска файлов на сервере.
Диагностические логи могут помочь при разборе:
* ошибок на сайте;
* проблем с мерчантами;
* ошибок автоматических выплат;
* проблем с курсами и парсерами;
* ошибок после обновления;
* сбоев очередей;
* проблем с фоновыми задачами;
* ошибок лицензии;
* проблем с системной конфигурацией.
### Где находится настройка
Откройте панель управления: **«Настройки» — «Общие настройки» — «Основное»**
Найдите блок: **Диагностика**
В этом блоке находится параметр: **Отправлять диагностические логи в iEXExchanger**
### Что делает настройка
Если настройка включена, система периодически проверяет файлы ошибок в папке:
```
storage/logs
```
Подходящие файлы очищаются от чувствительных данных и отправляются разработчикам iEXExchanger.
Отправка выполняется не сразу в момент ошибки, а отложенно — через системное расписание.
По умолчанию проверка запускается примерно один раз в час.
### Что значит «отложенно»
Отложенная отправка означает, что система не отправляет лог при каждой ошибке мгновенно.
Сначала Laravel записывает ошибку в файл лога.
Затем по расписанию система проверяет папку `storage/logs`, выбирает подходящие файлы и отправляет очищенные копии.
Такой подход снижает нагрузку на сайт и не мешает пользователям работать с обменником.
### Для чего это нужно
Без логов поддержке часто приходится просить клиента вручную подключаться к серверу, искать файлы и отправлять их отдельно.
Эта настройка упрощает диагностику.
Система сама отправляет технические данные, которые помогают быстрее понять:
* где возникла ошибка;
* какой модуль вызвал проблему;
* связана ли ошибка с обновлением;
* есть ли проблема с мерчантом;
* есть ли сбой в очередях;
* есть ли проблема с конфигурацией сервера или приложения.
### Какие файлы отправляются
Система проверяет файлы внутри папки:
```
storage/logs
```
К отправке допускаются только читаемые файлы с расширениями:
```
.log
.txt
.json
```
Пустые файлы не отправляются.
Слишком большие файлы также не отправляются.
По умолчанию максимальный размер одного файла: **20 MB**
За один запуск система отправляет ограниченное количество файлов.
По умолчанию: **до 5 файлов за один запуск**
### Какие данные очищаются перед отправкой
Перед отправкой каждый лог проходит очистку.
Система маскирует чувствительные данные, если они встречаются в логах.
Например:
* пароли;
* токены;
* API-ключи;
* приватные ключи;
* license key;
* cookies;
* authorization-заголовки;
* данные банковских карт;
* PAN;
* CVV;
* seed-фразы;
* mnemonic-фразы;
* e-mail адреса;
* длинные числовые последовательности, похожие на чувствительные данные.
После очистки вместо таких значений в файле остаются безопасные метки.
Например:
```
[filtered]
[filtered-email]
```
### Что не отправляется
Эта настройка не отправляет всю базу данных сайта.
Также отдельно не отправляются:
* пользователи;
* заявки;
* документы;
* реквизиты из базы данных;
* настройки мерчантов;
* ключи из админки;
* файлы сайта вне `storage/logs`;
* изображения;
* архивы;
* пользовательские документы.
Отправляются только лог-файлы, которые уже были созданы системой в `storage/logs`, и только после очистки.
### Как работает отправка
Процесс выглядит так:
1. На сайте возникает ошибка или техническое событие.
2. Laravel записывает информацию в `storage/logs`.
3. По расписанию запускается отправка диагностических логов.
4. Система выбирает подходящие файлы.
5. Перед отправкой создаётся временная очищенная копия файла.
6. Очищенная копия отправляется разработчикам iEXExchanger.
7. После успешной отправки система запоминает файл и его контрольную сумму.
8. Тот же самый файл повторно не отправляется, если он не изменился.
Если файл изменился, система может отправить его повторно уже с новым содержимым.
### Что нужно для работы
Для корректной отправки должны выполняться условия:
* настройка включена в админке;
* на сервере работает Laravel CRON;
* указан лицензионный ключ продукта;
* сервер имеет доступ к интернету;
* endpoint iEXExchanger доступен;
* файл лога читается системой;
* размер файла не превышает лимит.
Если CRON на сервере не настроен, автоматическая отправка по расписанию работать не будет.
### Как отключить отправку
Чтобы отключить отправку диагностических логов:
1. Откройте:
```
«Настройки» — «Общие настройки» — «Основное»
```
2. Перейдите к блоку:
```
Диагностика
```
3. Выключите параметр:
```
Отправлять диагностические логи в iEXExchanger
```
4. Сохраните настройки.
После отключения система перестанет отправлять новые диагностические логи разработчикам.
Важно: отключение этой настройки не отключает создание логов на сервере.
Файлы в папке `storage/logs` продолжат создаваться локально, если в системе возникают ошибки.
### Важное замечание по безопасности
Система очищает чувствительные данные перед отправкой.
Но всё равно не рекомендуется выводить в логи:
* пароли;
* seed-фразы;
* приватные ключи;
* полные реквизиты;
* секретные токены;
* полные данные карт.
Диагностические логи предназначены только для технического анализа и помощи в поддержке продукта.
### Если отправка не работает
Проверьте:
* включена ли настройка в админке;
* работает ли CRON на сервере;
* есть ли файлы в `storage/logs`;
* не пустые ли эти файлы;
* не превышают ли они лимит размера;
* указан ли лицензионный ключ;
* есть ли доступ сервера к интернету;
* не заблокированы ли исходящие HTTPS-запросы.
Для обычного клиента обычно достаточно проверить:
* включена ли настройка;
* работает ли CRON.
Остальные пункты может проверить технический специалист или поддержка хостинга.
### Частые вопросы
Логи отправляются сразу после ошибки?
Нет.
Отправка выполняется по расписанию, обычно примерно раз в час.
Отправляется ли база данных?
Нет.
База данных не отправляется.
Отправляются ли заявки и пользователи?
Нет.
Отдельно заявки, пользователи и документы не отправляются.
Можно ли отключить отправку?
Да.
Настройку можно выключить в блоке «Диагностика».
Логи продолжат создаваться после отключения?
Да.
Отключение этой настройки останавливает только отправку логов в iEXExchanger.
Локальное создание логов на сервере продолжит работать.
### Коротко
Отправка диагностических логов помогает быстрее разбирать технические ошибки.
Система берёт файлы из: **storage/logs**
очищает чувствительные данные и отправляет разработчикам iEXExchanger по расписанию.
Настройку можно включить или отключить в разделе: **«Настройки» — «Общие настройки» — «Основное» — «Диагностика»**
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.iexexchanger.com/help-center/reshenie-problem/diagnostika/otpravka-diagnosticheskikh-logov-v-iexexchanger.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.