Устранение неполадок с пакетом SDK соединителей Microsoft Graph

В этой статье описаны некоторые из наиболее распространенных проблем с пакетом SDK соединителей Microsoft Graph и способы их устранения.

Элементы, отсутствующие в индексе

Если в индексе отсутствуют ранее существующие элементы, это может быть связано с логикой обнаружения удаления на платформе. Элементы, отсутствующие в успешном ответе в OperationStatus , которые уже находятся в индексе, будут удалены из индекса.

Если соединитель отправляет временные ответы на сбои, и более 10 % элементов привели к сбою обхода контента, элементы, которые не включены в последние два обхода контента, будут удалены.

Обработка изменений портов соединителя

Если соединитель должен работать на другом порту, необходимо обновить файл конфигурации карты портов новыми значениями. При изменении файла конфигурации карты портов необходимо перезапустить службу GCA, чтобы изменения вступили в силу. Чтобы перезапустить службу, откройте services.msc и перезапустите GcaHostService.

Сбой подключения после обновления GCA

Если вы заметили сбои подключения после обновления с GCA версии 1.8.0.0 или более поздней, выполните следующие действия.

1. Откройте панель управления GCA. В разделе Программы и компоненты выберите агент соединителя Graph в списке программ и нажмите кнопку Восстановить.
2. Обновите новую конфигурацию файла карты портов с помощью предыдущих конфигураций.
3. Возобновление всех неудачных подключений из Центр администрирования Microsoft 365.

Служба соединителя недоступна

Если обход контента завершается сбоем с ошибкой соединителя, недоступного при указанном порте, проверьте следующее:

1. Соединитель действительно работает на указанном порту и не аварийно завершает работу и не зависает.
2. Порт, указанный в файле конфигурации карты портов, является правильным.
3. Если файл конфигурации карты портов был изменен, обязательно перезапустите GcaHostService.

Обработка ошибок RPC

Если во время обмена данными между платформой агента соединителя Microsoft Graph и соединителем отображаются ошибки RPC, можно найти коды ошибок на странице кодов состояния .

Если в коде ошибки указано неизвестно, скорее всего, в коде соединителя есть необработанное исключение. Во всех случаях убедитесь, что вы отправляете ответ с состоянием успешной или неудачной операции.

Поиск файла журнала для пользовательского соединителя

Если вы используете GraphConnectorsTemplate для разработки пользовательского соединителя, папка AppData текущей учетной записи пользователя по умолчанию используется для хранения журналов. Вы также можете указать абсолютный путь для хранения журналов в ConnectorServer.cs файле шаблона. Учетная запись пользователя должна иметь доступ к указанному вами абсолютному пути.

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

• Соединитель, не размещенный в качестве службы Windows:

  C:\Users\{User Account}\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log
  

• Соединитель, размещенный в качестве службы Windows в учетной записи LOCAL SYSTEM:

  C:\Windows\system32\config\systemprofile\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log
  

• Соединитель, размещенный как служба Windows в виртуальной учетной записи:

  C:\Windows\ServiceProfiles\{Network Service Name}\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log
  

• Соединитель, размещенный в качестве службы Windows в учетной записи LOCAL SYSTEM:

  C:\Windows\ServiceProfiles\LocalService\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log
  

Примечание.

• GraphConnectorsTemplate версии 2.1 и более поздних версий поддерживает хранение журналов для соединителей, размещенных в качестве службы Windows.
• Убедитесь, что в файле ConnectorServer.cs указано уникальное имя соединителя, чтобы журналы для каждого уникального соединителя хранились отдельно.

Ошибки при размещении соединителя в качестве службы Windows

Не удалось запустить службу из-за ошибки "Отказано в доступе"

Выполните следующие действия, чтобы убедиться, что путь к исполняемому файлу доступен для учетной записи LocalService.

1. Щелкните правой кнопкой мыши папку, содержащую исполняемый файл, и выберите пункт Свойства.

2. Откройте вкладку Безопасность и в разделе Имена групп или пользователей выберите Изменить.

3. Нажмите кнопку Добавить.

4. Введите LOCAL SERVICE в качестве имени объекта и выберите Проверить имена.

   

5. В каждом диалоговом окне нажмите кнопку ОК .

Служба не запускается с какой-либо ошибкой

Если служба не запускается, проверка журналы ошибок средства просмотра событий. Откройте средство просмотра событий и перейдите в раздел Журналы > Windows Приложение и Система журналов > Windows.

Дополнительная справка

Если вам нужна дополнительная помощь по устранению проблемы, вы можете поднять проблему или начать обсуждение по соответствующим темам в нашем репозитории GitHub.

Вы также можете обратиться к команде соединителей Microsoft Graph для получения дополнительной помощи и устранения неполадок.

Связанные материалы

• Рекомендации