Reproducir problemas de archivos con Graph Explorer

Cuando los usuarios informan de navegación lenta, errores al abrir archivos o otros errores de operación de archivos, y los registros de depuración de KONNEKT muestran errores de la API 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 backend de Microsoft 365 o en KONNEKT, y genera pruebas limpias para un caso de soporte de Microsoft.

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

• Los registros de depuración de KONNEKT muestran errores de la API Graph (HTTP 429, 500, 503, 504 o UnknownError).

• Necesita demostrar al soporte de Microsoft que el problema no está causado por software de terceros.

• La lentitud intermitente persiste después de haber descartado las comprobaciones habituales de KONNEKT.

Recopile e inspeccione 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 ocurre nada. Consulte Preparación del registro de depuración para el flujo de trabajo estándar de soporte.

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 Debug para que se capturen las URL completas de las solicitudes de la API 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 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: 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"
    }}}"

Tenga en cuenta estos valores para los pasos posteriores:

• El GET completo URL (copie todo hasta, pero sin incluir, el código de estado HTTP).

• El código de estado HTTP (504 en este ejemplo).

• El 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 que el usuario esté 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 informados por el usuario, o la URL de la API Graph del registro de depuración.

• Acceso de Administrador global al centro de administración de Microsoft 365 (solo si planea abrir un caso 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. 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	Finalidad
User.Read	Leer el perfil del usuario que ha iniciado 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 los 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. Haga clic en Consentimiento junto a cada ámbito.

4. Acepte el aviso de consentimiento.

Para ver la referencia completa de ámbitos, consulte 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 la 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 empieza 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

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 Graph se completó 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 Unauthorized	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 Forbidden	El usuario que ha iniciado 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 Not Found	El archivo o carpeta no existe en la ruta dada.	Verifique la ruta. Es posible que el archivo se haya movido, renombrado o eliminado.
429 Too Many Requests	limitación de SharePoint Online.	Limitación de velocidad 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 Internal Server Error, 503 Service Unavailable, 504 Gateway Timeout	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.	Lo mismo que arriba. Capture el request-id y abra un caso de soporte de Microsoft.

Paso 5: Capture evidencias

Antes de cerrar Graph Explorer, documente la prueba. Una buena evidencia hace que los casos 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 hora de la prueba, incluida la zona horaria.

• El UPN del usuario que ha iniciado sesión (por ejemplo, [email protected]).

• La ruta exacta del archivo que se probó.

• El 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 caso de soporte de Microsoft

Siga este paso solo si Graph Explorer devolvió una respuesta 500, 503, 504 o UnknownError .

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 for Business como servicio afectado, coincidiendo con el extremo 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.

Incluir evidencias de Graph Explorer indica que las causas de terceros ya han sido descartadas. El soporte de Microsoft normalmente dirige estos casos más rápido.

Puntos de conexión comunes de la API Graph

Referencia rápida para los extremos que se ven con más frecuencia en los registros de depuración de KONNEKT:

Operación	Extremo
Perfil de usuario	GET /me
Listado 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 consultar la referencia completa, vea la API de Microsoft Graph Drive.

Problemas similares

• Sitios faltantes o carpetas vacías - para errores del backend de SharePoint Search

• problemas con el token de acceso - para respuestas 401 Unauthorized

• Cómo tratar los errores - para errores en archivos específicos

• Preparación del registro de depuración - cómo recopilar registros con detalles de la API Graph

• Registro - configuración del nivel de registro