Usar correlation ids en solicitudes de soporte de SharePoint: mejores configuraciones para Microsoft 365

Cuando envía una solicitud de soporte para SharePoint Online, los ingenieros de soporte de Microsoft a menudo solicitan un Correlation ID. Se trata de un identificador único vinculado a una operación fallida específica en el sistema de SharePoint. Sin él, los equipos de soporte no pueden rastrear los registros de errores exactos, los eventos del servidor y las acciones del usuario que causaron el problema. Este artículo explica cómo encontrar Correlation IDs en SharePoint, qué configuraciones debe configurar en Microsoft 365 para que sean más útiles y cómo incluirlos en sus solicitudes de soporte para una resolución más rápida.

¿Qué es un Correlation ID y por qué es importante para el soporte?

Un Correlation ID es un GUID (identificador único global) que SharePoint Online genera para cada solicitud que llega a la granja de servidores. Cuando se produce un error, el sistema registra el ID junto con la hora exacta, el contexto del usuario y la ruta de código que falló. Los ingenieros de soporte de Microsoft utilizan este ID para recuperar los registros correspondientes de miles de servidores en el centro de datos de Microsoft 365.

Sin un Correlation ID, los ingenieros de soporte deben confiar en descripciones genéricas de errores y marcas de tiempo, que a menudo apuntan a múltiples causas posibles. Esto ralentiza el diagnóstico y puede llevar a una identificación incorrecta de la causa raíz. Al proporcionar un Correlation ID, le da al equipo de soporte un vínculo directo al punto exacto del fallo, lo que reduce el tiempo de resolución de días a horas.

Los Correlation IDs también son valiosos para la solución de problemas interna. Si administra sitios de SharePoint, puede usarlos para correlacionar los problemas informados por los usuarios con los eventos del lado del servidor en el centro de administración de Microsoft 365 o mediante scripts de PowerShell.

Cómo genera SharePoint un Correlation ID

Cuando un usuario realiza una solicitud a SharePoint Online, como cargar una página, cargar un archivo o ejecutar una búsqueda, la solicitud pasa por un equilibrador de carga, un front-end web y un servidor de aplicaciones. Cada componente agrega su propia información de registro, pero el Correlation ID permanece constante en todos los saltos. Esto permite al equipo de soporte reconstruir toda la ruta de la solicitud.

Qué información contiene un Correlation ID

El ID en sí es una cadena hexadecimal de 32 caracteres, por ejemplo: 5f8a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c. No contiene datos de usuario ni contenido del sitio. Es puramente un identificador de la transacción de la solicitud. Los registros asociados incluyen el nombre de usuario, la URL del sitio, el método HTTP (GET o POST), el código de estado de respuesta y el módulo que produjo la excepción.

Pasos para encontrar y usar un Correlation ID en solicitudes de soporte de SharePoint

1. Capture el Correlation ID de una página de error
   Cuando SharePoint muestra un banner de error rojo o un error de página completa, el Correlation ID aparece en la parte inferior del mensaje de error. A menudo se etiqueta como “Correlation ID” o “Correlation:” seguido del GUID. Copie la cadena completa exactamente, incluidos los guiones. No cierre la pestaña del navegador hasta que guarde el ID.
2. Use las Herramientas para desarrolladores F12 para capturar IDs de errores intermitentes
   Abra las herramientas para desarrolladores del navegador presionando F12. Vaya a la pestaña Red y vuelva a cargar la página o repita la acción que falla. Busque solicitudes con un código de estado rojo (400, 401, 403, 500, etc.). Haga clic en la solicitud fallida, vaya a la sección Encabezados de respuesta y busque el encabezado sprequestguid o X-SharePointHealthScore. El Correlation ID suele estar en el campo sprequestguid. Copie el valor.
3. Habilite el registro de diagnóstico detallado en el centro de administración de SharePoint
   Vaya al centro de administración de SharePoint > Salud > Registros de diagnóstico. En Recopilación de registros, seleccione el ámbito de la colección de sitios o del inquilino. Establezca el nivel de registro en Detallado. Esto garantiza que cada operación escriba una entrada de registro con un Correlation ID. Tenga en cuenta que el registro detallado genera grandes cantidades de datos, por lo que debe habilitarlo solo cuando esté solucionando problemas activamente.
4. Recopile el ID de un flujo de trabajo o flujo de Power Automate fallido
   Cuando falla un flujo de trabajo de SharePoint o un flujo de Power Automate, abra el historial de ejecución del flujo. En los detalles del error, busque un campo llamado correlationId o runId. Copie este valor. Para los flujos de trabajo clásicos de SharePoint, use la página Estado del flujo de trabajo y verifique el mensaje de error para encontrar el ID.
5. Use el centro de administración de Microsoft 365 para recuperar registros de un usuario específico
   Vaya al centro de administración de Microsoft 365 > Salud > Estado del servicio. Seleccione el servicio SharePoint Online. En Problemas recientes, busque el incidente que coincida con su error. Abra el incidente y busque los Correlation IDs que Microsoft ya haya recopilado. También puede usar el Centro de mensajes para encontrar IDs vinculados a problemas conocidos.
6. Envíe el Correlation ID en su solicitud de soporte
   Al crear un ticket de soporte en el centro de administración de Microsoft 365, incluya el Correlation ID en el campo de descripción. También proporcione la fecha y hora exactas (incluida la zona horaria) en que se produjo el error, la URL del sitio afectado y la cuenta de usuario que encontró el error. Esta combinación permite al ingeniero de soporte encontrar los registros de inmediato.

Si el equipo de soporte necesita más información

A veces, un solo Correlation ID no es suficiente. El soporte de Microsoft puede solicitar varios IDs de la misma sesión de usuario o de un intervalo de tiempo específico. Esto es común cuando el error se debe a una condición de carrera o a una degradación transitoria del servicio. En ese caso, recopile IDs de varios intentos fallidos y proporcione la lista completa.

SharePoint falla pero no aparece ningún Correlation ID

Si la página de error no muestra un Correlation ID, es probable que el fallo se haya producido antes de que SharePoint pudiera generarlo. Esto puede ocurrir cuando el navegador no puede comunicarse con el servidor, o cuando un proxy o firewall bloquea la solicitud. Revise la consola del navegador para detectar errores de red y verifique que la URL del sitio sea correcta. Si el problema está en el lado del cliente, el equipo de soporte no puede usar un Correlation ID.

El Correlation ID apunta a un problema conocido

Después de enviar el ID, el soporte de Microsoft puede informarle que el error coincide con un incidente de servicio conocido. En ese caso, le proporcionarán un aviso de estado del servicio con un tiempo estimado de resolución. No necesita realizar ninguna solución de problemas adicional. El Correlation ID les permitió relacionar su problema con el incidente existente sin más investigación.

El Correlation ID expira o no se encuentra

SharePoint Online conserva los registros de diagnóstico durante un período limitado, normalmente de 14 a 30 días. Si intenta usar un Correlation ID de un error que ocurrió hace más de 30 días, es posible que los registros se hayan purgado. Capture siempre el ID tan pronto como ocurra el error. Para investigaciones prolongadas, habilite el registro detallado y exporte los registros a Azure Log Analytics para una retención más larga.

Métodos para capturar Correlation IDs: navegador vs PowerShell vs centro de administración

Método	Cuándo usarlo	Ventajas	Desventajas
Página de error del navegador	El usuario ve un error visible	No se necesitan herramientas, captura inmediata	Solo funciona para errores de página completa, no para fallos parciales
Herramientas para desarrolladores F12	Fallos intermitentes o silenciosos	Captura IDs de cualquier error HTTP	Requiere habilidad técnica para interpretar encabezados
Registros de diagnóstico del centro de administración de SharePoint	Monitoreo proactivo de operaciones del sitio	Captura IDs de todos los usuarios y operaciones	El registro detallado puede llenar el almacenamiento rápidamente
PowerShell (Get-SPLogEvent)	Recuperación masiva de registros para administradores de inquilinos	Automatiza la recopilación de múltiples IDs	Requiere SharePoint Online Management Shell y derechos de administrador

Con un Correlation ID en mano, puede reducir el tiempo que el soporte de Microsoft dedica a localizar sus registros de errores. El mejor enfoque es capturar el ID inmediatamente después de que ocurra el error, habilitar el registro detallado solo durante la solución de problemas activa y siempre incluir el ID junto con la marca de tiempo exacta y el contexto del usuario. Esta práctica convierte un informe de error vago en una herramienta de diagnóstico precisa tanto para usted como para el equipo de soporte.