# 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. {% hint style="info" %} 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. {% endhint %} ## 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](https://docs.konnekt.io/troubleshooting/debug-log-preparation) 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](https://docs.konnekt.io/configuration/system-settings/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). {% hint style="warning" %} 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. {% endhint %} ## 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](https://learn.microsoft.com/graph/permissions-reference). ## 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](https://docs.konnekt.io/troubleshooting). | | `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](https://docs.konnekt.io/troubleshooting/access-token-issues). | | `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, `user@contoso.com`). * 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. {% hint style="info" %} Incluir evidências do Graph Explorer indica que causas de terceiros já foram descartadas. O suporte da Microsoft normalmente encaminha esses tickets mais rapidamente. {% endhint %} ## 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](https://learn.microsoft.com/graph/api/resources/drive). ### Problemas semelhantes * [Sites ausentes ou pastas vazias](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) - para erros de backend do SharePoint Search * [Problemas com token de acesso](https://docs.konnekt.io/troubleshooting/access-token-issues) - para respostas 401 Unauthorized * [Como lidar com erro(s)](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s) - para erros em ficheiros específicos * [Preparação do registo de depuração](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - como coletar registos com detalhes da Graph API * [Logging](https://docs.konnekt.io/configuration/system-settings/logging) - configuração do nível de registo --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.konnekt.io/pt/troubleshooting/reproduzir-problemas-de-ficheiros-com-o-graph-explorer.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.