Solucionar problemas com o SDK dos conectores do Microsoft Graph

Este artigo descreve alguns dos problemas mais comuns com o SDK dos conectores do Microsoft Graph e como solucionar problemas.

Itens ausentes do índice

Se os itens existentes anteriormente estiverem ausentes do índice, isso pode ser devido à lógica de detecção de exclusão na plataforma. Os itens ausentes de uma resposta de sucesso no OperationStatus que já estão no índice serão removidos do índice.

Se o conector enviar respostas de falha transitórias e mais de 10% dos itens resultarem em falhas de rastreamento, itens que não estão incluídos nos dois últimos rastreamentos serão excluídos.

Manipular alterações na porta do conector

Quando o conector precisa ser executado em uma porta diferente, você precisa atualizar o arquivo de configuração do mapa de porta com os novos valores. Ao editar o arquivo de configuração do mapa de porta, você deve reiniciar o serviço GCA para que as alterações entrem em vigor. Para reiniciar o serviço, abra services.msc e reinicie o GcaHostService.

Falha de conexão após a atualização do GCA

Se você notar falhas de conexão após a atualização de uma versão GCA 1.8.0.0 ou inferior, siga as seguintes etapas:

1. Abra o painel controle GCA. Em Programas e recursos, selecione Agente conector do Graph na lista de programas e escolha Reparar.
2. Atualize a nova configuração de arquivo de mapa de porta com as configurações anteriores.
3. Retome todas as conexões com falha de Centro de administração do Microsoft 365.

O serviço conector não está disponível

Se os rastreamentos estiverem falhando com um conector indisponível no erro de porta especificado, verifique o seguinte:

1. O conector está realmente em execução na porta especificada e não falhou e não está preso.
2. A porta especificada no arquivo de configuração do mapa da porta está correta.
3. Se o arquivo de configuração do mapa de porta tiver sido editado, reinicie o GcaHostService.

Manipular erros de RPC

Se você vir erros de RPC durante a comunicação entre a plataforma do agente conector do Microsoft Graph e o conector, você poderá pesquisar os códigos de erro na página status códigos.

Se o código de erro for Desconhecido, provavelmente haverá uma exceção sem tratamento no código do conector. Certifique-se de enviar uma resposta com status de operação de êxito/falha em todos os casos.

Localizando o arquivo de log para seu conector personalizado

Se você estiver usando o GraphConnectorsTemplate para desenvolver seu conector personalizado, a pasta AppData da conta de usuário atual será usada para armazenar logs por padrão. Você também pode fornecer um caminho absoluto para armazenar logs no arquivo ConnectorServer.cs do modelo. A conta de usuário deve ter acesso ao caminho absoluto fornecido.

A seguir estão os locais do caminho de log, dependendo do caso de uso:

• Conector não hospedado como um serviço windows:

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

• Conector hospedado como um serviço Windows na conta DO SISTEMA LOCAL:

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

• Conector hospedado como um serviço Windows na conta virtual:

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

• Conector hospedado como um serviço Windows na conta DO SISTEMA LOCAL:

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

Erros ao hospedar um conector como um serviço windows

Falha no início do serviço devido ao erro negado de acesso

Use as etapas a seguir para garantir que o caminho do executável esteja acessível à conta localService.

1. Clique com o botão direito do mouse na pasta que contém o executável e escolha Propriedades.

2. Abra a guia Segurança e, em Grupo ou nomes de usuário, escolha Editar.

3. Escolha Adicionar.

4. Insira 'SERVIÇO LOCAL' como o nome do objeto e escolha Verificar Nomes.

   

5. Escolha OK em cada caixa de diálogo.

O serviço falha ao iniciar com qualquer erro

Se o serviço não for iniciado, marcar os logs de erro do visualizador de eventos. Abra o visualizador de eventos e acesse Windows logs Sistema de logs >>de aplicativos e windows.

Mais ajuda

Se você precisar de mais ajuda para solucionar um problema, pode levantar um problema ou iniciar uma discussão sobre tópicos relevantes por meio do nosso repositório GitHub.

Você também pode entrar em contato com a equipe do Microsoft Graph Connectors para obter mais ajuda e solução de problemas.

Conteúdo relacionado

• Práticas recomendadas