Freigeben über

Aktivieren der Ablaufverfolgung in BAM

  • Artikel

Die Ablaufverfolgung kann in BAM aktiviert werden, um Probleme in den folgenden fünf BAM-Komponenten zu behandeln:

  • BAM-Verwaltungshilfsprogramm

  • BAM-Ereignisbus

  • BAM-Portal

  • BAM-Warnungen

  • BAM-WCF-Interceptor

Aktivieren der Ablaufverfolgung für das BAM-Verwaltungsdienstprogramm

Sie können Informationen zu Bereitstellungsfehlern abrufen, indem Sie die Ablaufverfolgung für das BAM-Verwaltungsdienstprogramm aktivieren. Hierzu stehen zwei Möglichkeiten zur Verfügung: Sie können die Ablaufverfolgung über die Befehlszeile für bestimmte BM.exe-Befehle aktivieren oder die Konfigurationsdatei des BAM-Verwaltungsdienstprogramms so ändern, dass die Ablaufverfolgung für alle BM.exe-Befehle aktiviert wird.

Mithilfe der Befehlszeile

BM.exe Befehlszeilenablaufverfolgung wird über den Schalter -Trace:on|off aktiviert. Die Einstellungen in der Konfigurationsdatei werden durch die Verwendung dieses Schalters außer Kraft gesetzt.

Der Schalter kann mit allen normalen BM.exe-Befehlen verwendet werden.

Beispiel:

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

Verwenden der Konfigurationsdatei

Sie können die Ablaufverfolgung aktivieren, indem Sie die BM.exe.config Konfigurationsdatei ändern, die sich im Ordner \Programme (x86)\Microsoft BizTalk Server <VERSIONSnachverfolgung>befindet. Diese Datei enthält einen Abschnitt system.Diagnose, der die Ablaufverfolgungselemente enthält. Entfernen Sie die Kommentarzeichen, um die Ablaufverfolgung zu aktivieren. In der Standardeinstellung ist die Ablaufverfolgung nicht aktiviert.

<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>

-->

Aktivieren der Ablaufverfolgung für den BAM-Ereignisbus

Wenn die Ablaufverfolgung für den BAM-Ereignisbus aktiviert wurde, können zwei Klassen von Datenbankspeicherfehlern diagnostiziert werden:

  • Speicherfehler aufgrund von Ereignissen des BizTalk Server-Diensts unter Verwendung des Überwachungsprofil-Editors.

  • Speicherfehler, die durch die Verwendung von gepufferten Ereignisstream-APIs entstehen.

    Um die Ablaufverfolgung für den BAM-Ereignisbus zu aktivieren, bearbeiten oder fügen Sie den folgenden Abschnitt der BTSNTSvc.exe.config-Datei im Ordner \Programme (x86)\Microsoft BizTalk Server <VERSION> hinzu.

    <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>

So aktivieren Sie die Ablaufverfolgung für den BAM-Ereignisbus

  1. Bearbeiten Sie die Datei \Program Files (x86)\Microsoft BizTalk Server <VERSION>BTSNTSvc.exe.config.

  2. Suchen Sie die <Tags system.Diagnose> und </system.Diagnose>. Wenn diese Tags in der Datei nicht vorhanden sind, kopieren Sie den oben angeführten Code, und fügen Sie ihn in die Konfigurationsdatei ein.

  3. Heben Sie die Auskommentierung des Abschnitts Auskommentierung des Systems Diagnose aufheben auf, indem Sie das Endkommentartrennzeichen ('-->)) von nach dem <Tag /system.Diagnose> vor dem <Tag system.Diagnose> verschieben.

  4. Speichern Sie die Datei .

Aktivieren der Ablaufverfolgung für das BAM-Portal

Wenn Sie die Ablaufverfolgung für das BAM-Portal aktivieren, können Verbindungsprobleme behoben werden.

Das BAM-Portal ist eine ASP.NET-Anwendung, für die das Standardprotokoll für die Ablaufverfolgung gilt. In der Datei \Programme (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config gibt es einen Abschnitt namens <Ablaufverfolgung>, den Sie aktivieren können.

So aktivieren Sie die Ablaufverfolgung für das BAM-Portal

  1. Bearbeiten Sie die Datei \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config.

  2. Suchen Sie die <Tags system.Diagnose> und </system.Diagnose>.

  3. Heben Sie die Auskommentierung des System Diagnose Abschnitts auf, indem Sie das Endkommentartrennzeichen ("--")> von nach dem <Tag /system.Diagnose> vor dem <Tag system.Diagnose> verschieben.

  4. Bearbeiten Sie das Attribut initializeData, um den Speicherort anzugeben, an dem das Ablaufverfolgungsprotokoll geschrieben werden soll.

  5. Suchen Sie nach <system.web> tag.

  6. Suchen Sie im Abschnitt system.web nach dem Ablaufverfolgungstag, und heben Sie die Auskommentierung des Ablaufverfolgungsbefehls auf, indem Sie das Trennzeichen ('-->') von nach dem Ablaufverfolgungstag nach davor verschieben.

  7. Speichern Sie die Datei .

    <!--

    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" />

    -->

BAM-Benachrichtigung

Wenn Sie die Ablaufverfolgung für die BAM-Benachrichtigung aktivieren, können Probleme bei der Benachrichtigungsübermittlung behoben werden.

BAM-Warnungen basieren auf der SQL Server Notification Services-Infrastruktur. Informationen zum Aktivieren der Ablaufverfolgung für BAM-Warnungen finden Sie in den Notification Services-Problembehandlungsthemen unter https://go.microsoft.com/fwlink/?LinkId=79416.

BAM-Interceptors

Um die End-to-End-Ablaufverfolgung der BAM-Interceptors zu aktivieren, muss die Konfigurationsdatei der Anwendung geändert werden. Dabei handelt es sich bei im Web gehosteten Dateien um Web.config und für selbst gehostete Anwendungen um Appname.config. Im Folgenden finden Sie ein Beispiel für das Ändern der Datei:

<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>

BAM-Interceptors für Windows Workflow Foundation und Windows Communication Foundation werden in die Quelle "Microsoft BizTalk Bam Interceptors" geschrieben.

Hinweis

Bei der Zeichenfolge für die Quelle wird die Groß- und Kleinschreibung berücksichtigt. Sie muss exakt so geschrieben werden, wie sie hier dargestellt ist. Wenn sich die Zeichenfolge von der dargestellten unterscheidet, erhalten Sie keine Ablaufverfolgungsinformationen für die BAM-Interceptors.

Die Ablaufverfolgungsebene wird durch Festlegen von switchValue gesteuert. Die verfügbaren Ablaufverfolgungsebenen werden in der folgenden Tabelle zusammengefasst.

Ablaufverfolgungsebene Beschreibung
Kritisch Protokolliert FailFast- und Ereignisprotokolleinträge und Ablaufverfolgungs-Korrelationsinformationen
Fehler Protokolliert alle Ausnahmen
Warnung Es ist eine Bedingung vorhanden, die zu einem Fehler oder einem kritischen Fehler führen kann.
Information Meldungen, die bei der Überwachung und Diagnose des Systemstatus, der Leistungsmessung oder Profilerstellung nützlich sind. Sie können solche Informationen zur Kapazitätsplanung und Leistungsverwaltung nutzen.
Ausführlich Ablaufverfolgung auf Debugebene sowohl für Benutzercode als auch für Dienste.
All Alle Nachrichten

Hinweis

Die Ablaufverfolgung kann sich negativ auf die Leistung auswirken. Die Ablaufverfolgung sollte nur aktiviert werden, wenn Fehlerbehebungsaktivitäten durchgeführt werden.

Anzeigen der WCF-Ablaufverfolgungsdatei

Für die Analyse der WCF-Ablaufverfolgung wird das Tool Ablaufverfolgungs-Viewer des WCF-Diensts verwendet. Weitere Informationen zum Service Trace Viewer-Tool finden Sie unter https://go.microsoft.com/fwlink/?LinkId=75218.

Weitere Informationen

Verwalten von BAM