> 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/guide/nastroiki/ochistki-logov.md). # Очистки логов Раздел «Настройки очистки логов и истории» используется для автоматического удаления старых служебных записей: логов заявок, истории резервов, истории курсов, событий авторизации, логов экспорта и других накопительных данных. Со временем такие данные могут занимать много места в базе данных. Автоочистка помогает хранить только актуальную историю и не раздувать базу лишними записями. ## Где находится раздел В панели управления откройте: **«Настройки» — «Общие настройки» — «Дополнительно» — «Настройки логов»**
## Для чего нужна очистка логов В процессе работы обменника система сохраняет служебную историю. Например: * когда менялись статусы заявок; * какие события происходили с автовыплатами; * какие были партнёрские переходы; * какие карты не прошли верификацию; * как менялись резервы; * как менялись курсы; * какие события авторизации происходили в панели управления; * как выполнялся экспорт курсов. Эти данные полезны для контроля, аналитики и диагностики. Но если хранить их бессрочно, база данных будет постепенно расти. Автоочистка позволяет заранее задать срок хранения и автоматически удалять старые записи. ## Как работает автоочистка Система запускает очистку автоматически по расписанию. По текущей логике проекта очистка запускается ежедневно примерно в: ``` 02:00 ``` по серверному времени. Чтобы автоочистка действительно выполнялась, на сервере должен быть настроен планировщик задач CRON. Если CRON не работает, настройки будут сохраняться, но автоматическое удаление запускаться не будет. *** ## Общая автоочистка Первый параметр на странице: **«Общая автоочистка»** Это главный переключатель всего модуля. Если «Общая автоочистка» включена, система будет проверять включённые ниже разделы и удалять старые записи по их правилам. Если «Общая автоочистка» выключена, очистка не будет выполняться вообще, даже если отдельные разделы ниже включены. При этом настройки отдельных разделов сохраняются. Можно заранее настроить сроки хранения, выключить общую автоочистку, а позже снова включить её — параметры останутся на месте. ## Настройки внутри каждого раздела Для каждого раздела очистки используются одинаковые параметры:
ПараметрЧто означает
Статус разделаВключена ли очистка конкретного раздела
Срок храненияКак долго хранить записи
Единица срокаВ чём считается срок: дни или месяцы
Защитный буфер, днейДополнительный запас времени перед удалением
{% stepper %} {% step %} ### Статус раздела Параметр «Статус раздела» показывает, включена ли очистка конкретного типа данных. Если раздел включён, система будет удалять старые записи этого типа. Если раздел выключен, записи этого типа не будут удаляться, даже если «Общая автоочистка» включена. {% endstep %} {% step %} ### Срок хранения Поле «Срок хранения» определяет, сколько времени система должна хранить записи. Например: ``` 30 ``` Само число работает вместе с полем «Единица срока». Если выбраны «Дни», значение `30` означает: ``` 30 дней ``` Если выбраны «Месяцы», значение `3` означает: ``` 3 месяца ``` Для включённого раздела срок хранения должен быть больше `0`. {% endstep %} {% step %} ### Единица срока Поле «Единица срока» определяет, в чём считается срок хранения. Доступны варианты: * Дни; * Месяцы. Примеры: ``` 30 дней ``` ``` 6 месяцев ``` Для большинства технических логов удобно использовать дни. Для более важной истории, например резервов, курсов или событий авторизации, часто удобнее указывать месяцы. {% endstep %} {% step %} ### Защитный буфер Поле «Защитный буфер, дней» добавляет дополнительный запас времени перед удалением. Система берёт основной срок хранения и прибавляет к нему буфер. Пример: ``` Срок хранения: 30 дней Защитный буфер: 7 дней ``` В этом случае записи будут удаляться не сразу после 30 дней, а после 37 дней. Буфер полезен, чтобы случайно не удалить данные слишком рано. {% endstep %} {% endstepper %} *** ## Пример расчёта удаления Допустим, сегодня: ``` 1 августа ``` Настройка раздела: ``` Срок хранения: 30 дней Защитный буфер: 5 дней ``` Система будет удалять записи, которые старше: ``` 35 дней ``` То есть запись от 20 июня уже может попасть под очистку, а запись от 10 июля ещё останется. ## Какие разделы можно очищать На странице доступны отдельные блоки очистки: * Логи статусов заявок; * Логи автоплатежей; * Логи партнёрских переходов; * Не верифицированные карты; * История резервов; * История логов курсов; * История свечей курсов; * События аудита авторизации; * Логи экспорта курсов. ## Логи статусов заявок Раздел: **«Логи статусов заявок»** Удаляет старые записи о смене статусов заявок. В таких логах может храниться информация о том: * когда заявка перешла в новый статус; * какой статус был раньше; * какой статус стал новым; * кто или что изменило статус; * из какого места произошло изменение: сайт, админка, мерчант или система. Эта история полезна для разбора заявок и контроля действий. Рекомендуемый срок хранения: ``` 3–6 месяцев ``` Если вы часто разбираете спорные заявки, лучше хранить дольше. ## Логи автоплатежей Раздел: **«Логи автоплатежей»** Удаляет старые служебные записи, связанные с автоматическими платежами и автовыплатами. Такие логи могут использоваться для диагностики: * успешных автоматических операций; * ошибок платёжных модулей; * повторных попыток; * технических ответов от платёжных систем. {% hint style="info" %} Если в вашей сборке модуль логов автоплатежей не подключён или недоступен, система может пропустить этот раздел при очистке. Это не является ошибкой пользовательской настройки. {% endhint %} Рекомендуемый срок хранения: ``` 3–6 месяцев ``` Для активных обменников с большим количеством автовыплат лучше не ставить слишком маленький срок. ## Логи партнёрских переходов Раздел: **«Логи партнёрских переходов»** Удаляет старую историю партнёрских переходов. Эти данные относятся к переходам пользователей по партнёрским ссылкам и могут использоваться для анализа партнёрского трафика. Рекомендуемый срок хранения: ``` 6–12 месяцев ``` Если вы активно анализируете партнёров, храните историю дольше. ## Не верифицированные карты Раздел: **«Не верифицированные карты»** Автоматически удаляет старые карты, которые не прошли верификацию. Очистка касается только не верифицированных карт. Подтверждённые карты не должны удаляться этим правилом. Этот раздел полезен, если пользователи часто загружают карты, но не завершают проверку. Рекомендуемый срок хранения: ``` 30–90 дней ``` Если у вас строгий процесс верификации, срок можно увеличить. ## История резервов Раздел: **«История резервов»** Удаляет старую историю изменений резервов. История резервов помогает понять: * когда менялся резерв; * на какую сумму он изменился; * по какой причине произошло изменение; * к какой валюте или направлению относилось изменение. Эта история полезна для контроля балансов и внутренних проверок. Рекомендуемый срок хранения: ``` 6–12 месяцев ``` Если вы используете историю резервов для финансового контроля, не ставьте слишком маленький срок. ## История логов курсов Раздел: **«История логов курсов»** Удаляет старые подробные записи об изменении курсов. Эти записи появляются, когда включена история изменений курсов в разделе: **«Настройки» — «Общие настройки» — «Курсы и расчёты» — «Парсер курсов»** {% content-ref url="/pages/SELlj3odw1QOvdZS0fVm" %} [Настройки парсера курсов](/guide/nastroiki/obshie/nastroiki-parsera-kursov.md) {% endcontent-ref %} История логов курсов помогает видеть: * старое значение курса; * новое значение курса; * источник изменения; * дату изменения; * динамику курса по конкретной паре. Рекомендуемый срок хранения: ``` 3–6 месяцев ``` Если курсы обновляются часто и направлений много, история может быстро расти. В таком случае срок хранения лучше настроить заранее. ## История свечей курсов Раздел: **«История свечей курсов»** Удаляет старые агрегированные данные истории курсов. Свечи курсов — это подготовленная история для графиков и аналитики. Они обычно компактнее, чем подробные логи, и помогают быстрее строить отчёты по изменению курсов. Разница:
Тип историиЧто означает
История логов курсовПодробные записи каждого изменения
История свечей курсовАгрегированные данные для аналитики и графиков
Рекомендуемый срок хранения: ``` 6–12 месяцев ``` Обычно свечи можно хранить дольше, чем подробные логи, потому что они легче и полезны для общей аналитики. ## События аудита авторизации Раздел: **«События аудита авторизации»** Удаляет старые события входа и авторизации в панели управления. В таких событиях может храниться информация о: * входах в панель управления; * ошибках входа; * проверках двухфакторной авторизации; * смене IP; * устройстве и браузере; * результате авторизации. Этот раздел важен для безопасности. Рекомендуемый срок хранения: ``` 6–12 месяцев ``` Не рекомендуется ставить слишком короткий срок, потому что история авторизации может понадобиться при разборе подозрительных входов. ## Логи экспорта курсов Раздел: **«Логи экспорта курсов»** Удаляет старые записи журнала экспорта курсов. Эти логи помогают понимать: * когда запускался экспорт; * успешно ли сформировался файл; * сколько направлений было экспортировано; * были ли ошибки; * какие направления были пропущены; * были ли подозрительно маленькие выгрузки. {% hint style="warning" %} Очистку логов экспорта курсов не рекомендуется включать без необходимости. Эти записи помогают контролировать стабильность автоматического экспорта. {% endhint %} Если очистка всё же нужна, лучше указывать срок хранения не меньше: ``` 3 месяца ``` ## Как настроить автоочистку 1. Откройте панель управления. 2. Перейдите в **«Настройки» — «Общие настройки» — «Дополнительно» — «Настройки логов».** 3. Включите «Общая автоочистка». 4. Для каждого нужного раздела включите «Статус раздела». 5. Укажите «Срок хранения». 6. Выберите «Единица срока» — дни или месяцы. 7. Укажите «Защитный буфер, дней», если хотите добавить запас перед удалением. 8. Нажмите «Сохранить». После этого система будет выполнять очистку автоматически при запуске планировщика задач. *** ## Рекомендуемая базовая настройка Для обычного обменника можно использовать такой вариант: ``` Общая автоочистка: Включено Логи статусов заявок: 6 месяцев + буфер 7 дней Логи автоплатежей: 6 месяцев + буфер 7 дней Логи партнёрских переходов: 12 месяцев + буфер 7 дней Не верифицированные карты: 90 дней + буфер 7 дней История резервов: 12 месяцев + буфер 7 дней История логов курсов: 6 месяцев + буфер 7 дней История свечей курсов: 12 месяцев + буфер 7 дней События аудита авторизации: 12 месяцев + буфер 7 дней Логи экспорта курсов: 6 месяцев + буфер 7 дней ``` Если база данных быстро растёт, сроки можно уменьшить. Если важна подробная история для проверок и аналитики, сроки лучше увеличить. *** ## Что важно учитывать Автоочистка удаляет старые данные без ручного подтверждения во время выполнения. Перед включением проверьте: * какие данные нужны для поддержки клиентов; * за какой период обычно разбираются спорные заявки; * как долго нужно хранить историю авторизаций; * нужна ли длинная история курсов; * используются ли логи экспорта курсов для диагностики; * настроен ли CRON на сервере. *** ## Почему раздел может быть выключен Если у раздела статус «Выключено», система не будет удалять его данные. Если выключена «Общая автоочистка», не будут удаляться данные ни одного раздела. ## Почему очистка не сработала Проверьте основные причины: * выключена «Общая автоочистка»; * выключен конкретный раздел; * срок хранения указан `0` или не сохранён; * CRON на сервере не настроен; * ещё нет записей старше указанного срока; * сработал защитный буфер; * очистка уже выполняется другим процессом; * конкретный раздел недоступен в текущей сборке системы. ## Почему данные не удалились сразу после сохранения Сохранение настроек не запускает удаление моментально. Очистка выполняется по расписанию. Обычно система запускает её ночью, примерно в: ``` 02:00 ``` по серверному времени. Если нужно проверить работу сразу, это обычно делает технический специалист через серверную команду. Обычному менеджеру достаточно сохранить настройки и дождаться следующего запуска CRON. ## Безопасная стратегия Если вы настраиваете автоочистку впервые, не ставьте слишком короткие сроки. Лучше начать с более мягких значений: ``` 6 месяцев 12 месяцев ``` После этого можно понаблюдать за размером базы и при необходимости постепенно уменьшить сроки хранения. ## Частые вопросы
Если выключить общую автоочистку, настройки разделов сбросятся? Нет. Настройки отдельных разделов сохранятся. После повторного включения общей автоочистки система продолжит использовать сохранённые параметры.
Старые записи удаляются сразу после включения? Нет. Очистка выполняется по расписанию. Обычно запуск происходит ночью, если работает CRON.
Можно ли оставить часть разделов выключенными? Да. Вы можете включить только те разделы, которые хотите очищать. Например, можно очищать не верифицированные карты и историю курсов, но оставить аудит авторизации на более долгий срок.
Что делать, если история нужна для разбирательств? Установите более длинный срок хранения. Для важных журналов лучше использовать месяцы и защитный буфер.
*** ## Коротко «Настройки очистки логов и истории» позволяют автоматически удалять старые служебные данные и не раздувать базу данных. Главное правило: * включите «Общая автоочистка»; * включите только нужные разделы; * задайте понятный срок хранения; * используйте защитный буфер; * не ставьте короткие сроки для важных журналов безопасности, резервов и экспорта курсов. Раздел находится здесь: **«Настройки» — «Общие настройки» — «Дополнительно» — «Настройки логов»** --- # 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/guide/nastroiki/ochistki-logov.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.