Introducción al registro de diagnósticos en los Servicios de conectividad empresarial (SharePoint Foundation 2010)

Artículo
01/11/2017

Se aplica a: SharePoint Foundation 2010

Última modificación del tema: 2016-11-30

Puede solucionar problemas relacionados con los Servicios de conectividad empresarial de Microsoft en servidores que ejecutan Microsoft SharePoint Foundation 2010 mediante registros de eventos y registros de seguimiento en cliente o servidor. Además, cada entrada en el registro de eventos o en el registro de seguimiento tiene un identificador de actividad asociado que puede usarse para realizar el seguimiento de un problema desde el servidor hasta el origen de datos externo.

Nota

Además de los métodos de registro que se tratan en este tema, puede usar el Módulo de administración de Microsoft System Center Operations Manager para supervisar una solución basada en los Servicios de conectividad empresarial de Microsoft. Para obtener más información sobre cómo configurar el Módulo de administración de System Center Operations Manager, vea la guía incluida en la descarga del módulo de administración en el módulo de administración de los Productos de Microsoft SharePoint 2010 (https://go.microsoft.com/fwlink/?linkid=184971&clcid=0xC0A).

En este artículo:

Registro de diagnósticos en los Servicios de conectividad empresarial
Acerca de los identificadores de actividad
Registro de diagnósticos en servidores
Ejemplo: uso de registro de diagnósticos

Registro de diagnósticos en los Servicios de conectividad empresarial

Para las soluciones basadas en los Servicios de conectividad empresarial de Microsoft, el registro de diagnósticos tiene lugar en los servidores que ejecutan Microsoft SharePoint Foundation. Hay dos registros: el registro de eventos y el registro de seguimiento. Ambos registran información de diagnóstico que generan los Servicios de conectividad empresarial de Microsoft. Los registros de eventos registran mensajes de error. Los registros de seguimiento contienen información más detallada, como seguimientos de la pila y mensajes informativos. En general, los registros de seguimiento proporcionan más detalles que los registros de eventos.

Cada elemento de información registrado incluye un identificador de actividad que es un valor GUID único. Los valores de identificador de actividad también pueden enviarse a sistemas externos cuando se produce una operación de creación, actualización o eliminación en un elemento. Mediante identificadores de actividad, puede realizarse el seguimiento de una acción desde el servidor o cliente hasta el origen de datos externo. Para obtener más información acerca de los identificadores de actividad, vea Acerca de los identificadores de actividad.

Puede configurar el nivel del registro de diagnóstico para el registro de eventos y el de seguimiento. Esto limitará los tipos y la cantidad de información que se escribirá en cada registro. En la siguiente tabla se definen los niveles de registro disponibles para el registro de eventos y el de seguimiento:

Niveles del registro de eventos

Nivel	Definición
Ninguno	No se realiza un registro.
Tareas críticas	Este tipo de mensaje indica un error grave que produjo un error grave en la solución.
Error	Este tipo de mensaje indica una condición urgente. Se deben investigar todos los eventos de error.
Advertencia	Este tipo de mensaje indica un problema potencial que puede requerir atención. Se deben revisar los mensajes de advertencia y se debe realizar un seguimiento para identificar patrones con el paso del tiempo.
Información	Los mensajes de información no requieren ninguna acción, pero pueden proporcionar datos valiosos para supervisar el estado de su solución.
Detallado	Este nivel de registro de eventos corresponde a eventos o mensajes largos.

Registro de seguimiento

Nivel	Definición
Ninguno	No se escriben registros de seguimiento.
Inesperado	Este nivel se usa para registrar mensajes sobre eventos que hacen que las soluciones dejen de procesar. Si se establece para registrar en este nivel, el registro sólo incluirá eventos en este nivel.
Supervisable	Este nivel se usa para registrar mensajes sobre eventos irrecuperables que limitan la funcionalidad de la solución pero no detienen la aplicación. Si se establece para registrar en este nivel, el registro también incluirá errores graves (nivel inesperado).
Alto	Este nivel se usa para registrar mensajes sobre eventos inesperados pero que no interrumpen el proceso de una solución. Si se establece para registrar en este nivel, el registro incluirá advertencias, errores (nivel supervisable) y errores críticos (nivel inesperado).
Medio	Cuando se establece en este nivel, el registro de seguimiento incluye todo menos los mensajes detallados. Este nivel se usa para registrar información de alto nivel sobre las operaciones que se realizaron. En este nivel, se registran suficientes detalles para construir el flujo de datos y la secuencia de operaciones. Los administradores o profesionales de soporte pueden usar este nivel de registro para solucionar problemas.
Detallado	Cuando se establece para registrar a este nivel, el registro incluye mensajes de todos los otros niveles. Casi todas las acciones que se realizan se registran cuando se usa este nivel. El seguimiento detallado produce muchos mensajes de registro. Generalmente, este nivel se usa para la depuración en un entorno de desarrollo.

Los registros de diagnóstico son útiles para los entornos de desarrollo y producción, pero es probable que los requisitos para el nivel de registro difieran según el tipo de entorno. Cuando planee un registro de diagnóstico en los Servicios de conectividad empresarial de Microsoft, tenga en cuenta las necesidades de la empresa y la etapa del ciclo de vida del entorno antes de configurar el nivel de registro.

Por ejemplo, durante el diseño de la solución, puede, con fines de depuración, establecer ambos niveles de registro en Detallado para capturar todos los mensajes que se generen sobre el estado del sistema. Mientras que, en un entorno de producción, puede desear capturar sólo los mensajes en las categorías Alto, Supervisable e Inesperado para los registros de seguimiento y las categorías Grave y Error para los registros de eventos. De esta forma, se ahorrará espacio en disco para el registro y limitará cualquier efecto negativo en el rendimiento del registro.

Acerca de los identificadores de actividad

Un valor GUID único denominado identificador de actividad se genera para cada operación de creación, actualización o eliminación en datos externos de una solución basada en los Servicios de conectividad empresarial de Microsoft. Todo lo que esté relacionado con la operación que se registra en el registro de seguimiento o en el registro de eventos incluye su valor de identificador de actividad.

Importante

En los archivos de los registros de eventos y del registro de seguimiento del servidor, los valores del identificador de actividad se etiquetan como valores "CorrelationId”.

El valor de identificador de actividad generado para una operación de creación, actualización o eliminación se envía al sistema externo junto con información adicional relacionada con esa operación. Si el sistema externo tiene un mecanismo de registro, este valor puede capturarse y registrarse en ese sistema. Por lo tanto, si una operación genera entradas en los registros de SharePoint, puede realizarse el seguimiento de esa misma operación hasta el sistema externo mediante su valor de identificador de actividad. Esto facilita la solución de problemas de un extremo a otro.

Con frecuencia, una operación como Create hará que se escriban varios eventos en los registros. Cuando esto sucede, se usa el mismo valor del identificador de actividad para todos los eventos registrados para la operación. Esto es útil cuando se desea solucionar problemas, ya que el valor que se repite del identificador de actividad facilita encontrar todos los eventos para una operación particular. Mientras que, cuando el mismo tipo de operación se produce repetidamente, se genera un identificador de actividad único para cada instancia de la operación. Pro ejemplo, si un elemento de un tipo de contenido externo se actualiza dos veces, cada operación de actualización se asociará con un valor de identificador de actividad único.

Sugerencia

En algunos casos, el Servicio de conectividad a datos empresariales reintentará realizar una operación si no pudo ir al sistema externo. En esos casos, se usará el mismo identificador de actividad para la operación que se reintentó.

Registro de diagnósticos en servidores

De forma predeterminada, el registro de los Servicios de conectividad empresarial de Microsoft está habilitado en los servidores de SharePoint Foundation. Los niveles de registro predeterminados son:

Para el registro de eventos: Grave y Error
Para el registro de seguimiento: Medio

Si el registro de diagnóstico de los Servicios de conectividad empresarial de Microsoft fuera deshabilitados, habilítelo seleccionando Servicios de conectividad empresarial en la página Registro de diagnóstico en Administración central de SharePoint Foundation. También puede usar Windows PowerShell para configurar registros de eventos y de seguimiento en el servidor. Por ejemplo, puede cambiar la unidad en la que escribe el registro y puede configurar el nivel de detalle del registro.

Para obtener más información sobre los registros en SharePoint Foundation 2010, como el modo en que se debe configurar la ubicación de los archivos de registro, vea Configuración del registro de diagnósticos (SharePoint Foundation 2010).

Puede usar Windows PowerShell para ver los registros de eventos en el servidor y puede exportar los registros, por ejemplo a un programa de hoja de cálculo. Para obtener más información, vea Visualización de registros de diagnóstico (SharePoint Foundation 2010).

Los Servicios de conectividad empresarial de Microsoft dan como resultado dos tipos de categorías en el registro de seguimiento en los servidores web front-end de SharePoint Foundation: BDC_Shared_Services y SS_Shared_Service. Puede usar el Visor de eventos para abrir el registro de seguimiento y puede filtrar las entradas relevantes del registro buscando “SPS_BusinessData” (para los resultados de Servicios de conectividad empresarial de Microsoft) y “SPS_SecureStoreService”.

Ejemplo: uso de registro de diagnósticos

Este escenario corto y simplificado ilustra el uso del registro de diagnóstico en un entorno de producción. Una empresa implementó una solución de envío de hojas de asistencia basada en los Servicios de conectividad empresarial de Microsoft. La solución usa un sistema externo para almacenar la información de las hojas de asistencia para empleados (como el tiempo de vacaciones y baja por enfermedad) y para interactuar con los empleados y el sistema de nómina cuando los empleados informan sobre una ausencia del trabajo. Los empleados usan un elemento web para interactuar con el sistema.

En la granja de servidores, los niveles de registro están establecidos en los valores predeterminados para los Servicios de conectividad empresarial de Microsoft:

Para el registro de eventos: Grave y Error
Para el registro de seguimiento: Medio

En este escenario, un empleado envía un valor por la cantidad de horas correspondiente a la baja por enfermedad pero ni el empleado ni su jefe reciben un mensaje de correo electrónico de confirmación en el que se informe que el tiempo de baja por enfermedad se envió correctamente. El empleado llama al servicio de soporte técnico interno e informa sobre el problema.

La técnica de soporte reconoce que la aplicación de hojas de asistencia se basa en los Servicios de conectividad empresarial de Microsoft. Comprueba el registro de eventos pero no encuentra ningún error asociado con la identidad del usuario en la hora en la que el usuario envió la solicitud de la hoja de asistencia. Luego, comprueba el registro de seguimiento. Allí encuentra la evidencia de la actividad: una operación Update asociada con el usuario en la hora correcta. En el registro de seguimiento, la operación Update incluye un valor de identificador de actividad que la técnica de soporte observa.

La técnica de soporte sabe que el sistema externo también admite el registro. Usando el identificador de actividad, ubica el elemento registrado en el sistema externo y encuentra evidencia de un error escrito en el registro al final de la operación Update: se produjo un error en la actualización porque el empleado había usado todo el tiempo asignado para bajas por enfermedad. También observa que no hay una entrada de registro que confirme la generación de un mensaje de correo electrónico en el sistema externo inmediatamente al final de la operación Update. La técnica de soporte concluye que hay un error en la lógica de la aplicación de hojas de asistencia. Aunque, como correspondía, la aplicación no asignó un pago por el tiempo de baja por enfermedad cuando el empleado superó la cantidad de horas asignadas, tampoco generó un mensaje de correo electrónico para informar al empleado sobre el problema. La técnica informa sobre el problema al equipo de desarrollo que creó la aplicación y el equipo actualiza la aplicación.

Compartir a través de