Traccia diagnostica e registrazione messaggi per l'adapter SAP
La traccia di diagnostica consente di diagnosticare in modo efficace i problemi che potrebbero verificarsi quando si usano gli adattatori. I client adattatori possono attivare la traccia diagnostica a tre livelli:
Tra il client dell'adapter e l'adattatore
All'interno dell'adattatore
Tra l'adattatore e l'applicazione line-of-business (LOB)
Questa sezione fornisce 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 tracciare i 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'adapter usando il modello di servizio WCF ed è utile per diagnosticare i problemi di serializzazione. La traccia WCF non viene usata per il modello di canale WCF o per i messaggi di output dall'adapter al client dell'adapter. È possibile attivare la traccia WCF per applicazioni BizTalk e applicazioni del 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 di progettazione, è possibile usare il plug-in Add Adapter Service Reference, Use Adapter Service Add Adapter Service Add-In o Add Adapter Metadata Wizard. Tutti questi strumenti possono essere usati da Visual Studio. Quindi, per abilitare la traccia per l'esperienza di progettazione, è 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 vengono salvate le tracce WCF in C:\log\WCFTrace.svclog. Per altre informazioni sulla traccia WCF, vedere Traccia.
Importante
Assicurarsi di ridurre le potenziali minacce di sicurezza dell'esposizione dei dati aziendali sensibili abilitando la traccia. Per indicazioni, vedere Procedure consigliate per proteggere l'adapter SAP.
Traccia all'interno dell'adapter
Gli adapter registrano diverse categorie di informazioni utili per il file di traccia, ad esempio errori, avvisi e messaggi informativi. Queste informazioni sono utili per comprendere il flusso di processo all'interno dell'adattatore e diagnosticare i problemi relativi all'adapter. È possibile attivare l'SDK dell'adapter WCF LOB e la traccia dell'adapter per le applicazioni bizTalk e le applicazioni del 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 di progettazione, è possibile usare il plug-in Add Adapter Service Reference, Use Adapter Service Add Adapter Service Add-In o Add Adapter Metadata Wizard. Tutti questi strumenti possono essere usati da Visual Studio. Quindi, per abilitare la traccia per l'esperienza di progettazione, è 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 traccia dell'adapter, 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.SAP" 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 vengono salvate le tracce WCF in C:\log\AdapterTrace.svclog.
Traccia tra l'adapter e l'applicazione LOB
Per diagnosticare i problemi sospetti relativi all'applicazione LOB, è necessario abilitare la traccia per la comunicazione tra l'adapter e l'applicazione LOB. Gli adattatori dipendono anche dalla traccia LOB (lato client/server) per accedere a queste informazioni. La scheda SAP consente ai client della scheda di attivare la traccia all'interno del sistema SAP specificando il parametro "RfcSdkTrace" nell'URI di connessione. È necessario specificare questo parametro per abilitare RFC SDK per tracciare il flusso di informazioni all'interno del sistema SAP. Per altre informazioni sull'URI di connessione, vedere Creare l'URI di connessione del sistema SAP.
È inoltre possibile creare una variabile di ambiente RFC_TRACE che imposta il livello di traccia per RFC SDK. RFC_TRACE è una variabile di ambiente definita da SAP e viene usata dall'SDK RFC. Se questa variabile non è definita o è impostata su 0, il livello di traccia di RFC SDK è minimo. Se la variabile è impostata su 1 o 2, il livello di traccia è più dettagliato.
Nota
Indipendentemente dal fatto che la variabile di ambiente RFC_TRACE sia impostata, la traccia RFC SDK è abilitata solo se il parametro "RfcSdkTrace" è impostato su true nell'URI di connessione. Il valore di questa variabile di ambiente regola esclusivamente il livello di traccia di RFC SDK. Se RfcSdkTrace è impostato su true, le tracce del messaggio tra l'adattatore e il sistema SAP vengono copiate nella cartella "system32" nel computer. Per salvare le tracce di RFC SDK in un'altra posizione, è possibile impostare la variabile di ambiente RFC_TRACE_DIR. Per altre informazioni su queste variabili di ambiente, vedere la documentazione di SAP.
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 come le porte di invio e le 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 tracciati. Per altre informazioni, vedere Visualizzazione di dati cronologici e rilevati.