> 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). # Reproduce problemas de archivos con Graph Explorer Cuando los usuarios informan de navegación lenta, fallos al abrir archivos u otros errores de operación de archivos, y los registros de depuración de KONNEKT muestran errores de la API de Graph, Microsoft Graph Explorer le permite reproducir la solicitud que falla directamente en el navegador. Esto aísla si la causa raíz está en el back-end 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 de Microsoft basada en navegador. Envía solicitudes a la API de Microsoft Graph, que es la misma interfaz que usan KONNEKT, la aplicación de sincronización de Microsoft OneDrive, Microsoft Teams y Microsoft 365 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 back-end). * Los registros de depuración de KONNEKT muestran errores de la API de Graph (HTTP 429, 500, 503, 504 o `Error desconocido`). * Necesita demostrar al soporte de Microsoft que el problema no está 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 enviar los registros de KONNEKT al soporte es ejecutando `crashguard.exe` desde `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 ocurra 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 diferente: debe abrir usted mismo el archivo de registro, 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 las 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 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] Solicitud HTTP (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" }}}" ``` Tome nota de estos valores para los pasos posteriores: * La URL `GET` 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 el usuario disponible para iniciar sesión por sí mismo. * Un navegador web moderno (Microsoft Edge, Chrome, Firefox o Safari). * La ruta exacta del archivo y el nombre de archivo que informó 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 está experimentando 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. Haz 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 autenticado | | `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 la consulta. 2. Localice cada ámbito en la lista. 3. Haz clic en **Consentimiento** junto a cada ámbito. 4. Acepta 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 por 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} ``` Luego consulte el archivo usando ese ID del sitio: ``` GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/Shared Documents/Folder/example.pdf ``` Haz 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. Vuelva al [centro de solución de problemas](https://docs.konnekt.io/troubleshooting). | | `401 No autorizado` | El token falta, ha caducado 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 autenticado no tiene permiso para este archivo o sitio. | No es un problema de KONNEKT ni del back-end de Microsoft. Verifique los permisos en la interfaz web de SharePoint. | | `404 No encontrado` | El archivo o la carpeta no existen en la ruta indicada. | Verifique la ruta. Es posible que el archivo se haya movido, cambiado de nombre o eliminado. | | `429 Demasiadas solicitudes` | Limitación de SharePoint Online. | Limitación de tasa del lado de Microsoft. Compruebe el `Retry-After` encabezado, espere y vuelva a intentarlo. Los ajustes de prevención de limitación pueden reducir su recurrencia. | | `500 Error interno del servidor`, `503 Servicio no disponible`, `504 Tiempo de espera agotado de la puerta de enlace` | Error del back-end de Microsoft. | El problema está del lado de Microsoft. Continúe con los siguientes pasos. | | `Error desconocido` en el cuerpo de la respuesta | Error del back-end de Microsoft sin un código específico. | Igual que arriba. Capture el `request-id` y abra un ticket de soporte con Microsoft. | ## Paso 5: Capture evidencia Antes de cerrar Graph Explorer, documente la prueba. Una buena evidencia ayuda a resolver más rápido los casos de soporte. 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 hora de la prueba, incluida la zona horaria. * El UPN del usuario autenticado (por ejemplo, `user@contoso.com`). * La ruta exacta del archivo que se probó. * Las `request-id` valor del cuerpo de 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 500, 503, 504 o `Error desconocido` respuesta. 1. Ve a `https://admin.microsoft.com` e inicie sesión con una cuenta de Administrador global. 2. Vaya a **Soporte** -> **Nueva solicitud de servicio**. 3. Selecciona **SharePoint Online** o **OneDrive for Business** como servicio afectado, coincidiendo con el endpoint que falló. 4. Describa el problema y adjunte las capturas de pantalla del paso anterior. 5. Incluya el `request-id` de ambos, el registro de depuración de KONNEKT y la respuesta de Graph Explorer. Esto permite a Microsoft rastrear las solicitudes exactas que fallaron. 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 suele derivar estos casos más rápido. {% endhint %} ## Extremos comunes de la API de Graph Referencia rápida de los extremos que aparecen con mayor frecuencia en los registros de depuración de KONNEKT: | Operación | Extremo | | ---------------------------------- | ------------------------------------------------ | | Perfil del usuario | `GET /me` | | Listado de la 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 la referencia completa, consulte la [API de Drive de Microsoft Graph](https://learn.microsoft.com/graph/api/resources/drive). ### Problemas similares * [Sitios faltantes o carpetas vacías](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) - para errores del back-end de búsqueda de SharePoint * [Problemas con el token de acceso](https://docs.konnekt.io/troubleshooting/access-token-issues) - para respuestas 401 No autorizado * [Cómo tratar el/los error(es)](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 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/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 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.