Condividi tramite

Come attivare l'analisi in BAM

  • Articolo

È possibile attivare l'analisi in BAM per consentire la risoluzione dei problemi nei cinque componenti BAM seguenti:

  • utilità di gestione BAM

  • Bus di eventi BAM

  • portale BAM

  • Avvisi BAM

  • Intercettore WCF BAM

Attivazione dell'analisi per l'utilità di gestione BAM

È possibile ottenere informazioni sugli errori di distribuzione attivando l'analisi per l'utilità di gestione BAM. Tale operazione può essere eseguita in due modi diversi. È possibile attivare l'analisi tramite la riga di comando per specifici comandi BM.exe o modificare il file di configurazione dell'utilità di gestione BAM per attivare l'analisi per tutti i comandi BM.exe.

Utilizzando la riga di comando

BM.exe traccia della riga di comando viene attivata usando l'opzione -Trace:on|off . L'opzione Trace consente di eseguire l'override delle impostazioni nel file di configurazione.

L'opzione viene utilizzata in combinazione con qualsiasi comando BM.exe comune.

Ad esempio:

bm.exe deploy-all -DefinitionFile:PO.xml –Trace:On

Uso del file di configurazione

È possibile abilitare la traccia modificando il file di configurazione BM.exe.config situato nella cartella \Programmi (x86)\Microsoft BizTalk Server <VERSION>Tracking. Questo file contiene una sezione system.diagnostics che contiene gli elementi di traccia. Rimuovere il commento per attivare l'analisi. Per impostazione predefinita, l'analisi è disattivata.

<system.diagnostics>

<!-- To turn on BAM tracing, remove this comment or use the "-trace:on" command-line switch

<switches>

<add name="bm" value="1" />

<add name="Microsoft.BizTalk.Bam.Management" value="1" />

</switches>

-->

Attivazione dell'analisi per il bus di eventi BAM

L'attivazione dell'analisi per il bus di eventi BAM può consentire la diagnosi di due classi di errori di archiviazione nel database:

  • Errori di archiviazione che hanno origine da eventi del servizio BizTalk Server quando si utilizza l'Editor profili di rilevamento.

  • Errori di archiviazione generati quando si utilizzano API di flussi di eventi memorizzati nel buffer.

    Per abilitare la traccia per il bus di eventi BAM, modificare o aggiungere la sezione seguente del file BTSNTSvc.exe.config che si trova nella cartella \Programmi (x86)\Microsoft BizTalk Server <VERSION>.

    <system.diagnostics>

    <switches>

    <add name="Microsoft.BizTalk.Bam.EventBus" value="1" />

    </switches>

    <trace autoflush="true" indentsize="4">

    <listeners>

    <add name="Text" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\tdds.log"/>

    </listeners>

    </trace>

    </system.diagnostics>

Per attivare l'analisi per il bus di eventi BAM

  1. Modificare il file \Programmi (x86)\Microsoft BizTalk Server <VERSION>BTSNTSvc.exe.config.

  2. Individuare il <tag system.diagnostics> e </system.diagnostics> . Se non sono presenti nel file, copiare il codice prima elencato e incollarlo nel file di configurazione.

  3. Annullare ilcommentazione della sezione Diagnostica del sistema spostando il delimitatore di commento finale ('-->') dopo il tag /system.diagnostics> fino a prima del <<tag system.diagnostics>.

  4. Salvare il file.

Attivazione dell'analisi per il portale BAM

L'attivazione dell'analisi per il portale BAM consente di risolvere i problemi di connettività.

Il portale BAM è un'applicazione ASP.NET e segue il protocollo standard per l'analisi. All'interno del file \Programmi (x86)\Microsoft BizTalk Server VERSION>BAMPortal\web.config <è disponibile una sezione denominata <traccia> che è possibile abilitare.

Per attivare l'analisi per il portale BAM

  1. Modificare il file \Programmi (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config.

  2. Individuare i <tag system.diagnostics> e </system.diagnostics> .

  3. Annullare ilcommentazione della sezione diagnostica di sistema spostando il delimitatore di commento finale ('->-') da dopo il tag /system.diagnostics a prima del <<tag system.diagnostics>>.

  4. Modificare l'attributo initializeData per specificare il percorso in cui scrivere il registro di analisi.

  5. Individuare <system.web> tag.

  6. Nella sezione system.web individuare il tag di traccia e annullare ilcommentazione del comando di traccia spostando il delimitatore ('-->') da dopo il tag di traccia a prima.

  7. Salvare il file.

    <!--

    TRACING: To turn tracing on:

    1) Uncomment this tag and specify a file path for trace output

    2) Uncomment the <trace tag> under <system.web>

    The trace will be saved to the file pointed to by "initializeData" below.

    Ensure that the target directory exists (C:\temp by default).

    Make sure that the IIS worker process user account (usually Network Service or ASPNET)

    and the BAM Portal user have write permissions for the trace log file directory (C:\temp below).

    To turn tracing on, you will need to uncomment the <trace> tag under <system.web>

    <system.diagnostics>

    <trace autoflush="true" indentsize="2">

    <listeners>

    <add name="BAMPortalListener"

    type="System.Diagnostics.TextWriterTraceListener"

    initializeData="C:\temp\BAMPortalTrace.log" />

    </listeners>

    </trace>

    </system.diagnostics>

    -->

    <!--

    TRACING: To turn tracing on:

    1) Uncomment this tag

    2) Uncomment the <system.diagnostics> tag above and specify a file path for trace output

    <trace enabled="true"

    requestLimit="40"

    pageOutput="false"

    traceMode="SortByTime"

    localOnly="true"

    writeToDiagnosticsTrace="true" />

    -->

Avvisi BAM

L'attivazione dell'analisi per gli avvisi BAM consente di risolvere i problemi di recapito degli avvisi.

L'avviso BAM è basato sull'infrastruttura di Servizi di notifica di SQL Server. Per abilitare la traccia sugli avvisi BAM, vedere gli argomenti relativi alla risoluzione dei problemi di Notification Services all'indirizzo https://go.microsoft.com/fwlink/?LinkId=79416.

Intercettori BAM

Per abilitare la traccia end-to-end degli intercettori BAM, è possibile modificare il file di configurazione dell'applicazione, Web.config per le applicazioni ospitate dal Web o Appname.config per le applicazioni self-hosted. Nell'esempio seguente viene illustrato come è possibile modificare il file:

<system.diagnostics>
  </sources>
    <source name="Microsoft BizTalk Bam Interceptors" switchValue="All">
      <listeners>

        <add name="myListener"
             type="System.Diagnostics.TextWriterTraceListener"
             initializeData="TextWriterOutput.log" />
      </listeners>
    </source>
  </sources>
</system.diagnostics>

Gli intercettori BAM per Windows Workflow Foundation e Windows Communication Foundation vengono scritti nell'origine denominata "Microsoft BizTalk Bam Interceptors".

Nota

La stringa di origine rileva la distinzione tra maiuscole e minuscole e deve essere visualizzata esattamente come illustrato. Se la stringa è diversa da quella riportata, non si riceveranno informazioni di analisi per gli intercettori BAM.

È possibile controllare il livello di analisi impostato switchValue. I livelli di analisi disponibili sono riepilogati nella tabella seguente.

Livello di traccia Descrizione
Critico Registra voci del registro eventi e Fail-Fast e informazioni sulla correlazione tra tracce.
Errore Registra tutte le eccezioni.
Avviso È stata rilevata una condizione che in seguito può dare luogo a un errore standard o critico.
Informazioni Il sistema genera messaggi informativi che semplificano il monitoraggio e la diagnosi dello stato di sistema, la valutazione delle prestazioni o il profiling. È possibile utilizzare queste informazioni durante la pianificazione delle capacità e la gestione delle prestazioni.
Dettagliato Anali di livello debug per codice utente e manutenzione.
Tutti Tutti i messaggi.

Nota

L'analisi può avere un effetto negativo sulle prestazioni. Attivare l'analisi solo se si stanno eseguendo attività di risoluzione dei problemi.

Visualizzazione del file di traccia WCF

Per analizzare la traccia WCF, è necessario utilizzare lo strumento WCF Service Trace Viewer. Per altre informazioni sullo strumento Visualizzatore traccia del servizio, vedere https://go.microsoft.com/fwlink/?LinkId=75218.

Vedere anche

Gestione di BAM