Id. de correlación de SharePoint en los mensajes de error: qué es y cómo usarlo

Se aplica a
SharePoint Server 2016

Si es un usuario que tiene problemas con un sitio web público o una encuesta, correo electrónico u otra aplicación, llame a la empresa propietaria del sitio web y pídale ayuda.Por lo general, puede encontrar información de contacto de un sitio web o encuesta en la parte inferior de una página o en las secciones Acerca de o Contacto de sus menús de navegación.

Si es usuario de una empresa y recibe errores, póngase en contacto con la persona que administra el sitio web interno de su empresa.A menudo, estos tipos de problemas solo los puede corregir el webmaster (administrador de SharePoint) o alguien de su empresa.

Si es administrador de SharePoint, administrador web o administrador de sitio, y los usuarios hacen preguntas sobre los id. de correlación, este artículo puede ayudarle.

Qué es un id. de correlación y qué no

El id. de correlación no es un código o número de error. Simplemente, es un GUID (identificador único global) que se genera automáticamente para cada solicitud que recibe el servidor de SharePoint. Es único para cada solicitud, no para cada error. Sin embargo, cuando se produce un error, el mensaje contiene el id. de correlación válido para la solicitud en ese momento.

El id. de correlación está diseñado para usarse para ayudar a un Administrador de SharePoint a realizar un seguimiento de lo que estaba sucediendo en el momento de un error. Solo es valioso como herramienta interactiva para ayudar a los administradores a localizar el error. Una Administración usa el id. de correlación como "rutas de navegación" para volver a rastrear solicitudes o procesos en elsistema de registro unificado de SharePoint (ULS) para buscar lo que conduce a un problema y lo causa. Si SharePoint obtiene un error que no puede identificar mientras trabaja en esa tarea, publica el mensaje "Se ha producido un error inesperado" e incluye el id. de correlación. El id. de correlación puede ayudar a determinar qué ha ocurrido, pero no identifica lo que ha ocurrido.

Diagrama de cómo se asigna un id. de correlación Las solicitudes correctas se etiquetan con un Id. de correlación; también lo son las erróneas. El id. es único y diferente para cada nueva solicitud y solo dura la duración de la solicitud. No es como un error de Windows que le da un número 80xxxxxx que identifica el problema exacto. No ayuda a buscar un id. de correlación específico en la Web, ya que cada uno es diferente y único para su servidor en ese momento en el tiempo.

Donde un id. de correlación es valioso para realizar el seguimiento de un proceso. SharePoint crea un registro (ULS) de todo lo que hace al procesar solicitudes y el Id. de correlación es básicamente el subproceso que une cada paso. Dado que SharePoint realiza miles de solicitudes al mismo tiempo, el Id. de correlación se puede usar para filtrar solo los pasos que SharePoint estaba realizando para cualquier solicitud determinada.

Una Administración puede usar un id. de correlación para rastrear errores, así como problemas de rendimiento y otros problemas. Mediante el uso de los identificadores de correlación para las solicitudes que muestran el comportamiento problemático, pueden investigar más a fondo. Si no se produce ningún error y no se está generando ningún mensaje de error, el panel de desarrollador se puede usar para ver el id. de correlación generado por los procesos.

Cómo usar un id. de correlación

Si es un usuario final, probablemente no tendrá acceso a los registros que proporcionan la información en la que un id. de correlación puede ser útil. En este caso, puede detenerse aquí y llamar a su departamento de soporte técnico o Administración. Explica el problema y trabaja con ellos para ayudar a diagnosticarlo. Proporcióneles el id. de correlación que ve en el mensaje de error, ya que es posible que lo necesiten.

Como profesional de TI o administrador, para averiguar qué ha ocurrido, debe buscar los registros ULS para el momento en que se produjo el evento y buscar el Id. de correlación en esos registros. Es posible que tenga que buscar en varios de los front-end de la web para encontrar el que tiene el Id. de correlación que está buscando. El id. de correlación no resolverá el error, pero puede ayudarle a rastrear una solicitud para ver qué ha fallado. Es posible que obtenga información sobre lo que ocurrió justo antes de que se generara el error, qué mensajes de error aparecían o qué eventos se desencadenaron debido a este error (si procede). Puede utilizar una herramienta como ULSViewer para facilitar la consulta de estos datos y filtrar las solicitudes que no necesita ver. Consulte la entrada de blog de SharePoint logging and troubleshooting using ULSViewer (Registro de SharePoint y solución de problemas con ULSViewer ) para obtener más ideas y sugerencias.

Este es un escenario típico que usará un administrador al usar un id. de correlación:

  • El usuario recibe un error al abrir un archivo en Excel, que proporciona al administrador el Id. de correlación y la fecha y hora del incidente:
  • Busque el directorio de registro y la fecha que busca y abra ese archivo en Excel:
  • Busque el id. de correlación que está buscando. También puede filtrar por el nivel de los eventos para hacerse una idea de lo que está sucediendo:
  • Si no encuentra el id. de correlación, pruebe con otro servidor web que estuviera rotando en el momento en que se notidicó el problema.

Más información

Estos son algunos recursos adicionales de administración para ayudarle a depurar errores de SharePoint. Además de estos vínculos, pruebe a buscar en la Web, ya que hay muchos sitios y comunidades de terceros que ofrecen soporte técnico y herramientas para trabajar con SharePoint. Como SharePoint es una plataforma, hay una comunidad de miles de desarrolladores, profesionales de TI y usuarios que desarrollan herramientas, aplicaciones y documentación para ayudarse entre sí.