Reproducir 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.

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.

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 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 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).

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.

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.

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.
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.
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, [e-mail]).
• 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.

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.

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.

Problemas similares

• Sitios faltantes o carpetas vacías - para errores del back-end de búsqueda de SharePoint
• Problemas con el token de acceso - para respuestas 401 No autorizado
• Cómo tratar el/los error(es) - para errores en archivos específicos
• Preparación de registros de depuración - cómo recopilar registros con detalles de la API de Graph
• Registro - configuración del nivel de registro