Traccia diagnostica e registrazione dei messaggi nell'adattatore Oracle E-Business Suite

Articolo
10/14/2023

La traccia di diagnostica consente di diagnosticare in modo efficace i problemi che potrebbero verificarsi quando si usano gli adattatori. Questo argomento fornisce informazioni sui tre tipi di traccia seguenti supportati con l'adapter Microsoft BizTalk per Oracle E-Business Suite:

Traccia lato server Oracle usando un identificatore client
Traccia WCF tra il client dell'adapter e l'adapter
Traccia WCF all'interno dell'adapter

Traccia lato server Oracle usando un identificatore client

Oracle consente di eseguire la traccia lato server per le operazioni eseguite dalle applicazioni client nel database Oracle. Poiché le richieste dalle applicazioni client possono essere indirizzate a sessioni di database diverse, diventa difficile tracciare l'origine della richiesta. Oracle facilita tuttavia la traccia dell'applicazione end-to-end usando gli identificatori client.

L'adapter Oracle E-Business espone la OracleConnectionClientId proprietà di associazione che consente di specificare l'identificatore client in fase di progettazione per la connessione usata dall'adattatore per connettersi a Oracle. L'identificatore client dell'adapter consente di traccia selettiva delle operazioni eseguite dal client dell'adattatore in Oracle e consente anche di filtrare e visualizzare le tracce del server Oracle in base all'identificatore client. Per informazioni su come abilitare la traccia per gli identificatori client in Oracle, vedere https://go.microsoft.com/fwlink/p/?LinkId=135746.

Traccia WCF 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. La traccia WCF fornisce altre informazioni.

Importante

Assicurarsi di attenuare potenziali minacce di sicurezza dell'esposizione di dati aziendali sensibili che possono essere causati durante l'abilitazione della traccia. Per raccomandazioni, vedere Procedure consigliate per il rilevamento dei dati di istanza e messaggio.

Traccia WCF 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 2006 R2, questo file è in genere disponibile nell'unità <>di installazione:\Programmi\Microsoft BizTalk Server 2006. 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 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.OracleEBS" 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.

Visualizzazione delle tracce

È possibile usare lo strumento Visualizzatore traccia del servizio Windows Communication Foundation (WCF) per visualizzare le tracce. L'uso del Visualizzatore traccia del servizio per la visualizzazione di tracce correlate e risoluzione dei problemi fornisce altri dettagli su questo strumento.

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 e rilevamento degli artefatti.

È anche possibile usare l'hub di gruppo per visualizzare i dati dei messaggi e delle istanze rilevati, incluse le procedure consigliate, il salvataggio delle query di rilevamento e altro ancora.

Vedere anche

Risoluzione dei problemi dell'adattatore

Condividi tramite