Cuando una página de SharePoint no se carga, una biblioteca de documentos deja de sincronizarse o un cambio de permisos no surte efecto, el mensaje de error suele contener una larga cadena de letras y números denominada ID de correlación. Muchos propietarios de sitios ignoran este código porque no saben qué significa ni cómo usarlo. Un ID de correlación actúa como un puntero que permite a los ingenieros de soporte de Microsoft localizar la entrada exacta del registro del servidor para una solicitud fallida. Este artículo explica qué es un ID de correlación, por qué es importante para la solución de problemas y proporciona una lista de verificación práctica que puede seguir para recopilar y enviar ID de correlación en sus solicitudes de soporte.
Puntos clave: Lista de verificación de ID de correlación para propietarios de SharePoint
- Herramientas para desarrolladores del navegador (F12): Presione F12 en su navegador, vuelva a cargar la página y revise la pestaña Red para encontrar el ID de correlación en los encabezados de respuesta de la solicitud fallida.
- Ubicación del registro ULS de SharePoint: El registro del Servicio de registro unificado se almacena en el servidor de SharePoint en la carpeta Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\LOGS.
- Centro de administración de Microsoft 365 > Estado del servicio: Revise el panel Estado del servicio para ver si hay ID de aviso o incidente que puedan correlacionarse con su ID de correlación e identificar problemas de servicio en curso.
Qué es un ID de correlación y por qué SharePoint genera uno
Un ID de correlación es un GUID único que SharePoint asigna a cada solicitud HTTP que pasa por el servidor. Cuando abre un sitio, carga un archivo o cambia un permiso, SharePoint registra los detalles de esa solicitud —incluidos el usuario, la hora, la URL y los errores— y la etiqueta con un ID de correlación. El ID lo genera el Servicio de registro unificado (ULS) de SharePoint y se almacena en los registros de seguimiento ULS del servidor.
El propósito del ID de correlación es vincular un error visible para el usuario con la entrada correspondiente del registro del servidor. Sin él, los ingenieros de soporte tendrían que buscar entre millones de entradas de registro por hora y usuario, lo cual es lento y poco confiable. Con el ID de correlación, pueden ir directamente a la solicitud que falló y ver la excepción exacta, el seguimiento de la pila y el contexto circundante.
Los ID de correlación aparecen en varios lugares: en la página de error del navegador, en los registros ULS de SharePoint, en el Visor de eventos de Windows en el servidor de SharePoint y en herramientas de diagnóstico como Fiddler o las herramientas para desarrolladores del navegador. En SharePoint Online, el ID de correlación es visible en la página de error y en el tráfico de red del navegador, pero los usuarios finales no pueden acceder a los registros ULS. En SharePoint Server, puede acceder directamente a los registros ULS en el servidor.
Dónde aparecen los ID de correlación en SharePoint Online
En SharePoint Online, el lugar más común para ver un ID de correlación es la página de error que aparece cuando falla una solicitud. La página de error muestra un mensaje como “Lo sentimos, algo salió mal” seguido de una sección de detalles técnicos que incluye el ID de correlación. También puede encontrar el ID de correlación abriendo las herramientas para desarrolladores del navegador, recargando la página e inspeccionando las solicitudes de red. Busque la solicitud que devolvió un código de estado 500 o 400 y luego revise los encabezados de respuesta para el campo llamado “SPRequestGuid” o “X-SharePointHealthScore”.
Dónde aparecen los ID de correlación en SharePoint Server
En SharePoint Server, el ID de correlación aparece en la misma página de error que en Online. Además, el ID se registra en los registros de seguimiento ULS ubicados en el servidor en C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\LOGS. También puede encontrarlo en el Registro de eventos de la aplicación de Windows, en el origen “SharePoint Foundation” o “SharePoint Server”.
Lista de verificación: Pasos para recopilar y enviar un ID de correlación en una solicitud de soporte
Siga esta lista de verificación cada vez que experimente un error de SharePoint que necesite escalar al soporte de Microsoft. Cada paso es independiente, por lo que puede comenzar con el método que le resulte más conveniente.
- Capture el ID de correlación de la página de error
Cuando aparezca la página de error, busque una sección etiquetada como “ID de correlación” o “Detalles técnicos”. El ID es una cadena hexadecimal de 32 caracteres agrupada en cinco secciones, por ejemplo: a1b2c3d4-e5f6-7890-abcd-ef1234567890. Copie la cadena completa en un archivo de texto o en una nota. Si la página de error no muestra el ID, pase al siguiente paso. - Abra las herramientas para desarrolladores del navegador (F12) y recargue la página
Presione F12 para abrir las herramientas para desarrolladores. Haga clic en la pestaña Red. Recargue la página o repita la acción que provocó el error. Busque la solicitud que falló: busque una entrada en rojo o un código de estado que comience con 4 o 5. Haga clic en la solicitud y luego vaya a la pestaña Encabezados. Busque el encabezado de respuesta llamado “SPRequestGuid” o “X-SharePointHealthScore”. El valor de SPRequestGuid es el ID de correlación. Haga clic con el botón derecho en el encabezado y seleccione Copiar valor. - Revise el Estado del servicio en el Centro de administración de Microsoft 365
Vaya al Centro de administración de Microsoft 365 en admin.microsoft.com. Navegue a Salud > Estado del servicio. Busque cualquier aviso o incidente activo que mencione SharePoint. Si encuentra un incidente, anote el ID del incidente. Es posible que el soporte de Microsoft solicite tanto el ID de correlación como el ID del incidente para confirmar que su problema está relacionado con un problema de servicio conocido. - Registre la hora exacta y la zona horaria del error
Anote la fecha y la hora en que ocurrió el error, incluida su zona horaria. Los ingenieros de soporte utilizan la hora para acotar la ventana de búsqueda en los registros. Use el formato de 24 horas para mayor claridad, por ejemplo: 2025-03-18 14:35 UTC. - Registre la URL completa y la acción que realizó
Anote la URL completa de la página donde ocurrió el error. Describa la acción exacta que realizó, por ejemplo, “hice clic en el botón Cargar en la biblioteca Documentos en https://contoso.sharepoint.com/sites/marketing/Shared%20Documents.”. Incluya el nombre de la biblioteca, lista o página. - Abra el registro ULS en el servidor de SharePoint (solo local)
Si utiliza SharePoint Server, navegue a C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\LOGS en el servidor. Abra el archivo de registro más reciente que coincida con la hora del error. Busque el ID de correlación que capturó. La entrada del registro muestra el tipo de excepción, el seguimiento de la pila y el componente que falló. Copie la sección relevante del registro en un archivo de texto. - Cree una solicitud de soporte en el Centro de administración de Microsoft 365
Vaya al Centro de administración de Microsoft 365 y navegue a Soporte > Nueva solicitud de servicio. En la descripción, pegue el ID de correlación, la hora exacta, la URL y la acción que realizó. Adjunte los archivos de registro que haya recopilado. Seleccione el nivel de gravedad que corresponda al impacto.
Errores comunes al usar ID de correlación en solicitudes de soporte
Envié el ID de correlación incorrecto de una solicitud diferente
Un error común es copiar el ID de correlación de una solicitud exitosa en lugar de la fallida. En las herramientas para desarrolladores del navegador, una solicitud exitosa devuelve un código de estado 200 y no es el origen del error. Solo las solicitudes con un código de estado 4xx o 5xx contienen el ID de correlación del fallo. Verifique siempre el código de estado antes de copiar el ID.
Mi ID de correlación no aparece en la página de error
En algunos errores de SharePoint Online, la página de error puede no mostrar el ID de correlación. Esto suele ocurrir cuando el error se produce antes de que SharePoint pueda generar una entrada de registro, por ejemplo, un tiempo de espera de red o un error de proxy inverso. En ese caso, revise las herramientas para desarrolladores del navegador para ver el encabezado SPRequestGuid. Si el encabezado también falta, es probable que el problema esté en el nivel de red o DNS, no dentro de SharePoint. Contacte primero a su equipo de red.
Envié una solicitud de soporte sin el ID de correlación
Enviar una solicitud de soporte sin un ID de correlación obliga al ingeniero de soporte a buscar manualmente en los registros, lo que retrasa la resolución. Si no puede encontrar el ID de correlación, proporcione la hora exacta, la cuenta de usuario y la URL. El ingeniero puede entonces ejecutar una consulta de registro ULS en el lado del servidor, pero esto lleva más tiempo. Trate siempre de capturar primero el ID de correlación.
| Elemento | SharePoint Online | SharePoint Server |
|---|---|---|
| ID de correlación visible en la página de error | Sí | Sí |
| Acceso a los registros ULS | No (Microsoft administra los registros) | Sí (en el servidor) |
| Método de herramientas para desarrolladores del navegador | Funciona (encabezado SPRequestGuid) | Funciona (encabezado SPRequestGuid) |
| Panel Estado del servicio disponible | Sí | No |
| Tiempo de respuesta típico del soporte con ID | 1-4 horas | 1-2 horas (si se proporcionan registros) |
Ahora puede recopilar un ID de correlación de cualquier error de SharePoint utilizando las herramientas para desarrolladores del navegador y la página de error. La próxima vez que abra una solicitud de soporte, incluya el ID de correlación, la hora exacta, la URL y la acción que realizó. Para SharePoint Server, adjunte también la sección relevante del registro ULS. Esta lista de verificación reduce el intercambio de mensajes con el soporte y ayuda a resolver los problemas más rápido.