Traccia diagnostica e registrazione dei messaggi per l'adapter Oracle Database
La traccia diagnostica consente di diagnosticare in modo efficace i problemi che possono verificarsi quando si usano gli adattatori. In questo argomento vengono fornite informazioni sui due tipi di traccia seguenti supportati con l'adapter Microsoft BizTalk per Oracle Database:
Traccia WCF tra il client dell'adapter e l'adapter
Traccia WCF all'interno dell'adapter
Traccia WCF tra il client dell'adapter e l'adapter
I client dell'adapter possono abilitare la traccia WCF per tenere traccia dei problemi tra il client dell'adapter e l'adapter. 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'adattatore. È possibile attivare la traccia WCF per le applicazioni BizTalk e le applicazioni del modello di servizio WCF aggiungendo un estratto ai rispettivi file di configurazione. Inoltre, è possibile abilitare la traccia sia in fase di progettazione che in fase di esecuzione.
Traccia in fase di progettazione. Per l'esperienza di progettazione, è possibile usare il plug-in Add Adapter Service Reference, Consume Adapter Service Add o la Procedura guidata Aggiungi metadati adapter. Tutti questi strumenti possono essere usati da Visual Studio. Per abilitare la traccia per l'esperienza di progettazione, è quindi necessario aggiungere l'estratto al file devenv.exe.config che si trova nell'unità<> di installazione:\Programmi\Microsoft Visual Studio <versione>\Common7\IDE.
Traccia in fase di esecuzione. Per la traccia in fase di esecuzione, è necessario aggiungere l'estratto a seconda dell'applicazione in uso.
Per un BizTalk Server applicazioni, è necessario aggiungere l'estratto al file di configurazione BizTalk, in genere BTSNTSvc.exe.config. Per BizTalk Server, questo file è disponibile in genere nell'unità <>di installazione:\Programmi\Microsoft BizTalk Server.
Per un'applicazione .NET del modello di servizio WCF, è necessario aggiungere l'estratto al file di 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. La traccia WCF offre informazioni più valide.
Importante
Assicurarsi di attenuare le potenziali minacce alla sicurezza dell'esposizione dei dati aziendali sensibili abilitando la traccia. Per consigli, vedere Procedure consigliate per proteggere l'adapter Oracle Database
Traccia WCF all'interno dell'adapter
Gli adattatori 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'adattatore e diagnosticare i problemi relativi all'adapter. È possibile attivare WCF LOB Adapter SDK e traccia dell'adapter per le applicazioni BizTalk e le applicazioni del modello di servizio WCF aggiungendo un estratto ai rispettivi file di configurazione. Inoltre, è possibile abilitare la traccia sia in fase di progettazione che in fase di esecuzione.
Traccia in fase di progettazione. Per l'esperienza di progettazione, è possibile usare il plug-in Add Adapter Service Reference, Consume Adapter Service Add o la Procedura guidata Aggiungi metadati adapter. Tutti questi strumenti possono essere usati da Visual Studio. Per abilitare la traccia per l'esperienza di progettazione, è quindi necessario aggiungere l'estratto al file devenv.exe.config che si trova nell'unità<> di installazione:\Programmi\Microsoft Visual Studio <versione>\Common7\IDE.
Traccia in fase di esecuzione. Per la traccia in fase di esecuzione, è necessario aggiungere l'estratto a seconda dell'applicazione in uso.
Per un BizTalk Server applicazioni, è necessario aggiungere l'estratto al file di configurazione BizTalk, in genere BTSNTSvc.exe.config. Per BizTalk Server, questo file è disponibile in genere nell'unità <>di installazione:\Programmi\Microsoft BizTalk Server.
Per un'applicazione .NET del modello di servizio WCF, è necessario aggiungere l'estratto al file di app.config del progetto.
Per abilitare WCF LOB Adapter SDK e la traccia degli adattatori, 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.OracleDB" 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 utilizzare lo strumento Visualizzatore traccia del servizio Windows Communication Foundation (WCF) per visualizzare le tracce. Vedere Uso del Visualizzatore traccia del servizio per la visualizzazione di tracce correlate e risoluzione dei 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 del 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. La gestione degli artefatti include altre informazioni.