> 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/es/troubleshooting/reproduce-file-issues-with-graph-explorer.md). # Reproducir problemas de archivos con Graph Explorer Cuando los usuarios informan de navegación lenta, aperturas de archivos fallidas u otros errores de operaciones de archivos, y los registros de depuración de KONNEKT muestran errores de la API de Graph, Microsoft Graph Explorer permite reproducir la solicitud que falla directamente en el navegador. Esto aísla si la causa raíz está en el backend de Microsoft 365 o en KONNEKT, y genera evidencia limpia para un ticket de soporte de Microsoft. {% hint style="info" %} Microsoft Graph Explorer es una herramienta gratuita basada en navegador de Microsoft. Envía solicitudes a la API de Microsoft Graph, que es la misma interfaz que KONNEKT, la aplicación de sincronización de Microsoft OneDrive, Microsoft Teams y Microsoft 365 usan para leer y escribir archivos de SharePoint Online y OneDrive. No se requiere instalación. {% endhint %} ## Cuándo usar esta guía Use este procedimiento cuando: * Varios usuarios informan del mismo problema al mismo tiempo (a menudo una señal de un problema de backend). * Los registros de depuración de KONNEKT muestran errores de la API de Graph (HTTP 429, 500, 503, 504, o `UnknownError`). * Necesita demostrar al soporte de Microsoft que el problema no es causado por software de terceros. * La lentitud intermitente persiste después de descartar las comprobaciones habituales de KONNEKT. ### Recopilar e inspeccionar el registro de depuración La forma normal de obtener los registros de KONNEKT para soporte es ejecutando `crashguard.exe` de `C:\Program Files\Konnekt`. Ese flujo empaqueta los registros y los carga silenciosamente en segundo plano; en la mayoría de los casos, ni el usuario ni el administrador notan que ocurre nada. Consulte [Preparación de registros de depuración](https://docs.konnekt.io/troubleshooting/debug-log-preparation) para el flujo de soporte estándar. El flujo de trabajo de Graph Explorer es distinto: usted necesita abrir el archivo de registro por su cuenta, localmente, para copiar la URL de la solicitud que falla y `request-id` en Graph Explorer. Los archivos de registro se encuentran en: ``` %LOCALAPPDATA%\Konnekt ``` KONNEKT conserva hasta seis archivos de registro rotativos de aproximadamente 1 MB cada uno. Ordene por hora de modificación y comience con el archivo más reciente. Ábralo en un editor de texto y busque `error` o el código de estado HTTP que está investigando (por ejemplo, `504`). Antes de reproducir el problema, establezca el nivel de registro en **Depuración** para que se capturen las URL completas de solicitudes de la API de Graph y las respuestas. Consulte [Registro](https://docs.konnekt.io/configuration/system-settings/logging) para saber cómo cambiar el nivel de registro mediante la interfaz de usuario de Preferencias, el registro o una directiva administrada. ### Cómo se ve un error de la API de Graph en el registro de KONNEKT Una entrada de error 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: Respuesta no reconocida(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 estos valores para los pasos posteriores: * La `GET` URL completa (copie todo hasta, pero sin incluir, el código de estado HTTP). * El código de estado HTTP (504 en este ejemplo). * Las `request-id` valor. El soporte de Microsoft puede rastrear la solicitud fallida usando este ID. ## Requisitos previos * Acceso a la cuenta de Microsoft 365 del usuario afectado, o al usuario disponible para iniciar sesión por sí mismo. * Un navegador web moderno (Microsoft Edge, Chrome, Firefox o Safari). * La ruta completa y el nombre de archivo exactos informados por el usuario, o la URL de la API de Graph del registro de depuración. * Acceso de administrador global al centro de administración de Microsoft 365 (solo si planea abrir un ticket de soporte de Microsoft). {% hint style="warning" %} Debe iniciar sesión como el usuario que experimenta el problema, no como administrador. Usar una cuenta diferente cambia los permisos y el acceso a los archivos, lo que invalida la prueba. {% endhint %} ## Paso 1: Abra Graph Explorer 1. Abra su navegador y vaya a `https://developer.microsoft.com/graph/graph-explorer`. 2. Haga clic en **Iniciar sesión** en la esquina superior izquierda. 3. Inicie sesión con las credenciales del usuario afectado. ## Paso 2: Conceda los permisos requeridos Graph Explorer usa permisos delegados. Para pruebas relacionadas con archivos, conceda los siguientes ámbitos: | Ámbito | Propósito | | ---------------- | ------------------------------------------------------------------------ | | `User.Read` | Leer el perfil del usuario que inició sesión | | `Files.Read` | Leer los archivos de OneDrive del usuario | | `Files.Read.All` | Leer todos los archivos a los que el usuario tiene acceso | | `Sites.Read.All` | Leer elementos de sitios de SharePoint a los que el usuario tiene acceso | Para conceder los ámbitos: 1. En Graph Explorer, haga clic en la pestaña **Modificar permisos** debajo del campo de entrada de consulta. 2. Localice cada ámbito en la lista. 3. Haga clic en **Consentimiento** junto a cada ámbito. 4. Acepte el aviso de consentimiento. Para ver la referencia completa de ámbitos, consulte [la referencia de permisos de Microsoft](https://learn.microsoft.com/graph/permissions-reference). ## Paso 3: Ejecute una consulta de prueba Establezca el método HTTP en `GET` e introduzca una de las consultas siguientes en el campo de URL de solicitud. Reemplace los valores de marcador de posición entre llaves con valores reales. ### Opción A: Reutilice la URL del registro de depuración de KONNEKT Copie la URL completa de la línea de registro que comienza con `GET: https://graph.microsoft.com/...`. Pegue todo hasta (pero sin incluir) el código de estado HTTP en el campo de URL de Graph Explorer. Esta es la opción preferida porque reproduce exactamente la solicitud que falló. ### Opción B: Construya la consulta manualmente Para enumerar la carpeta raíz de OneDrive del usuario: ``` GET https://graph.microsoft.com/v1.0/me/drive/root/children ``` Para acceder a un archivo específico por ruta: ``` GET https://graph.microsoft.com/v1.0/me/drive/root:/Documents/Reports/example.pdf ``` Para acceder a un archivo en un sitio de SharePoint, primero obtenga el ID del sitio: ``` GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path} ``` Después consulte el archivo usando ese ID de sitio: ``` GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/Shared Documents/Folder/example.pdf ``` Haga clic en **Ejecutar consulta** y revise el panel de respuesta. ## Paso 4: Interprete el resultado El panel de respuesta muestra un código de estado HTTP y un cuerpo JSON. Use la tabla siguiente para clasificar el resultado y decidir el siguiente paso. | Código de estado | Significado | Siguiente paso | | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `200 OK` | La llamada a la API de Graph se realizó correctamente. El archivo es accesible a nivel de API. | El problema está del lado de KONNEKT o en el entorno del cliente. Regrese al [centro de solución de problemas](https://docs.konnekt.io/troubleshooting). | | `401 No autorizado` | El token falta, ha expirado o no es válido. | Cierre sesión en Graph Explorer e inicie sesión de nuevo. Si el error persiste, consulte [Problemas con el token de acceso](https://docs.konnekt.io/troubleshooting/access-token-issues). | | `403 Prohibido` | El usuario que inició sesión no tiene permiso para este archivo o sitio. | No es un problema de KONNEKT ni del backend de Microsoft. Verifique los permisos en la interfaz web de SharePoint. | | `404 No encontrado` | El archivo o carpeta no existe en la ruta indicada. | Verifique la ruta. Es posible que el archivo se haya movido, se haya cambiado de nombre o se haya eliminado. | | `429 Demasiadas solicitudes` | Limitación de velocidad de SharePoint Online. | Limitación de ritmo del lado de Microsoft. Compruebe el encabezado `Retry-After` , espere y vuelva a intentarlo. La configuración de prevención de limitación puede reducir la recurrencia. | | `500 Error interno del servidor`, `503 Servicio no disponible`, `504 Tiempo de espera de gateway agotado` | Error del backend de Microsoft. | El problema está del lado de Microsoft. Continúe con los siguientes pasos. | | `UnknownError` en el cuerpo de la respuesta | Error del backend de Microsoft sin un código específico. | Igual que arriba. Capture el `request-id` y abra un ticket de soporte de Microsoft. | ## Paso 5: Capture evidencia Antes de cerrar Graph Explorer, documente la prueba. Una buena evidencia hace que los tickets de soporte se resuelvan más rápido. Recopile: * Una captura de pantalla de la ventana de Graph Explorer que muestre la URL de la consulta, el código de estado HTTP y el cuerpo de la respuesta. * La fecha y la hora de la prueba, incluida la zona horaria. * El UPN del usuario que inició sesión (por ejemplo, `user@contoso.com`). * La ruta exacta del archivo que se probó. * Las `request-id` valor del cuerpo de la respuesta JSON. * Para errores intermitentes, repita la consulta varias veces y capture cada resultado. ## Paso 6: Abra un ticket de soporte de Microsoft Siga este paso solo si Graph Explorer devolvió una respuesta 500, 503, 504 o `UnknownError` respuesta. 1. Vaya a `https://admin.microsoft.com` e inicie sesión con una cuenta de Administrador global. 2. Vaya a **Soporte** -> **Nueva solicitud de servicio**. 3. Seleccione **SharePoint Online** o **OneDrive para empresas** como el servicio afectado, coincidiendo con el punto de conexión que falló. 4. Describa el problema y adjunte las capturas de pantalla del paso anterior. 5. Incluya el `request-id` tanto del registro de depuración de KONNEKT como de la respuesta de Graph Explorer. Esto permite a Microsoft rastrear exactamente las solicitudes fallidas. 6. Indique explícitamente que el problema se reprodujo en Microsoft Graph Explorer. {% hint style="info" %} Incluir evidencia de Graph Explorer indica que las causas de terceros ya se han descartado. El soporte de Microsoft normalmente enruta estos tickets más rápido. {% endhint %} ## Puntos de conexión comunes de la API de Graph Referencia rápida de los puntos de conexión que se ven con más frecuencia en los registros de depuración de KONNEKT: | Operación | Punto de conexión | | ---------------------------------- | ------------------------------------------------ | | Perfil del usuario | `GET /me` | | Listado de raíz de OneDrive | `GET /me/drive/root/children` | | Archivo por ruta (OneDrive) | `GET /me/drive/root:/{path}` | | Archivo por ID de elemento | `GET /drives/{drive-id}/items/{item-id}` | | Sitio por nombre de host y ruta | `GET /sites/{hostname}:/{site-path}` | | Unidades de SharePoint en un sitio | `GET /sites/{site-id}/drives` | | Descarga del contenido del archivo | `GET /drives/{drive-id}/items/{item-id}/content` | | Consulta delta | `GET /drives/{drive-id}/root/delta` | Para ver la referencia completa, consulte la [API de Microsoft Graph Drive](https://learn.microsoft.com/graph/api/resources/drive). ### Problemas similares * [Sitios que faltan o carpetas vacías](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) - para errores del backend de SharePoint Search * [Problemas con el token de acceso](https://docs.konnekt.io/troubleshooting/access-token-issues) - para respuestas 401 No autorizado * [Cómo tratar los errores](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s) - para errores en archivos específicos * [Preparación de registros de depuración](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - cómo recopilar registros con detalles de la API de Graph * [Registro](https://docs.konnekt.io/configuration/system-settings/logging) - configuración del nivel de registro --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.konnekt.io/es/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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.