Configure el registro de diagnóstico en Servicios unificados

Artículo
07/15/2015

Unified Service Desk y las bibliotecas de soporte técnico subyacentes proporcionan varios niveles de registro de diagnóstico que puede usar para ayudar a solucionar problemas. También puede usar registros de diagnóstico en una implementación de producción de Unified Service Desk para solucionar problemas específicos continuamente.

De forma predeterminada, el registro de errores esté habilitado para la aplicación cliente de Unified Service Desk. Un archivo de registro, UnifiedServiceDesk.log, está disponible en la siguiente ubicación en el equipo cliente para registrar errores operativos en la aplicación cliente: c:\Usuarios\<Nombre de usuario>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Versión>. El archivo de registro se crea la primera vez que se encuentran errores en la aplicación cliente.

En este tema

Configure el registro de diagnóstico

Orígenes de registro de diagnóstico

Niveles de registro de diagnóstico

Agentes de escucha de registro de diagnóstico

Configure el registro de diagnóstico

Puede habilitar el registro mediante el archivo UnifiedServiceDesk.exe.config, que está disponible en el directorio de instalación del cliente de Unified Service Desk en su equipo. Para configurar el tipo de registro y la ubicación del archivo de registro de Unified Service Desk:

Abra el archivo UnifiedServiceDesk.exe.config para editarlo. Si instaló el cliente de Unified Service Desk en la ubicación predeterminada, este archivo suele estar disponible en C:\Archivos de programa\Microsoft Dynamics CRM USD\USD.

Acceda a la sección <switches> del archivo:

<switches>
<!-- 
     Possible values for switches: Off, Error, Warning, Information, Verbose
        Verbose:      includes Error, Warning, Info, Trace levels
        Information:  includes Error, Warning, Info levels
        Warning:      includes Error, Warning levels
        Error:        includes Error level
 -->
    <add name="EventTopicSwitch" value="Error"/>
    <add name="Microsoft.Uii.Common.Logging" value="Error"/>
    <add name="Microsoft.Xrm.Tooling.CrmConnectControl" value="Error"/>
    <add name="Microsoft.Xrm.Tooling.Connector.CrmServiceClient" value="Error"/>
    <add name="Microsoft.Xrm.Tooling.WebResourceUtility" value="Error"/>
    <add name="Microsoft.Crm.UnifiedServiceDesk" value="Error"/>
    <add name="Microsoft.Crm.UnifiedServiceDesk.Dynamics" value="Error"/>
    <add name="Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager" value="Error"/>
    <add name="UnifiedServiceDesk.KPIControl" value="Error"/>
</switches>

En la sección de <switches>, especifique un origen de registro (como EventTopicSwitch), y después especifique un valor de nivel de registro (como Error). La sección de <switches> controla los niveles de registro para diversos orígenes. De forma predeterminada, el registro de errores está habilitado para todos los conmutadores:
- Para obtener información acerca de los orígenes de registro disponibles, consulte Orígenes de registro de diagnóstico más adelante en este tema.
- Para obtener información acerca de los valores que puede especificar para cada origen de registro, consulte Niveles de registro de diagnóstico más adelante en este tema.
Para configurar la ubicación de los archivos de registro, desplácese hasta la sección de <shareListeners> en el archivo:
```
<sharedListeners>
    <add name="fileListener"
        type="Microsoft.Xrm.Tooling.Connector.DynamicsFileLogTraceListener, Microsoft.Xrm.Tooling.Connector"
            BaseFileName="UnifiedServiceDesk"
                Location="LocalUserApplicationDirectory"
        />
    <add name="USDDebugListener" type="Microsoft.Crm.UnifiedServiceDesk.Dynamics.UsdTraceListener, Microsoft.Crm.UnifiedServiceDesk.Dynamics" />
</sharedListeners>
```
La sección de <sharelisteners> controla la ubicación y el tipo de registros que se generan para Unified Service Desk. De forma predeterminada, fileListener creará un archivo llamado UnifiedServiceDesk.log en el directorio c:\Usuarios\<Nombre de usuario>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Versión> y USDDebugListener creará eventos en la pestaña Pestaña Resultados de depuración del control hospedado de depurador.
Si desea cambiar la ubicación del archivo UnifiedServiceDesk.log, cambie el valor del parámetro Location.
De manera predeterminada, el registro del archivo y depurador está habilitado para todos los orígenes. Si desea agregar o quitar un agente de escucha de un origen de diagnóstico, busque el origen requerido en la sección <sources> y, a continuación, modifique la sección <listeners> del origen para incluir el agente de escucha que desee.

Por ejemplo, para agregar registro de eventos para Unified Service Desk, agregue el atente de escucha de registro de eventos al origen de Microsoft.Crm.UnifiedServiceDesk:
```
<source name="Microsoft.Crm.UnifiedServiceDesk" switchName="Microsoft.Crm.UnifiedServiceDesk" switchType="System.Diagnostics.SourceSwitch">
    <listeners>
        <add name="fileListener"/>
        <add name="USDDebugListener" />
        <add name="eventLogListener" type="System.Diagnostics.EventLogTraceListener" initializeData="USD"/>
    </listeners>
</source>
```
Esto notificará eventos al registro de eventos de Windows con la etiqueta "USD", además del archivo y depurador. Para obtener más información sobre agentes de escucha de diagnóstico, consulte Agentes de escucha de registro de diagnóstico más adelante en este tema.

Orígenes de registro de diagnóstico

En la tabla siguiente se muestran orígenes de registro de solución de problemas comunes.

Nombre de origen	Descripción
EventTopicSwitch	Origen de registro detallado de User Interface Integration (UII) para supervisar tráfico de mensajería en UII.
Microsoft.Uii.Common.Logging	Origen de registro de UII general para mensajes notificados por UII.
Microsoft.Xrm.Tooling.CrmConnectControl	Origen del registro para el proceso de inicio de sesión en CRM. Este origen notificará información de diagnóstico general o detallada acerca del procedimiento de inicio de sesión.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Origen del registro para todas las interacciones a nivel de datos de CRM. Este origen notificará todas las interacciones con CRM, excepciones y controles de tiempo.
Microsoft.Xrm.Tooling.WebResourceUtility	Origen del registro para solicitudes de datos de Recurso web mediante el vínculo de la interfaz de CRM.
Microsoft.Crm.UnifiedServiceDesk	Origen del registro para la funcionalidad básica de Unified Service Desk. Este origen de registro notificará acciones y eventos que son básicos para Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Origen del registro para el procesador de carga y arranque de Unified Service Desk. Este origen notificará acciones y eventos que forman parte de la inicialización y el inicio de UII y Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Origen del registro para acciones que interactúan con el sistema de UserProfile; forma parte del sistema de almacenamiento en caché. Más información: Configure la memoria caché del cliente en Servicios unificados

Puede alternar cada uno de estos orígenes del registro independientemente para admitir la solución de problemas y el aislamiento de problemas o la información de Unified Service Desk.

Niveles de registro de diagnóstico

Existen varios niveles de registro distintos disponibles para su uso. Sin embargo, cuando aumenta el nivel de registro, se generan y almacenan más datos en los archivos de registro.

Nivel de registro	Descripción
Desconectado	Deshabilita todos los eventos de este origen.
Error	Notifica solo eventos de error.
Advertencia	Notifica errores y eventos de advertencia.
Información	Notifica errores, advertencias y eventos de información.
Detallado	Notifica errores, advertencias, información y eventos detallados.
ActivityTracing	Notifica informes, advertencias, información y eventos detallados, así como seguimiento de actividad (nombres de método). Nota ActivityTracing solo está disponible en algunos de los orígenes.
Todo	Notifica todos los eventos generados por el sistema.

Agentes de escucha de registro de diagnóstico

Los agentes de escucha de registro de diagnóstico se utilizan para enviar la salida del registro diagnóstico a archivos, al registro de eventos o a otros orígenes. De forma predeterminada, todos los orígenes de diagnóstico se conectan a agentes de escucha predeterminados (depurador) y de archivo (texto). Puede configurar agentes de escucha de registro adicionales para el registro de diagnóstico de Unified Service Desk. Para obtener más información acerca de los agentes de escucha predeterminados de .NET, consulte:

También puede crear agentes de escucha personalizados para enviar los registros de diagnóstico a la ubicación que elija. Los agentes de escucha personalizados se crean derivando una clase de la clase abstracta TraceListener. Puede buscar un tutorial del proceso en CodeGuru.com.

Vea también

Conceptos

Depurar problemas en Servicios unificados

Otros recursos

Resolución de problemas de Servicios unificados utilizando el depurador y registro de diagnóstico

Compartir a través de

Configure el registro de diagnóstico en Servicios unificados

En este tema

Configure el registro de diagnóstico

Orígenes de registro de diagnóstico

Niveles de registro de diagnóstico

Agentes de escucha de registro de diagnóstico

Vea también

Conceptos

Otros recursos

Recursos adicionales