Reproduzir problemas de ficheiros com o Graph Explorer

Quando os utilizadores relatam navegação lenta, aberturas de ficheiros com falha ou outros erros de operação de ficheiros e os registos de depuração do KONNEKT mostram erros da Graph API, o Microsoft Graph Explorer permite reproduzir o pedido com falha diretamente no navegador. Isto isola se a causa raiz está no backend do Microsoft 365 ou no KONNEKT e produz provas limpas para um ticket de suporte da Microsoft.

O Microsoft Graph Explorer é uma ferramenta gratuita, baseada em navegador, da Microsoft. Envia pedidos para a API do Microsoft Graph, que é a mesma interface que o KONNEKT, a aplicação de sincronização do Microsoft OneDrive, o Microsoft Teams e o próprio Microsoft 365 usam para ler e escrever ficheiros do SharePoint Online e do OneDrive. Não é necessária instalação.

Quando utilizar este guia

Utilize este procedimento quando:

• Vários utilizadores relatam o mesmo problema ao mesmo tempo (frequentemente um sinal de um problema no backend).
• Os registos de depuração do KONNEKT mostram erros da Graph API (HTTP 429, 500, 503, 504 ou UnknownError).
• Tem de provar ao suporte da Microsoft que o problema não é causado por software de terceiros.
• A lentidão intermitente persiste depois de terem sido descartadas as verificações habituais do KONNEKT.

Recolher e inspecionar o registo de depuração

A forma normal de obter os registos do KONNEKT para o suporte é executando crashguard.exe de C:\Program Files\Konnekt. Esse fluxo empacota os registos e carrega-os silenciosamente em segundo plano - na maioria dos casos, nem o utilizador nem o administrador notam que algo está a acontecer. Veja Preparação dos logs de depuração para o fluxo de suporte padrão.

O fluxo de trabalho do Graph Explorer é diferente: tem de abrir o ficheiro de registo você mesmo, localmente, para copiar o URL do pedido com falha e request-id para o Graph Explorer. Os ficheiros de registo encontram-se em:

%LOCALAPPDATA%\Konnekt

O KONNEKT mantém até seis ficheiros de registo rotativos de cerca de 1 MB cada. Ordene por hora de modificação e comece pelo ficheiro mais recente. Abra-o num editor de texto e procure por erro ou pelo código de estado HTTP que está a investigar (por exemplo, 504).

Antes de reproduzir o problema, defina o nível de registo para Depuração para que os URLs completos dos pedidos da Graph API e as respostas sejam capturados. Veja Registo para saber como alterar o nível de registo através da interface de Preferências, do registo ou de uma política gerida.

Como é um erro da Graph API no registo do KONNEKT

Uma entrada de erro típica:

[2026-04-22 14:14:25.281] [22380] [error] [RESTkitClient] Http request (OneDriveClient::GetItemByPath)
GET: https://graph.microsoft.com/v1.0/drives/b!YbLv.../root:%2F...%2F03:?$select=remoteItem,id,name,... - 504
    error: Resposta não reconhecida(504)
    "{"error":{"code":"UnknownError","message":"","innerError":{
      "date":"2026-04-22T12:14:25",
      "request-id":"dc38b1d9-cd9d-4f3d-b75a-5448695fa719",
      "client-request-id":"dc38b1d9-cd9d-4f3d-b75a-5448695fa719"
    }}}"

Anote estes valores para os passos seguintes:

• O URL completo GET URL (copie tudo até, mas sem incluir, o código de estado HTTP).
• O código de estado HTTP (504 neste exemplo).
• As request-id valor. O suporte da Microsoft pode localizar o pedido com falha usando este ID.

Pré-requisitos

• Acesso à conta Microsoft 365 do utilizador afetado, ou o próprio utilizador disponível para iniciar sessão.
• Um navegador Web moderno (Microsoft Edge, Chrome, Firefox ou Safari).
• O caminho exato do ficheiro e o nome do ficheiro comunicados pelo utilizador, ou o URL da Graph API do registo de depuração.
• Acesso de Administrador Global ao centro de administração do Microsoft 365 (apenas se planear abrir um ticket de suporte da Microsoft).

Tem de iniciar sessão como o utilizador que está a experienciar o problema, e não como administrador. Utilizar uma conta diferente altera as permissões e o acesso ao ficheiro, o que invalida o teste.

Passo 1: Abrir o Graph Explorer

1. Abra o seu navegador e navegue para https://developer.microsoft.com/graph/graph-explorer.
2. Clique em Iniciar sessão no canto superior esquerdo.
3. Inicie sessão com as credenciais do utilizador afetado.

Passo 2: Conceda as permissões necessárias

O Graph Explorer utiliza permissões delegadas. Para testes relacionados com ficheiros, conceda os seguintes âmbitos:

Âmbito	Finalidade
User.Read	Ler o perfil do utilizador autenticado
Files.Read	Ler os ficheiros do OneDrive do utilizador
Files.Read.All	Ler todos os ficheiros a que o utilizador tem acesso
Sites.Read.All	Ler itens de sites do SharePoint aos quais o utilizador tem acesso

Para conceder os âmbitos:

1. No Graph Explorer, clique no Modificar permissões separador abaixo da entrada da consulta.
2. Localize cada âmbito na lista.
3. Clique em Consentimento ao lado de cada âmbito.
4. Aceite o pedido de consentimento.

Para a referência completa dos âmbitos, veja a referência de permissões da Microsoft.

Passo 3: Execute uma consulta de teste

Defina o método HTTP para GET e introduza uma das consultas abaixo no campo URL do pedido. Substitua os valores de espaço reservado entre chavetas por valores reais.

Opção A: Reutilizar o URL do registo de depuração do KONNEKT

Copie o URL completo da linha de registo que começa com GET: https://graph.microsoft.com/.... Cole tudo até ao código de estado HTTP, mas não o incluindo, no campo URL do Graph Explorer.

Esta é a opção preferida porque reproduz o pedido exato que falhou.

Opção B: Crie a consulta manualmente

Para listar a pasta raiz do OneDrive do utilizador:

GET https://graph.microsoft.com/v1.0/me/drive/root/children

Para aceder a um ficheiro específico por caminho:

GET https://graph.microsoft.com/v1.0/me/drive/root:/Documents/Reports/example.pdf

Para aceder a um ficheiro num site do SharePoint, obtenha primeiro o ID do site:

GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}

Depois consulte o ficheiro usando esse ID do site:

GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/Shared Documents/Folder/example.pdf

Clique em Executar consulta e reveja o painel de resposta.

Passo 4: Interprete o resultado

O painel de resposta mostra um código de estado HTTP e um corpo JSON. Use a tabela abaixo para classificar o resultado e decidir o próximo passo.

Código de estado	Significado	Próximo passo
200 OK	A chamada à Graph API foi bem-sucedida. O ficheiro está acessível ao nível da API.	O problema está do lado do KONNEKT ou no ambiente do cliente. Volte para o centro de resolução de problemas.
401 Unauthorized	O token está em falta, expirou ou é inválido.	Termine sessão no Graph Explorer e inicie sessão novamente. Se o erro persistir, veja Problemas com token de acesso.
403 Forbidden	O utilizador autenticado não tem permissão para este ficheiro ou site.	Não é um problema do KONNEKT nem do backend da Microsoft. Verifique as permissões na interface Web do SharePoint.
404 Not Found	O ficheiro ou pasta não existe no caminho indicado.	Verifique o caminho. O ficheiro pode ter sido movido, renomeado ou eliminado.
429 Too Many Requests	Limitação de taxa no SharePoint Online.	Limitação de taxa do lado da Microsoft. Verifique o Retry-After cabeçalho, aguarde e tente novamente. As definições de prevenção de limitação podem reduzir a recorrência.
500 Internal Server Error, 503 Service Unavailable, 504 Gateway Timeout	Erro do backend da Microsoft.	O problema está do lado da Microsoft. Continue com os próximos passos.
UnknownError no corpo da resposta	Erro do backend da Microsoft sem um código específico.	Tal como acima. Capture o request-id e abra um ticket de suporte da Microsoft.

Passo 5: Recolher evidências

Antes de fechar o Graph Explorer, documente o teste. Boas evidências ajudam a resolver os tickets de suporte mais rapidamente.

Recolha:

• Uma captura de ecrã da janela do Graph Explorer que mostre o URL da consulta, o código de estado HTTP e o corpo da resposta.
• A data e a hora do teste, incluindo o fuso horário.
• O UPN do utilizador autenticado (por exemplo, [e-mail]).
• O caminho exato do ficheiro que foi testado.
• As request-id valor do corpo da resposta JSON.
• Para erros intermitentes, repita a consulta várias vezes e capture cada resultado.

Passo 6: Abra um ticket de suporte da Microsoft

Siga este passo apenas se o Graph Explorer tiver devolvido um 500, 503, 504 ou UnknownError resposta.

1. Navegue até https://admin.microsoft.com e inicie sessão com uma conta de Administrador Global.
2. Aceda a Suporte -> Novo pedido de serviço.
3. Selecione SharePoint Online ou OneDrive para Empresas como serviço afetado, correspondendo ao endpoint que falhou.
4. Descreva o problema e anexe as capturas de ecrã do passo anterior.
5. Inclua o request-id tanto do registo de depuração do KONNEKT como da resposta do Graph Explorer. Isto permite à Microsoft localizar os pedidos com falha exatos.
6. Indique explicitamente que o problema foi reproduzido no Microsoft Graph Explorer.

Incluir provas do Graph Explorer indica que as causas de terceiros já foram descartadas. O suporte da Microsoft normalmente encaminha estes tickets mais rapidamente.

Endpoints comuns da Graph API

Referência rápida dos endpoints mais frequentemente vistos nos registos de depuração do KONNEKT:

Operação	Endpoint
Perfil do utilizador	GET /me
Listagem da raiz do OneDrive	GET /me/drive/root/children
Ficheiro por caminho (OneDrive)	GET /me/drive/root:/{path}
Ficheiro por ID do item	GET /drives/{drive-id}/items/{item-id}
Site por nome de anfitrião e caminho	GET /sites/{hostname}:/{site-path}
Drives do SharePoint num site	GET /sites/{site-id}/drives
Transferência do conteúdo do ficheiro	GET /drives/{drive-id}/items/{item-id}/content
Consulta delta	GET /drives/{drive-id}/root/delta

Para a referência completa, veja o Microsoft Graph Drive API.

Problemas Semelhantes

• Sites ausentes ou pastas vazias - para erros do backend da Pesquisa do SharePoint
• Problemas com token de acesso - para respostas 401 Unauthorized
• Como lidar com erro(s) - para erros em ficheiros específicos
• Preparação dos logs de depuração - como recolher registos com detalhes da Graph API
• Registo - configuração do nível de registo