Exchange — диагностика синхронизации пользователя

Руководство для поддержки по разбору инцидентов синхронизации с Exchange на уровне пользователя: ошибки доступа к папкам и почтовому ящику, «самопроизвольное» отключение синхронизации, рост счётчика неудачных попыток. Документ описывает устройство механизма (режимы, счётчик ошибок, классификация ошибок, автоматическое восстановление), чек-лист разбора, таблицу «симптом → вероятная причина → что проверить», готовые SQL-запросы и список того, что приложить при обращении в поддержку 1Ф.

1. Когда использовать и что приложить при обращении в поддержку 1Ф

Признаки инцидента, при которых применяется это руководство:

1. Ошибки ErrorFolderNotFound/ErrorInvalidFolderId/ErrorNonExistentMailbox.
2. Синхронизация пользователя «самопроизвольно» отключилась.
3. Растёт счётчик неудачных попыток Exchange.
4. Встречи не появляются/не обновляются у конкретного пользователя.

Что приложить при обращении в поддержку 1Ф:

1. userId, время ошибки, точный ServiceError.
2. Снимок GET /api/admin/users/{userId}/service/settings.
3. Результаты SQL-запросов из раздела 5.
4. Что уже делали: reset-fails, смена режима (update-sync-mode), повтор синхронизации.
5. Масштаб: один пользователь или массово.

2. Как это работает

2.1 Режимы пользователя и счётчик ошибок с автоотключением

Режим определяется парой флагов пользователя:

1. Disabled → DoSyncWithExchange = false и CalendarEwsDirectSync = false.
2. Sync → DoSyncWithExchange = true и CalendarEwsDirectSync = false.
3. Direct → DoSyncWithExchange = false и CalendarEwsDirectSync = true.

Admin API для управления:

• POST /api/admin/users/{userId}/exchange/reset-fails
• POST /api/admin/users/{userId}/exchange/update-sync-mode
• GET /api/admin/users/{userId}/service/settings (для контроля текущего режима/счётчиков)

Механика счётчика ошибок и автоотключения:

1. Ошибки Exchange увеличивают SyncWithExchangeFailedAttempts.
2. Лимит берётся из CalendarExchangeRetryLimit.
3. Если лимит != 0 и попытки > limit, режим пользователя переводится в Disabled.
4. reset-fails сбрасывает счётчик в 0, но сам режим при необходимости надо выставить отдельно.

2.2 Обработка типовых ошибок Exchange и восстановительный контур

Система обрабатывает два класса ошибок Exchange:

1. AccessDenied:
2. очищаются EwsFolders/EwsFolderPermissions для текущего пользователя,
3. увеличивается счётчик ошибок.
4. Ошибки «плохой пользователь/ящик»:
5. ErrorNonExistentMailbox, ErrorFolderNotFound, ErrorInvalidFolderId, ErrorInvalidSmtpAddress, ErrorMailRecipientNotFound, ErrorItemNotFound,
6. при наличии SmtpAddress в деталях могут отключаться пользователи с этим email,
7. иначе увеличивается счётчик ошибок по пользователю.

Автоматическое восстановление: фоновая задача EnableDoSyncWithExchangeJob может повторно включить синхронизацию пользователям, отключённым именно «по ошибке Exchange» (служебный флаг Sync.Exchange.DisabledByError).

3. Что смотреть при разборе (чек-лист)

При разборе инцидента пройдите по шагам:

1. Зафиксировать userId, время ошибки, текст ServiceError.
2. Проверить сервисные настройки пользователя (service/settings):
3. ewsMode,
4. syncWithExchangeFailedAttempts,
5. calendarExchangeRetryLimit,
6. sid.
7. Если попытки выше лимита:
8. сбросить fails,
9. вернуть нужный режим синхронизации вручную.
10. Проверить, какой класс ошибки:
11. AccessDenied → проверка доступа, перевоплощения и кэша папок,
12. ошибки ящика/папки → проверка email, папки и почтового ящика календаря.
13. Для AccessDenied убедиться, что после очистки кэша папок и повторной попытки состояние изменилось.
14. Если проблема массовая (несколько пользователей) — проверять Exchange service settings и инфраструктурную доступность EWS.

4. Симптом → вероятная причина → проверка

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

Симптом	Вероятная причина	Что проверить первым
У пользователя ewsMode = Disabled после серии ошибок	превышен лимит повторов	syncWithExchangeFailedAttempts vs calendarExchangeRetryLimit
ErrorAccessDenied	права/перевоплощение/доступ к папке	записи EwsFolders/EwsFolderPermissions, параметры перевоплощения
ErrorNonExistentMailbox/ErrorInvalidSmtpAddress	некорректный email/mailbox	Users.Email, детали SmtpAddress в логе
ErrorFolderNotFound/ErrorInvalidFolderId	невалидный folder link/изменение папки в Exchange	повторная инициализация папок, проверки кэша папок
После reset-fails ситуация не изменилась	сбросили только счётчик, но не режим	текущий ewsMode и update-sync-mode
Событие создано в Outlook, комментарий в задачу не приходит, нет записей в AutomationScriptsLog (Type=10)	Settings.DefaultEwsServiceId = NULL и нет AD-профилей, привязанных к EWS → список EWS-сервисов пуст → подписки не стартовали (тихий отказ без лога)	SELECT DefaultEwsServiceId FROM Settings; проверить EwsServiceSettings; подробнее — Провайдер Exchange (EWS), раздел «Как определяется список EWS-сервисов»

5. SQL для быстрой диагностики

Запросы для быстрой проверки состояния синхронизации пользователя:

declare @user_id int = 0;

-- Состояние пользователя по Exchange
select
        u.UserID,
        u.Email,
        u.DoSyncWithExchange,
        u.CalendarEwsDirectSync,
        u.SyncWithExchangeFailedAttempts,
        u.SID
from dbo.Users u
where u.UserID = @user_id;

-- Служебные флаги Exchange по пользователю
select
        uiev.UserID,
        uie.SysName,
        uiev.Value,
        uiev.IntValue
from dbo.UserInfoExtValues uiev
join dbo.UserInfoExt uie
        on uie.ID = uiev.InfoExtID
where uiev.UserID = @user_id and
      lower(uie.SysName) in (
            'sync.exchange.disablederror',
            'sync.exchange.itemsstate'
      )
order by
        uie.SysName;

-- Кеш папок Exchange для пользователя
select top (200)
        ef.UserID,
        ef.ServiceId,
        ef.ChangeDate,
        ef.CalendarFolderValue,
        ef.InboxFolderValue
from dbo.EwsFolders ef
where ef.UserID = @user_id
order by
        ef.ChangeDate desc;

-- Кеш прав на папки Exchange
select top (200)
        ep.UserID,
        ep.FolderOwnerId,
        ep.ServiceId,
        ep.ChangeDate,
        ep.FolderValue
from dbo.EwsFolderPermissions ep
where ep.UserID = @user_id
order by
        ep.ChangeDate desc;

-- Настройки сервиса Exchange (без пароля)
select
        ess.ServiceId,
        ess.EwsUrl,
        ess.EwsLogin,
        ess.EwsDomain,
        ess.UseImpersonalization,
        ess.UseSIDForImpersonalization
from dbo.EwsServiceSettings ess
order by
        ess.ServiceId;

Связанные документы:

• Календарь — администрирование
• Провайдер Exchange (EWS)
• Интеграция с Exchange — обзор