Traccia diagnostica e registrazione messaggi per l'adapter Siebel
I client dell'adapter possono abilitare la traccia diagnostica per diagnosticare efficacemente i problemi riscontrati durante l'uso delle schede. I client adapter possono attivare la traccia a tre livelli diversi:
Tra il client dell'adapter e l'adattatore
All'interno dell'adattatore
Tra l'adattatore e l'applicazione line-of-business (LOB)
In questa sezione vengono fornite informazioni sull'attivazione della traccia a questi livelli.
Traccia 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 gli XML di input provenienti 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, è necessario 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 fornisce altre informazioni.
Importante
Assicurarsi di attenuare le potenziali minacce alla sicurezza dell'esposizione dei dati aziendali sensibili abilitando la traccia. Vedere Procedure consigliate per proteggere l'adapter Siebel
Traccia all'interno dell'adapter
Gli adapter nel Pacchetto di adapter BizTalk registrano diverse categorie di informazioni utili per il file di traccia, ad esempio errori, avvisi e informazioni. 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 degli 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, è necessario 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.Siebel" 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>
Le tracce WCF verranno salvate in C:\log\AdapterTrace.svclog.
Traccia tra l'adapter e l'applicazione LOB
È necessario abilitare la traccia per la comunicazione tra l'adapter e l'applicazione LOB per diagnosticare i problemi sospetti all'interno dell'applicazione LINEB. Gli adattatori dipendono anche dalla traccia LOB (lato client/server) per ottenere l'accesso a queste informazioni. Le specifiche dell'attivazione della traccia LOB vengono escluse da questo documento.
Inoltre, l'adapter Siebel fornisce una proprietà di associazione (LogData), che se impostata su True e se il livello di traccia è impostato su Verbose, l'adapter Siebel registra il flusso di informazioni tra l'adapter e il sistema Siebel. Queste informazioni vengono registrate insieme alle tracce dell'adapter nello stesso file di traccia.
Per altre informazioni su questa proprietà di associazione, vedere Informazioni sulle proprietà di associazione di BizTalk Adapter for Siebel.
Visualizzazione delle tracce
È possibile utilizzare lo strumento Visualizzatore traccia del servizio Windows Communication Foundation (WCF) per visualizzare le tracce. Per altre informazioni sullo strumento, vedere Using Service Trace Viewer for Viewing Correlated Traces and Troubleshooting.For more information about the tool, see Using Service Trace Viewer for Viewing Correlated Traces and Troubleshooting.
Configurazione del rilevamento per le applicazioni BizTalk
La Console di amministrazione bizTalk consente di configurare varie opzioni di rilevamento per elementi quali le porte di trasmissione, le porte di ricezione. Le impostazioni di configurazione del rilevamento consentono di tenere traccia dei dati degli eventi in ingresso/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 Managing Artifacts.For more information about configuring tracking for BizTalk applications, see Managing Artifacts.
È anche possibile usare l'hub di gruppo per visualizzare i dati dei messaggi rilevati e dell'istanza, inclusi un elenco di controllo di rilevamento e le procedure consigliate.