Introducción al registro del sistema de creación de registros unificado (ULS)

Última modificación: jueves, 15 de abril de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
¿Qué proporciona el registro de ULS?
¿Cuándo debe un programador usar los registros de ULS?
¿Cómo manipula un programador los registros de ULS?

Una estrategia efectiva de registro ha sido reconocida durante mucho tiempo por los administradores del sistema como una forma de realizar un seguimiento de los problemas con componentes y aplicaciones, proporcionar estadísticas cuantificables para el historial de una aplicación, ayudar a solucionar problemas, así como ayudar a supervisar el estado general de los sistemas de los que los administradores son responsables.

En este tema se explica cómo un programador puede usar los mecanismos de registro proporcionados por Microsoft SharePoint Foundation para facilitar el desarrollo de aplicaciones, proporcionar información más detallada para la depuración y comunicarse con los administradores del sistema cuando se detecta un problema o se alcanza un umbral. El mecanismo principal es el Servicio de creación de registros unificado (ULS), que escribe eventos de SharePoint Foundation en el registro de seguimiento de SharePoint y los almacena en el sistema de archivos. (Nota: los registros de ULS a veces también se conocen como registros de seguimiento).

¿Qué proporciona el registro de ULS?

El registro de ULS, cuando se implementa de forma eficaz, puede proporcionar información muy útil para los siguientes destinatarios.

Para los programadores

Los programadores pueden aprovechar el registro de seguimiento al desarrollar código. Use registros de seguimiento como una extensión de las herramientas de desarrollo y como otra herramienta de depuración, que le ayudarán a investigar los problemas. Si se asegura de que se escribe información útil en el registro de seguimiento, se pueden resolver muchos problemas que surgen en el desarrollo sin asociar un depurador. Además, un ingeniero de pruebas puede revisar los registros de seguimiento para detectar problemas que no estén visibles en la interfaz de usuario y puede usar registros de seguimiento para comprobar la finalización de las tareas de ejecución prolongada que no tienen ninguna interfaz de usuario asociada a las acciones.

Otra ventaja del registro de ULS para los programadores es que los problemas detectados en la interfaz de usuario o las notificaciones no tienen que mostrarse en la interfaz de usuario. En su lugar, se pueden escribir en la base de datos para que los administradores y programadores las revisen y analicen.

Para los administradores del servidor

Para que un mensaje de registro de eventos sea importante para el administrador del sistema, debe contener suficiente información y metadatos para permitir que el administrador del sistema determine qué acción es necesaria, dónde se necesita la acción y por qué se requiere. Otra información contextual útil que podría incluirse en el registro de eventos puede ser el usuario que inició la acción. Obviamente, la supervisión y el rendimiento del servidor es muy importante para que el entorno empresarial se realice correctamente, y el registro de ULS puede ayudar a los administradores a ajustar bien el rendimiento del sistema después de una implementación.

Para el personal de soporte técnico

Cuando se produce un problema que se debe resolver rápidamente mediante el uso de los servicios de soporte al cliente de Microsoft, los registros de ULS pueden proporcionar información detallada acerca del problema a un grupo de soporte técnico para permitir una resolución más rápida.

Nota de precauciónPrecaución

Tenga en cuenta que, por lo general, el texto de registro no tiene la seguridad adecuada. Por lo tanto, al crear mensajes de registro, asegúrese de que no se incluye información confidencial sobre la compañía o información personal que se escriba en los registros.

¿Cuándo debe un programador usar los registros de ULS?

En general, cuanta más información pueda proporcionar un programador sobre su código, más fácil será resolver problemas que puedan surgir.

¿Cómo manipula un programador los registros de ULS?

En SharePoint Foundation, ULS expone los parámetros configurables de dos maneras, mediante el:

  • Modelo de objetos

  • Cmdlets de Windows PowerShell

Modelo de objetos y registros de ULS

En Windows SharePoint Services 3.0, el acceso a los registros de ULS se proporcionaba mediante la interfaz de IDiagnosticsManager. Sin embargo, en SharePoint Foundation se recomienda usar la clase SPDiagnosticsServiceBase. La clase SPDiagnosticsServiceBase encapsula todas las llamadas a la clase IDiagnosticsManager, lo que facilita a los programadores la interacción con registros de eventos. Este método permite escribir directamente en el servicio de seguimiento.

Para obtener más información sobre cómo usar el modelo de objetos para manipular registros de ULS, vea Uso de la API del registro de seguimiento

Windows PowerShell y registros de ULS

Para obtener más información sobre cómo escribir cmdlets de Windows PowerShell en SharePoint Foundation para manipular los registros de ULS, vea Uso de cmdlets de Windows PowerShell con el registro de ULS