如何在 BAM 中启用跟踪

  • 项目

您可以在 BAM 中启用跟踪，以便帮助解决在以下 5 个 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.诊断 节，其中包含跟踪元素。 删除注释以便启用跟踪。 默认情况下，不启用跟踪。

<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.诊断> 和 </system.诊断> 标记。 如果在该文件中不存在这两个标记，则复制上述代码并将代码粘贴到该配置文件中。

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

  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.诊断> 和 </system.诊断> 标记。

  3. 通过将结束注释分隔符 ('-->') 从 /system.诊断 标记之后<移动到 system.诊断> 标记之前<来取消注释系统诊断>节。

  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.config Web 托管应用程序，或 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 控制跟踪级别。 下表概括列出了可用的跟踪级别。

跟踪级别 说明
严重 记录 Fail-Fast 和事件日志条目以及跟踪相关信息。
错误 记录所有异常。
警告 存在可能在以后导致出现错误或严重问题的情况。
信息 生成对监视和诊断系统状态、测量性能或执行分析十分有用的消息。 可以使用此类信息规划容量和管理性能。
详细 用于用户代码和服务的调试级别跟踪。
全部 所有消息。

注意

跟踪可能会对性能有负面影响。 只在执行故障排除活动时启用跟踪。

查看 WCF 跟踪文件

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

另请参阅

管理 BAM