如何在 BAM 中啟用追縱

發行項
07/21/2023

您可以在 BAM 中啟用追蹤，以便協助在下列五個 BAM 元件內疑難排解問題：

BAM 管理公用程式
BAM 事件匯流排
BAM 入口網站
BAM 警示
BAM WCF 攔截器

啟用 BAM 管理公用程式的追蹤

您可以啟用 [BAM 管理公用程式] 的追蹤，以取得部署失敗的相關資訊。執行這項作業的方法有兩種。您可以透過特定 BM.exe 命令的命令列啟用追蹤，或是可以修改 [BAM 管理公用程式] 組態檔以啟用所有 BM.exe 命令的追蹤。

使用命令列

BM.exe 命令列追蹤是使用 -Trace：on|off 參數啟動。使用 Trace 參數會覆寫組態檔中的設定。

此參數可以搭配任何一般 BM.exe 命令使用。

例如：

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

使用組態檔

您可以修改位於 \Program Files (x86) \Microsoft BizTalk Server < VERSION > Tracking 資料夾中的 BM.exe.config 組態檔來啟用追蹤。此檔案包含 system.diagnostics 區 段，其中包含追蹤元素。請移除註解以啟用追蹤。根據預設，並不會啟用追蹤。

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

-->

啟用 BAM 事件匯流排的追蹤

啟用 BAM 事件匯流排的追蹤，可以協助您診斷兩種資料庫儲存錯誤類別：

使用 [追蹤設定檔編輯器] 時，源自於 BizTalk Server 服務之事件的儲存錯誤。
使用緩衝之事件資料流 API 時所產生的儲存錯誤。

若要啟用 BAM 事件匯流排的追蹤，請編輯或新增位於 \Program Files (x86) \Microsoft BizTalk Server < VERSION > 資料夾 BTSNTSvc.exe.config 檔案的下列區段。

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

若要啟用 BAM 事件匯流排的追蹤

編輯 \Program Files (x86) \Microsoft BizTalk Server VERSION >BTSNTSvc.exe.config < 檔案。
<找出 system.diagnostics > 和 < /system.diagnostics > 標籤。如果這些標記不存在於檔案中，請複製以上列出的程式碼，並將其貼到組態檔中。
將結束批註分隔符號從 /system.diagnostics 標籤之後 < 移至 system.diagnostics >> 標籤之前 < ，將結束批註分隔符號 ('-- > ') 取消批註。
儲存檔案。

啟用 BAM 入口網站的追蹤

啟用 BAM 入口網站的追蹤可讓您疑難排解連線能力問題。

BAM 入口網站是一種 ASP.NET 應用程式，並會遵循追蹤的標準通訊協定。在 \Program Files (x86) \Microsoft BizTalk Server VERSION >BAMPortal\web.config < 檔案中，有一個稱為 < 追蹤 > 的區段可供啟用。

若要啟用 BAM 入口網站的追蹤

編輯 \Program Files (x86) \Microsoft BizTalk Server VERSION >BAMPortal\web.config < 檔案。
<找出 system.diagnostics > 和 < /system.diagnostics 卷 > 標。
將結束批註分隔符號 ('-- > ') 從 /system.diagnostics 標籤之後 < 移至 system.diagnostics >> 標籤之前 < ，將系統診斷區段取消批註。
修改 initializeData 屬性以指定寫入交易記錄檔的位置。
找出 < system.web > 標籤。
在 system.web 區段中，將分隔符號 ('-- > ') 移至追蹤標籤之前，以找出追蹤標籤並取消批註追蹤命令。
儲存檔案。

BAM 警示

啟用 BAM 警示的追蹤可協助您疑難排解警示傳遞失敗。

BAM 警示建置在SQL Server通知服務基礎結構上。若要啟用 BAM 警示的追蹤，請參閱通知服務疑難排解主題： https://go.microsoft.com/fwlink/?LinkId=79416 。

BAM 攔截器

若要啟用 BAM 攔截器的端點對端點追蹤，您必須修改應用程式的組態檔。這對 Web 主控的應用程式會是 Web.config，對於自我主控的應用程式則會是 Appname.config。下列是如何能夠修改檔案的範例：

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

Windows Workflow Foundation 和 Windows Communication Foundation 的 BAM 攔截器，都會寫入名為 "Microsoft BizTalk Bam Interceptors" 的來源。

注意

來源字串會區分大小寫，而且必須與在此顯示者完全相同。如果您的字串不同於所示的字串，您就不會接收到 BAM 攔截器的追蹤資訊。

您可以設定 switchValue 以控制追蹤等級。下表摘要可用的追蹤等級。

追蹤層級	描述
重大	記錄「快速失敗」和「事件記錄檔」項目，並追蹤相互關聯資訊。
錯誤	記錄所有例外狀況。
警告	存在可能造成後續錯誤或重大失敗的狀況。
資訊	會產生對監控與診斷系統狀態、衡量效能，或描述分析有幫助的訊息。您可以使用此類資訊來進行容量規劃與效能管理。
「詳細資訊」	對使用者程式碼和服務進行偵錯層級追蹤。
全部	所有訊息。

注意

追蹤可能會對效能具有不利效果。請只在執行疑難排解活動時啟用追蹤。

檢視 WCF 追蹤檔

若要分析 WCF 追蹤，您可以使用 WCF Service Trace Viewer Tool。如需服務追蹤檢視器工具的詳細資訊，請參閱 https://go.microsoft.com/fwlink/?LinkId=75218 。

另請參閱

管理 BAM

共用方式為