Reproduzir problemas de ficheiros com o Graph Explorer

Quando os usuários relatam navegação lenta, falhas ao abrir ficheiros 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 a solicitação com falha diretamente no navegador. Isso isola se a causa raiz está no backend do Microsoft 365 ou no KONNEKT, e produz evidências claras para um ticket de suporte da Microsoft.

O Microsoft Graph Explorer é uma ferramenta gratuita, baseada no navegador, da Microsoft. Ele envia solicitações para a Microsoft Graph API, que é a mesma interface que o KONNEKT, o aplicativo de sincronização do Microsoft OneDrive, o Microsoft Teams e o próprio Microsoft 365 usam para ler e gravar ficheiros do SharePoint Online e do OneDrive. Não é necessária instalação.

Quando usar este guia

Use este procedimento quando:

• Vários usuários relatam o mesmo problema ao mesmo tempo (geralmente 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).

• Você precisa provar ao suporte da Microsoft que o problema não é causado por software de terceiros.

• A lentidão intermitente persiste depois que as verificações habituais do KONNEKT foram descartadas.

Colete e inspecione 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 os envia silenciosamente em segundo plano - na maioria dos casos, nem o usuário nem o administrador percebem que algo está acontecendo. Veja Preparação do registo de depuração para o fluxo de suporte padrão.

O fluxo de trabalho do Graph Explorer é diferente: você precisa abrir o ficheiro de log você mesmo, localmente, para copiar a URL da solicitação com falha e o request-id para o Graph Explorer. Os ficheiros de log estão localizados em:

%LOCALAPPDATA%\Konnekt

O KONNEKT mantém até seis ficheiros de log rotativos de cerca de 1 MB cada. Classifique por hora de modificação e comece pelo ficheiro mais recente. Abra-o num editor de texto e procure por error ou pelo código de status HTTP que você está investigando (por exemplo, 504).

Antes de reproduzir o problema, defina o nível de registo para Debug para que as URLs completas das solicitações da Graph API e as respostas sejam capturadas. Veja Logging para saber como alterar o nível de registo pela interface de Preferências, pelo registro ou por uma política gerenciada.

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: Unrecognized response(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 as etapas posteriores:

• O GET URL completo (copie tudo até, mas não incluindo, o código de status HTTP).

• O código de status HTTP (504 neste exemplo).

• O request-id valor. O suporte da Microsoft pode rastrear a solicitação com falha usando este ID.

Pré-requisitos

• Acesso à conta Microsoft 365 do usuário afetado, ou o usuário disponível para entrar por si mesmo.

• Um navegador web moderno (Microsoft Edge, Chrome, Firefox ou Safari).

• O caminho exato do ficheiro e o nome do ficheiro relatados pelo usuário, ou a URL da Graph API do registo de depuração.

• Acesso de Administrador Global ao centro de administração do Microsoft 365 (somente se você pretende abrir um ticket de suporte da Microsoft).

Você deve entrar como o usuário que está enfrentando o problema, e não como administrador. Usar uma conta diferente altera as permissões e o acesso aos ficheiros, o que invalida o teste.

Etapa 1: Abra o Graph Explorer

1. Abra o seu navegador e navegue para https://developer.microsoft.com/graph/graph-explorer.

2. Clique em Sign in no canto superior esquerdo.

3. Entre com as credenciais do usuário afetado.

Etapa 2: Conceda as permissões necessárias

O Graph Explorer usa permissões delegadas. Para testes relacionados a ficheiros, conceda os seguintes escopos:

Escopo	Finalidade
User.Read	Ler o perfil do usuário conectado
Files.Read	Ler os ficheiros do OneDrive do usuário
Files.Read.All	Ler todos os ficheiros aos quais o usuário tem acesso
Sites.Read.All	Ler itens de sites do SharePoint aos quais o usuário tem acesso

Para conceder os escopos:

1. No Graph Explorer, clique na aba Modify permissions abaixo da entrada da consulta.

2. Localize cada escopo na lista.

3. Clique em Consent ao lado de cada escopo.

4. Aceite o pedido de consentimento.

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

Etapa 3: Execute uma consulta de teste

Defina o método HTTP para GET e insira uma das consultas abaixo no campo URL da solicitação. Substitua os valores de espaço reservado entre chaves por valores reais.

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

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

Esta é a opção preferida porque reproduz a solicitação exata que falhou.

Opção B: Monte a consulta manualmente

Para listar a pasta raiz do OneDrive do usuário:

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

Para aceder a um ficheiro específico pelo caminho:

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

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

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

Em seguida, consulte o ficheiro usando esse ID de site:

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

Clique em Execute a consulta e reveja o painel de resposta.

Etapa 4: Interprete o resultado

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

Código de status	Significado	Próxima etapa
200 OK	A chamada da Graph API foi bem-sucedida. O ficheiro está acessível no nível da API.	O problema está do lado do KONNEKT ou no ambiente do cliente. Volte ao Hub de solução de problemas.
401 Unauthorized	O token está ausente, expirado ou inválido.	Saia do Graph Explorer e entre novamente. Se o erro persistir, veja Problemas com token de acesso.
403 Forbidden	O usuário conectado 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 fornecido.	Verifique o caminho. O ficheiro pode ter sido movido, renomeado ou excluído.
429 Too Many Requests	Limitação de taxa do SharePoint Online.	Limitação de taxa do lado da Microsoft. Verifique o cabeçalho Retry-After 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 no backend da Microsoft.	O problema está do lado da Microsoft. Continue com as próximas etapas.
UnknownError no corpo da resposta	Erro no backend da Microsoft sem um código específico.	Igual ao acima. Capture o request-id e abra um ticket de suporte da Microsoft.

Etapa 5: Capture evidências

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

Colete:

• Uma captura de ecrã da janela do Graph Explorer mostrando a URL da consulta, o código de status HTTP e o corpo da resposta.

• A data e hora do teste, incluindo o fuso horário.

• O UPN do usuário conectado (por exemplo, [email protected]).

• O caminho exato do ficheiro que foi testado.

• O request-id valor do corpo da resposta JSON.

• Para erros intermitentes, repita a consulta várias vezes e capture cada resultado.

Etapa 6: Abra um ticket de suporte da Microsoft

Siga esta etapa somente se o Graph Explorer retornou uma resposta 500, 503, 504, ou UnknownError .

1. Navegue para https://admin.microsoft.com e entre com uma conta de Administrador Global.

2. Vá para Support -> New service request.

3. Selecione SharePoint Online ou OneDrive for Business como o serviço afetado, correspondendo ao endpoint que falhou.

4. Descreva o problema e anexe as capturas de ecrã da etapa anterior.

5. Inclua o request-id dos registos de depuração do KONNEKT e da resposta do Graph Explorer. Isso permite que a Microsoft rastreie as solicitações exatas que falharam.

6. Declare explicitamente que o problema foi reproduzido no Microsoft Graph Explorer.

Incluir evidências do Graph Explorer indica que causas de terceiros já foram descartadas. O suporte da Microsoft normalmente encaminha esses tickets mais rapidamente.

Endpoints comuns da Graph API

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

Operação	Endpoint
Perfil do usuário	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 hostname e caminho	GET /sites/{hostname}:/{site-path}
Drives do SharePoint num site	GET /sites/{site-id}/drives
Download 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 a API de unidades do Microsoft Graph.

Problemas semelhantes

• Sites ausentes ou pastas vazias - para erros de backend do SharePoint Search

• Problemas com token de acesso - para respostas 401 Unauthorized

• Como lidar com erro(s) - para erros em ficheiros específicos

• Preparação do registo de depuração - como coletar registos com detalhes da Graph API

• Logging - configuração do nível de registo