> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/pt/troubleshooting/reproduce-file-issues-with-graph-explorer.md). # 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. {% hint style="info" %} 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. {% endhint %} ## 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](https://docs.konnekt.io/troubleshooting/debug-log-preparation) 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](https://docs.konnekt.io/configuration/system-settings/logging) 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). {% hint style="warning" %} 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. {% endhint %} ## 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](https://learn.microsoft.com/graph/permissions-reference). ## 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](https://docs.konnekt.io/troubleshooting). | | `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](https://docs.konnekt.io/troubleshooting/access-token-issues). | | `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, `user@contoso.com`). * 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. {% hint style="info" %} Incluir provas do Graph Explorer indica que as causas de terceiros já foram descartadas. O suporte da Microsoft normalmente encaminha estes tickets mais rapidamente. {% endhint %} ## 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](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 do backend da Pesquisa do SharePoint * [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 dos logs de depuração](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - como recolher registos com detalhes da Graph API * [Registo](https://docs.konnekt.io/configuration/system-settings/logging) - configuração do nível de registo --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.konnekt.io/pt/troubleshooting/reproduce-file-issues-with-graph-explorer.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.