通过

如何在 BAM 中启用跟踪

可以在 BAM 中启用跟踪，以帮助排查以下五个 BAM 组件中的问题：

  • BAM 管理实用工具

  • BAM 事件总线

  • BAM 门户

  • BAM 警报

  • BAM WCF 侦听器

为 BAM 管理实用工具启用跟踪功能

可以通过启用 BAM 管理实用工具的跟踪来获取有关部署失败的信息。 你可以通过两种方式来做到这一点。 可以通过命令行为特定 BM.exe 命令启用跟踪，也可以修改 BAM 管理实用工具配置文件，为所有 BM.exe 命令启用跟踪。

使用命令行

BM.exe 命令行跟踪是使用 -Trace：on|off 开关激活的。 使用跟踪开关会覆盖配置文件中的设置。

该开关与任何普通 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 事件总线启用跟踪

  1. 编辑 \Program Files （x86）\Microsoft BizTalk Server <VERSION>BTSNTSvc.exe.config 文件。

  2. <找到 system.diagnostics> 和 </system.diagnostics> 标记。 如果该文件中不存在这些代码，请复制上面列出的代码并将其粘贴到配置文件中。

  3. 通过将结束注释分隔符（'-->'）从 </system.diagnostics> 标记之后移到 <system.diagnostics> 标记之前，取消注释系统诊断部分。

  4. 保存文件。

为 BAM 门户启用跟踪

为 BAM 门户启用跟踪可以帮助解决连接问题。

BAM 门户是一个 ASP.NET 应用程序，遵循用于跟踪的标准协议。 在 \Program Files （x86）\Microsoft BizTalk Server <VERSION>BAMPortal\web.config 文件中，有一个名为 <trace> 的部分可以启用。

为 BAM 门户开启跟踪功能

  1. 编辑 \Program Files （x86）\Microsoft BizTalk Server <VERSION>BAMPortal\web.config 文件。

  2. <找到 system.diagnostics> 和 </system.diagnostics> 标签。

  3. 取消对 system.diagnostics 部分的注释，通过将结束注释分隔符('-->')从 </system.diagnostics> 标记之后移动到 <system.diagnostics> 标记之前。

  4. 修改 initializeData 属性以指定要写入跟踪日志的位置。

  5. 找到 <system.web> 标记。

  6. 在 system.web 节中，通过将分隔符（'-->'）从跟踪标记移动到跟踪标记之前来取消注释跟踪命令。

  7. 保存文件。

    <!--

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

启用 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 拦截器”的源。

注释

源字符串区分大小写，必须与所示完全一致。 如果字符串与显示的字符串不同，则不会收到 BAM 侦听器的跟踪信息。

可以通过设置 switchValue 来控制跟踪级别。 下表汇总了可用的跟踪级别。

跟踪级别 DESCRIPTION
危急 日志 Fail-Fast 和事件日志条目，以及跟踪相关性信息。
错误 记录所有异常。
警告 存在可能导致错误或严重故障的条件。
信息 生成有助于监视和诊断系统状态、测量性能或进行性能分析的消息。 可以利用这些信息进行容量规划和性能管理。
详细 针对用户代码和服务进行调试级跟踪。
全部 所有消息。

注释

跟踪可能会对性能产生不利影响。 仅在执行故障排除活动时启用跟踪。

查看 WCF 跟踪文件

若要分析 WCF 跟踪，请使用 WCF 服务跟踪查看器工具。 有关服务跟踪查看器工具的详细信息，请参阅 https://go.microsoft.com/fwlink/?LinkId=75218。

另请参阅

管理 BAM