Come diagnosticare i problemi relativi agli adapter WCF

Articolo
10/19/2023

In questa sezione sono disponibili informazioni utili per diagnosticare i problemi relativi agli adapter WCF.

Controllare se nei registri IIS e HTTPERR del server IIS sono segnalati errori

I file di registro del server IIS di origine o di destinazione possono contenere informazioni utili per risolvere i problemi relativi agli adapter WCF isolati. Per impostazione predefinita, i file di log IIS in un computer Windows Server si trovano nella directory seguente:

%WinDir%\system32\LogFiles\W3SVC1\

Nota

%WinDir% è un segnaposto per il percorso della directory di Windows nel server IIS.

Per impostazione predefinita, i file di log HTTPERR in un computer basato su Windows Server 2003 e Windows Server 2008 SP2 si trovano nella directory seguente:

Nota

Il file di log HTTPERR è disponibile solo nei computer basati su Windows Server 2003 e Windows Server 2008 SP2.

%WinDir%\system32\LogFiles\HTTPERR\

Utilizzare la registrazione dei messaggi WCF per il monitoraggio degli errori e la diagnosi dei problemi relativi agli adapter WCF

WCF consente di registrare i messaggi in arrivo e in uscita per l'utilizzo offline. È possibile utilizzare la registrazione dei messaggi per conoscere l'aspetto dei messaggi in arrivo e in uscita tramite gli adapter WCF. WCF non registra i messaggi per impostazione predefinita. Per attivare la registrazione dei messaggi, è necessario modificare i file di configurazione utilizzati dagli adapter WCF. Per altre informazioni sulla registrazione dei messaggi WCF, vedere "Registrazione messaggi" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=89003.
Per gli adapter WCF in-process, è possibile abilitare la registrazione dei messaggi WCF modificando il file di configurazione dell'applicazione ,BTSNtSvc.exe.config, per BTSNtSvc.exe. Il file di configurazione è disponibile nel percorso di installazione BizTalk Server. Se è stato installato BizTalk Server nel percorso predefinito, BtsNtSvc.exe si troverà nella directory \Programmi (x86)\Microsoft BizTalk Server <VERSION>.
Per gli adapter WCF isolati, è possibile abilitare la registrazione dei messaggi WCF modificando il file diWeb.config creato dalla Pubblicazione guidata servizio WCF BizTalk nella cartella dell'applicazione Web.

Per modificare BTSNtSvc.exe.config o Web.config, aprire il file di configurazione tramite Blocco note e quindi configurare la registrazione dei messaggi WCF, come indicato nell'esempio di configurazione seguente:

<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>

Per analizzare i messaggi registrati da WCF, è possibile utilizzare lo strumento Service Trace Viewer di Windows Communication Foundation (WCF). Service Trace Viewer è incluso in Microsoft Windows Software Development Kit (SDK) per i componenti di runtime di Windows Vista e .NET Framework. È possibile scaricare Windows SDK dall'Area download Microsoft. Per altre informazioni sull'uso di questo strumento, vedere "Service Trace Viewer Tool (SvcTraceViewer.exe)" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=88991.

Restituire informazioni sulle eccezioni gestite al client in un errore SOAP per facilitare il debug

È possibile selezionare l'opzione Includi eccezione negli errori per il percorso di ricezione WCF standard per restituire informazioni sulle eccezioni gestite al client in errori SOAP per semplificare il debug. Usare la procedura seguente per selezionare l'opzione Includi eccezione in errori .
1. Nella console di amministrazione di BizTalk Server espandere BizTalk ServerAmministrazione, espandere Gruppo BizTalk, espandere Applicazioni, indirizzi di ricezione, fare clic con il pulsante destro del mouse su un percorso di ricezione usando una scheda WCF standard e quindi scegliere Proprietà.
2. Nella finestra di dialogo Proprietà posizione di ricezione fare clic su Configura.
3. Nella scheda Messaggi della finestra di dialogo trasporto selezionare l'opzione Includi eccezione in errori .
Se si utilizza la WCF-Custom o l'adattatore WCF-CustomIsolated, è possibile impostare la proprietà IncludeExceptionDetailInFaults di ServiceDebugElement per restituire informazioni sulle eccezioni gestite al client. A tale scopo, seguire questa procedura:
1. Nella console di amministrazione di BizTalk Server espandere BizTalk ServerAmministrazione, espandere Gruppo BizTalk, espandere Applicazioni, Località di ricezione, fare clic con il pulsante destro del mouse su un percorso di ricezione usando il WCF-Custom o l'adattatore WCF-CustomIsolated, quindi scegliere Proprietà.
2. Nella finestra di dialogo Proprietà posizione di ricezione fare clic su Configura.
3. Nella scheda Comportamento della finestra di dialogo trasporto fare clic con il pulsante destro del mouse sul nodo ServiceBehavior e quindi scegliere Aggiungi estensione.
4. Nella finestra di dialogo Seleziona estensione comportamento selezionare serviceDebug e quindi fare clic su OK.
5. Nella scheda Comportamento della finestra di dialogo trasporto fare clic sul nodo serviceDebug e quindi selezionare True per la proprietà includeExceptionDetail nella visualizzazione Elenco configurazione .
Nota

La restituzione ai client delle informazioni sulle eccezioni gestite può rappresentare un rischio per la sicurezza, poiché i dettagli delle eccezioni espongono informazioni sull'implementazione del servizio interno che potrebbero essere usate da client non autorizzati.

Vedere anche

Strumenti e utilità da usare per la risoluzione dei problemi relativi agli adapter WCF BTSNTSvc.exe.config File

Condividi tramite