Compartir a través de

Cómo diagnosticar problemas con los adaptadores de WCF

  • Artículo

Esta sección contiene los pasos que pueden seguirse para ayudar al diagnóstico de problemas con los adaptadores de WCF.

Compruebe si existen errores detallados en el registro IIS y HTTPERR del servidor IIS

  • Los archivos de registro del servidor IIS de origen o de destino pueden contener información útil para la solución de problemas con los adaptadores de WCF aislados. De forma predeterminada, los archivos de registro de IIS en un equipo con Windows Server se encuentran en el siguiente directorio:

    %WinDir%\system32\LogFiles\W3SVC1\

    Nota

    %WinDir% es un marcador de posición para la ubicación del directorio de Windows en el servidor IIS.

    De forma predeterminada, los archivos de registro HTTPERR en equipos basados en Windows Server 2003 y Windows Server 2008 SP2 se encuentran en el directorio siguiente:

    Nota

    El archivo de registro HTTPERR solo está disponible en equipos basados en Windows Server 2003 y Windows Server 2008 SP2.

    %WinDir%\system32\LogFiles\HTTPERR\

Utilizar el registro de mensajes WCF para la supervisión de los errores y el diagnóstico de problemas derivados de los adaptadores de WCF

  1. WCF ofrece la posibilidad de registrar los mensajes entrantes y salientes para el consumo fuera de línea. Puede utilizar el registro de mensajes para ver qué aspecto tienen los mensajes entrantes y salientes a través de los adaptadores de WCF. WCF no registra los mensajes de forma predeterminada. Para activar el registro de mensajes, debe modificar los archivos de configuración que utilizan los adaptadores de WCF. Para obtener más información sobre el registro de mensajes WCF, vea "Registro de mensajes" en https://go.microsoft.com/fwlink/?LinkId=89003.

  2. Para los adaptadores WCF en proceso, puede habilitar el registro de mensajes WCF modificando el archivo de configuración de la aplicación, BTSNtSvc.exe.config, para BTSNtSvc.exe. El archivo de configuración se puede encontrar en la ruta de acceso de instalación de BizTalk Server. Si instaló BizTalk Server en la ubicación predeterminada, BtsNtSvc.exe estará en el directorio \Archivos de programa (x86)\Microsoft BizTalk Server <VERSION>.

  3. Para los adaptadores WCF aislados, puede habilitar el registro de mensajes WCF modificando el archivo deWeb.config que crea el Asistente para publicación de servicios WCF de BizTalk en la carpeta de la aplicación web.

  4. Para modificar BTSNtSvc.exe.config o Web.config, abra el archivo de configuración mediante el Bloc de notas y, a continuación, configure el registro de mensajes WCF, como se indica en el ejemplo de configuración siguiente:

    <configuration>
  <system.serviceModel>
    <diagnostics>
      <messageLogging
           logEntireMessage="true"
           logMalformedMessages="false"
           logMessagesAtServiceLevel="true"
           logMessagesAtTransportLevel="true"
           maxMessagesToLog="300000"
           maxSizeOfMessageToLog="200000"
    />
    </diagnostics>
  </system.serviceModel>

  <system.diagnostics>
    <sources>
      <source name="System.ServiceModel.MessageLogging">
        <listeners>
          <add name="messages"
          type="System.Diagnostics.XmlWriterTraceListener"
          initializeData="c:\wcfTrace.e2e" />
        </listeners>
      </source>
    </sources>
  </system.diagnostics>
</configuration>

  5. Puede utilizar la herramienta Service Trace Viewer de Windows Communication Foundation (WCF) para analizar los mensajes registrados por WCF. El Visor de seguimiento del servicio se incluye en el Kit de desarrollo de software (SDK) de Microsoft Windows para Windows Vista y componentes en tiempo de ejecución de .NET Framework. Puede descargar Windows SDK desde el Centro de descarga de Microsoft. Para obtener más información sobre el uso de esta herramienta, vea "Service Trace Viewer Tool (SvcTraceViewer.exe)"at https://go.microsoft.com/fwlink/?LinkId=88991.

Devolver información de excepción administrada al cliente si se produce un error de SOAP para una depuración sencilla.

  1. Puede seleccionar la opción Incluir excepción en errores para la ubicación de recepción estándar de WCF para devolver información de excepción administrada al cliente en errores SOAP para facilitar la depuración. Siga estos pasos para seleccionar la opción Incluir excepción en errores .

    1. En la consola de administración de BizTalk Server, expanda BizTalk ServerAdministración, expanda Grupo de BizTalk, Aplicaciones, Expanda Ubicaciones de recepción, haga clic con el botón derecho en una ubicación de recepción con un adaptador WCF estándar y, a continuación, haga clic en Propiedades.

    2. En el cuadro de diálogo Propiedades de ubicación de recepción , haga clic en Configurar.

    3. En el cuadro de diálogo de transporte, en la pestaña Mensajes , seleccione la opción Incluir excepción en errores .

  2. Si usa el WCF-Custom o el adaptador de WCF-CustomIsolated, puede establecer la propiedad IncludeExceptionDetailInFaults de ServiceDebugElement para devolver información de excepción administrada al cliente. Para ello, siga estos pasos:

    1. En la consola de administración de BizTalk Server, expanda BizTalk ServerAdministración, expanda Grupo de BizTalk, Expanda Aplicaciones, Expanda Ubicaciones de recepción, haga clic con el botón derecho en una ubicación de recepción mediante el WCF-Custom o el adaptador de WCF-CustomIsolated y, a continuación, haga clic en Propiedades.

    2. En el cuadro de diálogo Propiedades de ubicación de recepción , haga clic en Configurar.

    3. En el cuadro de diálogo transporte, en la pestaña Comportamiento , haga clic con el botón derecho en el nodo ServiceBehavior y, a continuación, haga clic en Agregar extensión.

    4. En el cuadro de diálogo Seleccionar extensión de comportamiento , seleccione serviceDebug y, a continuación, haga clic en Aceptar.

    5. En el cuadro de diálogo de transporte, en la pestaña Comportamiento , haga clic en el nodo serviceDebug y, a continuación, seleccione True para la propiedad includeExceptionDetail en la vista de lista Configuración .

    Nota

    Devolver la información de excepción administrada a los clientes puede suponer un riesgo para la seguridad porque los datos de la excepción exponen información sobre la implementación de servicio interna que los clientes desautorizados podrían utilizar.

Consulte también

Herramientas y utilidades que se usarán para solucionar problemas de solución de problemasde los adaptadores de WCFBTSNTSvc.exe.config archivo