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

{% 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 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 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](https://docs.konnekt.io/troubleshooting/debug-log-preparation) 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](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 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).

{% 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. 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](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 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](https://docs.konnekt.io/troubleshooting).                                         |
| `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](https://docs.konnekt.io/troubleshooting/access-token-issues).       |
| `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, `user@contoso.com`).
* 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.

{% hint style="info" %}
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.
{% endhint %}

## 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](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 backend de SharePoint Search
* [problemas con el token de acceso](https://docs.konnekt.io/troubleshooting/access-token-issues) - para respuestas 401 Unauthorized
* [Cómo tratar los errores](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s) - para errores en archivos específicos
* [Preparación del registro de depuración](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - cómo recopilar registros con detalles de la API Graph
* [Registro](https://docs.konnekt.io/configuration/system-settings/logging) - configuración del nivel de registro


---

# Agent Instructions: 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:

```
GET https://docs.konnekt.io/es/troubleshooting/reproducir-problemas-de-archivos-con-graph-explorer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.