Когда задание GoodSync подключается к Microsoft OneDrive, Office 365 или SharePoint, Microsoft может временно ограничить количество обрабатываемых запросов. Это называется ограничением частоты запросов или троттлингом.
Троттлингом управляет Microsoft: он защищает службы Microsoft 365 от чрезмерной активности. Обычно он не означает, что есть проблема с вашей лицензией GoodSync, паролем аккаунта или настройками задания.
Сообщение об ошибке
Может появиться ошибка, похожая на следующую:
Rate Limit, Throttled by Microsoft (retry-after:5): Server says: Too Many Requests (status code 429) [activityLimitReached] The request has been throttled
Также может появиться одна из связанных ошибок Microsoft:
- 429 Too Many Requests: Microsoft получила больше запросов, чем допускает в данный момент.
- 503 Service Unavailable или Server Too Busy: служба Microsoft временно перегружена, недоступна или продолжает ограничивать запросы.
Что означает эта ошибка
Microsoft применяет лимиты использования к запросам пользователей, приложений и тенантов Microsoft 365. Троттлинг может возникать, когда задание обрабатывает большое количество файлов, отправляет много запросов за короткое время или выполняется одновременно с другими приложениями, использующими тот же аккаунт или тенант Microsoft.
Значение retry-after возвращает Microsoft; оно показывает, сколько секунд приложение должно подождать перед следующим запросом. Например, retry-after:5 означает, что Microsoft просит подождать не менее пяти секунд перед повторной попыткой.
Если запросы продолжаются, пока действует ограничение Microsoft, период троттлинга может быть продлен. Постоянная или чрезмерная активность может также приводить к повторяющимся ответам 503.
Рекомендуемые действия
1. Дайте GoodSync больше времени на переподключение
Увеличение времени переподключения дает GoodSync больше времени на повторные попытки выполнить операцию, прежде чем задание будет признано неудавшимся.
- Выберите затронутое задание GoodSync.
- Нажмите Задание > Настройка задания.
- Выберите Скорость/Ограничения.
- Найдите параметр Общее время на попытки переподключения (сек.).
- Увеличьте значение выше стандартных 120 секунд. При повторяющемся троттлинге значение, например 600 секунд, даст Microsoft больше времени на снятие временного ограничения.
- Нажмите Сохранить, чтобы применить изменение.
Важно: Увеличение этого значения не повышает и не снимает лимит использования Microsoft. Оно позволяет GoodSync дольше продолжать попытки переподключения, прежде чем задание завершится с ошибкой.
Подробнее см. Общее время на попытки переподключения (сек.).
2. Уменьшите количество параллельных потоков
Несколько параллельных потоков отправляют в Microsoft больше одновременных запросов. Уменьшение числа потоков снижает объем запросов и помогает избежать повторного троттлинга.
- Выберите затронутое задание GoodSync.
- Нажмите Задание > Настройка задания.
- Выберите Скорость/Ограничения.
- Найдите параметр Количество параллельных потоков при синхронизации.
- Уменьшите текущее значение. Если троттлинг продолжается, задайте для задания 1 поток или отключите этот параметр, чтобы синхронизация выполнялась последовательно.
- Нажмите Сохранить, чтобы применить изменение.
Примечание: При меньшем числе параллельных потоков задание может выполняться дольше, зато уменьшается количество одновременных запросов к Microsoft.
Подробнее см. Количество параллельных потоков при синхронизации.
3. Разделите большие наборы данных и разнесите расписания заданий
Если одно задание обрабатывает очень большой набор данных, разделите данные между несколькими заданиями GoodSync с отдельными, непересекающимися папками. Запланируйте запуск каждого задания на свое время, чтобы по возможности к аккаунту или тенанту Microsoft в каждый момент активно обращалось только одно задание.
Важно: Не запускайте все эти меньшие задания одновременно. Одновременно работающие задания могут увеличить активность Microsoft API и вызвать дополнительный троттлинг.
4. Запускайте большие задания в часы наименьшей нагрузки
Планируйте крупные операции анализа и синхронизации на ночь или выходные по времени региона, в котором размещен ваш тенант Microsoft 365. По данным Microsoft, троттлинг и снижение производительности более вероятны в периоды пиковой нагрузки.
5. Сократите конкурирующую активность в Microsoft 365
Другие задания GoodSync, клиент синхронизации Microsoft OneDrive, средства миграции, приложения резервного копирования, проверки безопасности и другие службы могут расходовать лимиты того же аккаунта или тенанта Microsoft. По возможности приостановите эти процессы или перенесите их на другое время, чтобы они не пересекались с затронутым заданием GoodSync.
Что делать, пока действует троттлинг задания
- Дайте GoodSync время повторить запрос.
-
Не следует многократно останавливать задание и сразу же запускать его снова.
- Дополнительные запросы могут продлить период троттлинга.
- Если задание завершилось с ошибкой после того, как время переподключения истекло, подождите, прежде чем запускать его снова.
- Перед следующей попыткой уменьшите число потоков и разнесите расписание.
Если ошибка повторяется
Если ошибки 429 или 503 продолжаются после описанных выше изменений:
- Задайте для затронутого задания один поток синхронизации.
- Временно остановите другие задания и приложения, обращающиеся к тому же аккаунту или тенанту Microsoft.
- Запустите задание снова в часы наименьшей нагрузки.
- Попросите администратора Microsoft 365 проверить на странице Service health и в Message center, нет ли инцидентов в службах Microsoft или уведомлений об ограничении активности приложений.
- Если помощь все еще нужна, откройте GoodSync и выберите Помощь > Сообщить об ошибке. Приложите журналы затронутого задания и укажите примерное время, когда возник троттлинг.
GoodSync не может снять или увеличить лимит частоты запросов, установленный Microsoft. Однако служба поддержки GoodSync может изучить настройки задания и журналы, чтобы помочь снизить частоту запросов и улучшить поведение при повторных попытках.