Cómo recopilar detalles de errores de SharePoint antes de escalar

Cuando un sitio o una característica de SharePoint deja de funcionar, necesitas detalles específicos del error antes de contactar con el soporte. Los mensajes de error genéricos como “Algo salió mal” no ayudan a los ingenieros de soporte de Microsoft a diagnosticar el problema. Este artículo explica exactamente qué registros, capturas de pantalla y datos de configuración debes recopilar antes de abrir un ticket de soporte. Aprenderás a reunir detalles de errores de SharePoint desde el navegador, PowerShell y el centro de administración de SharePoint.

Por qué los mensajes de error de SharePoint a menudo no son útiles

SharePoint muestra páginas de error genéricas a los usuarios finales para evitar exponer información sensible del servidor. Una página de error típica muestra “Se ha producido un error inesperado” o “Lo sentimos, algo salió mal”. Estos mensajes carecen de los detalles técnicos que necesitan los ingenieros de soporte. Detrás de la página genérica, SharePoint genera registros con ID de correlación, seguimientos de pila y códigos de estado HTTP. Los equipos de soporte utilizan estos registros para rastrear la solicitud exacta que falló. Sin estos detalles, la escalación lleva más tiempo porque el soporte debe solicitar la misma información repetidamente.

El papel del ID de correlación

Cada solicitud de SharePoint genera un ID de correlación único. Este GUID vincula el error con los registros del lado del servidor. Cuando proporcionas el ID de correlación, el soporte puede localizar la entrada de registro exacta para tu sesión. Sin él, el soporte debe buscar en los registros por rango de tiempo, lo cual es menos preciso y más lento.

Códigos de estado HTTP y su significado

Los errores de SharePoint devuelven códigos de estado HTTP estándar. Un código 403 significa que el usuario no tiene permisos. Un código 404 significa que la página o el archivo no existe. Un código 500 indica un error del servidor. Capturar estos códigos ayuda al soporte a categorizar el problema de inmediato.

Pasos para recopilar detalles de errores de SharePoint desde el navegador

1. Abrir las herramientas de desarrollador del navegador
   Presiona F12 en Chrome, Edge o Firefox. Cambia a la pestaña Red antes de reproducir el error.
2. Reproducir el error
   Realiza la acción que desencadena el error. Por ejemplo, abre una biblioteca de documentos o haz clic en un enlace de SharePoint que falle.
3. Localizar la solicitud fallida
   En la pestaña Red, busca la solicitud que devolvió un código de estado rojo o 4xx/5xx. Haz clic en esa solicitud para ver los detalles.
4. Copiar el ID de correlación
   En la pestaña Encabezados, busca el encabezado SPRequestGuid o X-SharePointHealthScore. El ID de correlación parece una cadena hexadecimal de 32 caracteres: a1b2c3d4-e5f6-7890-abcd-ef1234567890.
5. Copiar el cuerpo de la respuesta
   Cambia a la pestaña Respuesta. Copia el texto completo del error, incluido cualquier seguimiento de pila o mensaje de excepción.
6. Tomar una captura de pantalla de la pestaña Red
   Captura toda la pestaña Red mostrando la solicitud fallida y sus encabezados. Incluye la barra de direcciones para que el soporte vea la dirección exacta del sitio.

Pasos para recopilar detalles de errores de SharePoint con PowerShell

Para SharePoint Online, usa el Shell de administración de SharePoint Online. Para SharePoint Server, usa el Shell de administración de SharePoint. PowerShell proporciona acceso a registros que el navegador no puede mostrar.

Conectar a SharePoint Online

1. Instalar el módulo
   Ejecuta Install-Module -Name Microsoft.Online.SharePoint.PowerShell como administrador.
2. Conectar al servicio
   Ejecuta Connect-SPOService -Url https://yourtenant-admin.sharepoint.com e inicia sesión con una cuenta de administrador global.
3. Obtener registros de la colección de sitios
   Ejecuta Get-SPOSite -Identity https://yourtenant.sharepoint.com/sites/siteurl | Select-Object para recuperar las propiedades del sitio. Busca los campos StorageUsageCurrent, LastContentModifiedDate y SharingCapability.
4. Comprobar el estado de la colección de sitios
   Ejecuta Get-SPOSiteHealth -Identity https://yourtenant.sharepoint.com/sites/siteurl para ver advertencias o errores de estado.

Conectar a SharePoint Server

1. Abrir el Shell de administración de SharePoint
   Haz clic derecho y ejecuta como administrador en el servidor de SharePoint.
2. Obtener registros ULS
   Ejecuta Get-SPLogEvent -StartTime (Get-Date).AddMinutes(-30) -EndTime (Get-Date) | Where-Object {$_.Level -eq "Error" -or $_.Level -eq "Critical"} | Export-Csv C:\temp\uls_errors.csv para exportar errores recientes.
3. Obtener el estado de los trabajos de temporizador
   Ejecuta Get-SPTimerJob | Where-Object {$_.Status -eq "Failed"} para identificar trabajos de temporizador fallidos que puedan causar errores en el sitio.

Pasos para recopilar detalles de errores de SharePoint desde el centro de administración

1. Abrir el centro de administración de SharePoint
   Ve a https://admin.microsoft.com y navega al centro de administración de SharePoint o a Centros de administración > SharePoint.
2. Comprobar el estado del servicio
   Haz clic en Estado > Estado del servicio. Busca incidentes o avisos activos para SharePoint Online. Si hay un incidente activo, es probable que el error sea causado por un problema del servicio, no por tu configuración.
3. Revisar los informes de la colección de sitios
   En el centro de administración, ve a Informes > Uso. Exporta el informe de uso del sitio afectado. Este informe muestra almacenamiento, tráfico y actividad de uso compartido que pueden correlacionarse con el error.
4. Comprobar la configuración de uso compartido y permisos
   Ve a Directivas > Uso compartido. Anota si el uso compartido externo está habilitado o restringido. Los errores de permisos a menudo se derivan de directivas de uso compartido que bloquean el acceso de invitados.

Si SharePoint aún muestra mensajes de error vagos después de la recopilación

El error de SharePoint no incluye un ID de correlación

Algunas páginas personalizadas o de terceros de SharePoint suprimen el ID de correlación. En este caso, usa la pestaña Red de las herramientas de desarrollador del navegador como se describió anteriormente para capturar los encabezados de la solicitud. El ID de correlación siempre aparece en los encabezados de respuesta incluso si la página lo oculta.

La conexión de PowerShell falla

Si el Shell de administración de SharePoint Online no puede conectarse, verifica que tu cuenta tenga el rol de administrador global o administrador de SharePoint. También comprueba que la URL del inquilino sea correcta y que no estés detrás de un proxy que bloquee la conexión. Usa Set-ExecutionPolicy RemoteSigned si la ejecución del script está bloqueada.

Los registros ULS son demasiado grandes para buscar

En SharePoint Server, los registros ULS pueden crecer hasta varios gigabytes. Reduce la ventana de tiempo a 15 minutos antes y después del error. Usa el cmdlet Get-SPLogEvent con horas de inicio y fin precisas para reducir el conjunto de resultados.

Herramientas de desarrollador del navegador vs PowerShell: qué proporciona cada una

Elemento	Herramientas de desarrollador del navegador	PowerShell
ID de correlación	Sí, en los encabezados de respuesta	No, no está disponible directamente
Código de estado HTTP	Sí, visible en la pestaña Red	No
Cuerpo de la respuesta con seguimiento de pila	Sí, en la pestaña Respuesta	No
Propiedades de la colección de sitios	No	Sí, mediante Get-SPOSite
Registros ULS (local)	No	Sí, mediante Get-SPLogEvent
Estado del servicio	No	No, usa el centro de administración en su lugar

Conclusión

Ahora puedes recopilar detalles de errores de SharePoint usando las herramientas de desarrollador del navegador, PowerShell y el centro de administración de SharePoint. Comienza siempre con la pestaña Red para capturar el ID de correlación y el código de estado HTTP. Usa PowerShell para recuperar el estado del sitio y los registros ULS en entornos locales. Antes de escalar, exporta el estado del servicio desde el centro de administración para descartar un incidente del servicio de Microsoft. Estos datos reducen el intercambio de mensajes con el soporte y aceleran la resolución de tu problema de SharePoint.