Tracciamento diagnostico e registrazione dei messaggi nell'adattatore SQL

La traccia diagnostica consente di diagnosticare in modo efficace i problemi che possono verificarsi quando si usano gli adattatori. I client adapter possono attivare la traccia diagnostica a due livelli:

  • Tra il client dell'adapter e l'adapter

  • All'interno dell'adattatore

    Questa sezione fornisce informazioni sull'attivazione del tracciamento per questi livelli.

Tracciamento tra il client dell'adapter e l'adapter

I client dell'adattatore possono abilitare il tracing WCF per rilevare i problemi tra il client dell'adattatore e l'adattatore. La traccia WCF viene usata per tracciare il codice XML di input proveniente dal client dell'adattatore usando il modello di servizio WCF ed è utile per diagnosticare i problemi di serializzazione. La traccia WCF non viene utilizzata per il modello di canale WCF o per i messaggi di output dall'adapter al client dell'adapter. È possibile attivare la traccia WCF per le applicazioni BizTalk e le applicazioni modello di servizio WCF aggiungendo un estratto ai rispettivi file di configurazione. È anche possibile abilitare la traccia sia in fase di progettazione che in fase di esecuzione.

  • Tracciamento in fase di progettazione. Per l'esperienza in fase di progettazione, è possibile utilizzare il plug-in "Aggiungi riferimento al servizio adapter", il componente aggiuntivo "Utilizza il servizio adapter" o la procedura guidata "Aggiungi metadati adapter". Tutti questi strumenti possono essere usati da Visual Studio. Per abilitare il tracciamento per l'ambiente di progettazione, è quindi necessario aggiungere l'estratto al file devenv.exe.config che si trova nell'unità<> di installazione:\Program Files\Microsoft Visual Studio <versione>\Common7\IDE.

  • Traccia in fase di esecuzione. Per il tracciamento durante l'esecuzione, è necessario aggiungere l'estratto a seconda dell'applicazione in uso.

    • Per un'applicazione BizTalk Server, è necessario aggiungere l'estratto al file di configurazione BizTalk, in genere BTSNTSvc.exe.config. Per BizTalk Server, questo file è in genere disponibile nell'unità <>di installazione:\Programmi\Microsoft BizTalk Server.

    • Per un'applicazione .NET del modello di servizio WCF, è necessario aggiungere l'estratto al file app.config del progetto.

    Per abilitare la traccia WCF, aggiungere l'estratto seguente all'interno del <configuration> tag .

<system.diagnostics>  
    <sources>  
      <source name ="System.ServiceModel" switchValue="Verbose">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
      <source name ="System.ServiceModel.MessageLogging"   
              switchValue="Verbose, ActivityTracing">          
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
      <source name ="System.Runtime.Serialization" switchValue="Verbose">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
   </sources>  
   <sharedListeners>  
      <add name="xml" type="System.Diagnostics.XmlWriterTraceListener"                
           traceOutputOptions="LogicalOperationStack"   
           initializeData="C:\log\WCFTrace.svclog" />  
   </sharedListeners>  
   <trace autoflush="true" />  
  </system.diagnostics>  
  <system.serviceModel>  
    <diagnostics>  
      <messageLogging   
           logEntireMessage="true"   
           logMalformedMessages="false"  
           logMessagesAtServiceLevel="true"   
           logMessagesAtTransportLevel="false"/>  
    </diagnostics>      
  </system.serviceModel>

In questo modo le tracce WCF vengono salvate in C:\log\WCFTrace.svclog. Per altre informazioni sulla traccia WCF, vedere Traccia.

Importante

Assicurarsi di attenuare le potenziali minacce alla sicurezza dell'esposizione dei dati aziendali sensibili abilitando la traccia. Per indicazioni, vedere Procedure consigliate per proteggere l'adapter SQL.

Tracciamento all'interno dell'adattatore

Gli adapter registrano diverse categorie di informazioni utili per il file di traccia, ad esempio errori, avvisi e messaggi informativi. Tali informazioni sono utili per comprendere il flusso di processo all'interno dell'adapter e diagnosticare i problemi relativi all'adapter. È possibile attivare WCF LOB Adapter SDK e traccia dell'adapter per applicazioni BizTalk e applicazioni modello di servizio WCF aggiungendo un estratto ai rispettivi file di configurazione. È anche possibile abilitare la traccia sia in fase di progettazione che in fase di esecuzione.

  • Traccia in fase di progettazione. Per l'esperienza in fase di progettazione, è possibile utilizzare il plug-in "Aggiungi riferimento al servizio adapter", il componente aggiuntivo "Utilizza il servizio adapter" o la procedura guidata "Aggiungi metadati adapter". Tutti questi strumenti possono essere usati da Visual Studio. Per abilitare il tracciamento per l'ambiente di progettazione, è quindi necessario aggiungere l'estratto al file devenv.exe.config che si trova nell'unità<> di installazione:\Program Files\Microsoft Visual Studio <versione>\Common7\IDE.

  • Traccia in fase di esecuzione. Per il tracciamento durante l'esecuzione, è necessario aggiungere l'estratto a seconda dell'applicazione in uso.

    • Per un'applicazione BizTalk Server, è necessario aggiungere l'estratto al file di configurazione BizTalk, in genere BTSNTSvc.exe.config. Per BizTalk Server, questo file è in genere disponibile nell'unità <>di installazione:\Programmi\Microsoft BizTalk Server.

    • Per un'applicazione .NET del modello di servizio WCF, è necessario aggiungere l'estratto al file app.config del progetto.

    Per abilitare WCF LOB Adapter SDK e traccia dell'adattatore, aggiungere l'estratto seguente all'interno del <configuration> tag .

<system.diagnostics>  
    <sources>  
      <source name="Microsoft.ServiceModel.Channels" switchValue="Error">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
      <source name="Microsoft.Adapters.Sql" switchValue="Information">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="xml" type="System.Diagnostics.XmlWriterTraceListener"   
   traceOutputOptions="LogicalOperationStack"   
          initializeData="C:\log\AdapterTrace.svclog" />  
    </sharedListeners>  
    <trace autoflush="true" />  
  </system.diagnostics>

In questo modo le tracce WCF vengono salvate in C:\log\AdapterTrace.svclog.

Visualizzazione delle tracce

È possibile usare lo strumento Visualizzatore traccia del servizio Windows Communication Foundation (WCF) per visualizzare le tracce. Per altre informazioni sullo strumento, vedere Uso del Visualizzatore traccia del servizio per la visualizzazione di tracce correlate e problemi.

Configurazione del rilevamento per le applicazioni BizTalk

La console di amministrazione di BizTalk Server consente di configurare varie opzioni di rilevamento per elementi quali porte di trasmissione e porte di ricezione. Le impostazioni di configurazione di rilevamento consentono di tenere traccia dei dati degli eventi in ingresso e in uscita, delle proprietà dei messaggi, dei corpi dei messaggi e delle orchestrazioni. Per altre informazioni sulla configurazione del rilevamento per le applicazioni BizTalk, vedere Gestione degli artefatti.

È anche possibile usare Health and Activity Tracking (HAT) per visualizzare i dati cronologici o rilevati. Per altre informazioni, vedere Visualizzazione di dati cronologici e rilevati.

Vedere anche

Risolvere i problemi dell'adapter SQL

  • Last updated on