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

Artículo
12/13/2016

Se aplica a: SharePoint Server 2010

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

Puede solucionar problemas relacionados con Servicios de conectividad empresarial de Microsoft en servidores que ejecutan Microsoft SharePoint Server 2010 y en las aplicaciones cliente de Microsoft Office 2010 mediante registros de eventos y registros de seguimiento en el 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 se puede usar para realizar un seguimiento de un problema desde el cliente o 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óstico en los Servicios de conectividad empresarial
Acerca de los identificadores de actividad
Registro de diagnóstico en servidores
Registro de diagnóstico en clientes de Office 2010
Ejemplo: uso de registro de diagnóstico

Registro de diagnóstico en los Servicios de conectividad empresarial

Para las soluciones que se basan en Servicios de conectividad empresarial de Microsoft, se produce el registro de diagnóstico en servidores que ejecutan SharePoint Server 2010 y en los clientes de Office 2010. Existen dos registros: el registro de eventos y el registro de seguimiento. Ambos registran información de diagnóstico que genera Servicios de conectividad empresarial de Microsoft. Los registros de eventos graban mensajes de error. Los registros de seguimiento contienen más información detallada, como seguimientos de la pila y mensajes informativos. En general, los registros de seguimiento ofrecen 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 se pueden enviar a sistemas externos cuando tiene lugar una operación de creación, actualización o eliminación en un elemento. Mediante el uso de identificadores de actividad, una acción se puede seguir desde el servidor o cliente hasta el origen de datos externo. Para obtener más información acerca de los identificadores de actividad, vea el tema sobre 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

Se genera un valor GUID único llamado identificador de actividad en el servidor y el cliente de Office para cada operación de creación, actualización o eliminación de datos externos en una solución basada en Servicios de conectividad empresarial de Microsoft. Todo lo 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 otra información 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 produce entradas en el servidor de SharePoint o en los registros del cliente de Office, la misma operación puede seguirse hasta el sistema externo usando 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óstico en servidores

De forma predeterminada, el registro de los Servicios de conectividad empresarial de Microsoft está habilitado en los servidores de SharePoint Server. 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 Server. 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 Server, como el modo en que se debe configurar la ubicación de los archivos de registro, vea Configuración del registro de diagnóstico (SharePoint Server 2010).

Puede usar Windows PowerShell para ver los registros de eventos en el servidor y se pueden exportar los registros, por ejemplo a un programa de hojas de cálculo. Para obtener más información, vea Visualización de registros de diagnóstico (SharePoint Server 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 Server: 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”.

Registro de diagnóstico en clientes de Office 2010

Hay disponibles registros de eventos y registros de seguimiento para soluciones de Servicios de conectividad empresarial de Microsoft en clientes de Conjuntos de aplicaciones de Microsoft Office 2010 que usan la infraestructura de Servicios de conectividad empresarial de Microsoft. De forma predeterminada, está habilitado el registro de eventos para Servicios de conectividad empresarial de Microsoft en los clientes. Sin embargo, para proteger el rendimiento, se registran solo errores y errores críticos y no se puede cambiar esta configuración. Los equipos cliente de Windows incluyen un visor de eventos que se puede usar para ver registros de eventos. Para obtener información acerca de cómo ver los registros de eventos para una versión específica de Windows, consulte la documentación del producto.

El registro de seguimiento está deshabilitado de forma predeterminada en los equipos cliente para ayudar a mejorar el rendimiento. Solo debe habilitar el registro de seguimiento en los equipos cliente si encuentra problemas que desea diagnosticar. Por ejemplo, si una entrada del registro de eventos indica que un error puede deberse a una actividad que está relacionada con Servicios de conectividad empresarial de Microsoft, habilite el registro de seguimiento para recopilar datos adicionales la próxima vez que se produzca el evento.

El método para habilitar el registro de seguimiento y leer los registros varía según la versión de Windows que usa el equipo. Por ejemplo, en los equipos que ejecutan Windows XP, habilite el seguimiento mediante la ejecución de un script que use el comando logman. En Windows Vista y posteriores, hay disponibles herramientas del sistema como Monitor de rendimiento y confiabilidad, además del comando logman. Consulte la documentación de producto de Windows para obtener información detallada acerca de cómo habilitar el seguimiento y cómo capturar los resultados.

El siguiente script de ejemplo usa el comando logman para habilitar el registro de seguimiento:

rem This script will enable logging, directing log messages to a file specified by the "%FILE_NAME%" given by the user.

@setlocal
@echo off
pushd %~dp0
set PATH_NAME=%TEMP%\BCS
set FILE_NAME=%PATH_NAME%\ETWTraceLog
set TRACE_COLLECTION=BCS
::tracelog -start BCS -guid #b8622a02-c377-46b1-b861-38a787a8e44a -b 128 -flags 0xFFFF -level 5 -f "%FILE_NAME%.etl"
md "%PATH_NAME%" 1>nul 2>nul
logman create trace %TRACE_COLLECTION% -p "{b8622a02-c377-46b1-b861-38a787a8e44a}" 0xFFFF 5 -o "%FILE_NAME%.etl" -ets
echo.
echo Business Connectivity Services tracing has been started. To end press any key.
echo.
pause

Al igual que en el servidor, se genera un valor de identificador de actividad único para cada operación de creación, actualización o eliminación de un elemento del cliente. Estos valores se graban en los registros y se envían a sistemas externos junto con otra información acerca de las operaciones. Además, puede configurarse una solución para que se muestren los valores de identificación de actividad en los mensajes de error. Esto facilita la solución de los problemas que experimentan los usuarios de la solución.

Importante

Debido a que la versión requerida de la interfaz de programación de Seguimiento de eventos para Windows de la que depende la generación de los identificadores de actividad no está disponible en el sistema operativo Windows XP, no se admite la generación de identificadores de actividad en los clientes que ejecuten este sistema operativo.

Ejemplo: uso de registro de diagnóstico

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.