For the complete documentation index, see llms.txt. This page is also available as Markdown.

Отправка диагностических логов в iEXExchanger

Эта настройка позволяет автоматически отправлять очищенные диагностические логи разработчикам iEXExchanger.

Она нужна, чтобы быстрее находить причины технических проблем и помогать клиенту без долгого ручного поиска файлов на сервере.

Диагностические логи могут помочь при разборе:

  • ошибок на сайте;

  • проблем с мерчантами;

  • ошибок автоматических выплат;

  • проблем с курсами и парсерами;

  • ошибок после обновления;

  • сбоев очередей;

  • проблем с фоновыми задачами;

  • ошибок лицензии;

  • проблем с системной конфигурацией.

Где находится настройка

Откройте панель управления: «Настройки» — «Общие настройки» — «Основное»

Найдите блок: Диагностика

В этом блоке находится параметр: Отправлять диагностические логи в iEXExchanger

Что делает настройка

Если настройка включена, система периодически проверяет файлы ошибок в папке:

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

Отправка выполняется не сразу в момент ошибки, а отложенно — через системное расписание.

По умолчанию проверка запускается примерно один раз в час.

Что значит «отложенно»

Отложенная отправка означает, что система не отправляет лог при каждой ошибке мгновенно.

Сначала Laravel записывает ошибку в файл лога.

Затем по расписанию система проверяет папку storage/logs, выбирает подходящие файлы и отправляет очищенные копии.

Такой подход снижает нагрузку на сайт и не мешает пользователям работать с обменником.

Для чего это нужно

Без логов поддержке часто приходится просить клиента вручную подключаться к серверу, искать файлы и отправлять их отдельно.

Эта настройка упрощает диагностику.

Система сама отправляет технические данные, которые помогают быстрее понять:

  • где возникла ошибка;

  • какой модуль вызвал проблему;

  • связана ли ошибка с обновлением;

  • есть ли проблема с мерчантом;

  • есть ли сбой в очередях;

  • есть ли проблема с конфигурацией сервера или приложения.

Какие файлы отправляются

Система проверяет файлы внутри папки:

К отправке допускаются только читаемые файлы с расширениями:

Пустые файлы не отправляются.

Слишком большие файлы также не отправляются.

По умолчанию максимальный размер одного файла: 20 MB

За один запуск система отправляет ограниченное количество файлов.

По умолчанию: до 5 файлов за один запуск

Какие данные очищаются перед отправкой

Перед отправкой каждый лог проходит очистку.

Система маскирует чувствительные данные, если они встречаются в логах.

Например:

  • пароли;

  • токены;

  • API-ключи;

  • приватные ключи;

  • license key;

  • cookies;

  • authorization-заголовки;

  • данные банковских карт;

  • PAN;

  • CVV;

  • seed-фразы;

  • mnemonic-фразы;

  • e-mail адреса;

  • длинные числовые последовательности, похожие на чувствительные данные.

После очистки вместо таких значений в файле остаются безопасные метки.

Например:

Что не отправляется

Эта настройка не отправляет всю базу данных сайта.

Также отдельно не отправляются:

  • пользователи;

  • заявки;

  • документы;

  • реквизиты из базы данных;

  • настройки мерчантов;

  • ключи из админки;

  • файлы сайта вне storage/logs;

  • изображения;

  • архивы;

  • пользовательские документы.

Отправляются только лог-файлы, которые уже были созданы системой в storage/logs, и только после очистки.

Как работает отправка

Процесс выглядит так:

  1. На сайте возникает ошибка или техническое событие.

  2. Laravel записывает информацию в storage/logs.

  3. По расписанию запускается отправка диагностических логов.

  4. Система выбирает подходящие файлы.

  5. Перед отправкой создаётся временная очищенная копия файла.

  6. Очищенная копия отправляется разработчикам iEXExchanger.

  7. После успешной отправки система запоминает файл и его контрольную сумму.

  8. Тот же самый файл повторно не отправляется, если он не изменился.

Если файл изменился, система может отправить его повторно уже с новым содержимым.

Что нужно для работы

Для корректной отправки должны выполняться условия:

  • настройка включена в админке;

  • на сервере работает Laravel CRON;

  • указан лицензионный ключ продукта;

  • сервер имеет доступ к интернету;

  • endpoint iEXExchanger доступен;

  • файл лога читается системой;

  • размер файла не превышает лимит.

Если CRON на сервере не настроен, автоматическая отправка по расписанию работать не будет.

Как отключить отправку

Чтобы отключить отправку диагностических логов:

  1. Откройте:

  1. Перейдите к блоку:

  1. Выключите параметр:

  1. Сохраните настройки.

После отключения система перестанет отправлять новые диагностические логи разработчикам.

Важно: отключение этой настройки не отключает создание логов на сервере.

Файлы в папке storage/logs продолжат создаваться локально, если в системе возникают ошибки.

Важное замечание по безопасности

Система очищает чувствительные данные перед отправкой.

Но всё равно не рекомендуется выводить в логи:

  • пароли;

  • seed-фразы;

  • приватные ключи;

  • полные реквизиты;

  • секретные токены;

  • полные данные карт.

Диагностические логи предназначены только для технического анализа и помощи в поддержке продукта.

Если отправка не работает

Проверьте:

  • включена ли настройка в админке;

  • работает ли CRON на сервере;

  • есть ли файлы в storage/logs;

  • не пустые ли эти файлы;

  • не превышают ли они лимит размера;

  • указан ли лицензионный ключ;

  • есть ли доступ сервера к интернету;

  • не заблокированы ли исходящие HTTPS-запросы.

Для обычного клиента обычно достаточно проверить:

  • включена ли настройка;

  • работает ли CRON.

Остальные пункты может проверить технический специалист или поддержка хостинга.

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

Логи отправляются сразу после ошибки?

Нет.

Отправка выполняется по расписанию, обычно примерно раз в час.

Отправляется ли база данных?

Нет.

База данных не отправляется.

Отправляются ли заявки и пользователи?

Нет.

Отдельно заявки, пользователи и документы не отправляются.

Можно ли отключить отправку?

Да.

Настройку можно выключить в блоке «Диагностика».

Логи продолжат создаваться после отключения?

Да.

Отключение этой настройки останавливает только отправку логов в iEXExchanger.

Локальное создание логов на сервере продолжит работать.

Коротко

Отправка диагностических логов помогает быстрее разбирать технические ошибки.

Система берёт файлы из: storage/logs

очищает чувствительные данные и отправляет разработчикам iEXExchanger по расписанию.

Настройку можно включить или отключить в разделе: «Настройки» — «Общие настройки» — «Основное» — «Диагностика»

Последнее обновление

Это было полезно?