Oracle E-Business Suite 适配器中的诊断跟踪和消息日志记录

项目
07/21/2023

诊断跟踪有助于有效地诊断使用适配器时可能遇到的问题。本主题提供有关 Microsoft BizTalk Adapter for Oracle E-Business Suite 支持的以下三种类型的跟踪的信息：

使用客户端标识符的 Oracle 服务器端跟踪
适配器客户端和适配器之间的 WCF 跟踪
适配器中的 WCF 跟踪

使用客户端标识符进行 Oracle 服务器端跟踪

Oracle 允许对客户端应用程序对 Oracle 数据库执行的操作执行服务器端跟踪。由于来自客户端应用程序的请求可以路由到不同的数据库会话，因此很难跟踪请求的来源。但是，Oracle 使用客户端标识符促进端到端应用程序跟踪。

Oracle 电子商务适配器公开 OracleConnectionClientId 绑定属性，该属性允许你在设计时为适配器用于连接到 Oracle 的连接指定客户端标识符。适配器客户端标识符有助于对 Oracle 上的适配器客户端执行的操作进行选择性跟踪，还允许您根据客户端标识符筛选和查看 Oracle 服务器跟踪。有关如何在 Oracle 中启用客户端标识符跟踪的信息，请参阅 https://go.microsoft.com/fwlink/p/?LinkId=135746。

适配器客户端和适配器之间的 WCF 跟踪

适配器客户端可以启用 WCF 跟踪来跟踪适配器客户端和适配器之间的问题。 WCF 跟踪用于使用 WCF 服务模型跟踪来自适配器客户端的输入 XML，可用于诊断序列化问题。 WCF 跟踪不用于 WCF 通道模型，也不用于从适配器到适配器客户端的输出消息。可以通过将摘录添加到相应的配置文件来激活 BizTalk 应用程序和 WCF 服务模型应用程序的 WCF 跟踪。此外，还可以在设计时和运行时启用跟踪。

在设计时跟踪。对于设计时体验，可以使用“添加适配器服务引用插件”、“使用适配器服务加载项”或“添加适配器元数据向导”。所有这些工具都可以从 Visual Studio 中使用。因此，若要启用设计时体验跟踪，必须将摘录添加到安装驱动器>：\Program Files\Microsoft Visual Studio version\Common7\IDE 中的< devenv.exe.config 文件。><
运行时跟踪。对于运行时跟踪，必须根据所使用的应用程序添加摘录。
- 对于BizTalk Server应用程序，必须将摘录添加到 BizTalk 配置文件中，通常 BTSNTSvc.exe.config。对于BizTalk Server，此文件通常在安装驱动器>：\Program Files\Microsoft BizTalk Server 下<提供。
- 对于 WCF 服务模型 .NET 应用程序，必须将摘录添加到项目的 app.config 文件中。
若要启用 WCF 跟踪，请在标记中添加 <configuration> 以下摘录：

<system.diagnostics>
    <sources>
      <source name ="System.ServiceModel" switchValue="Verbose">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
      <source name ="System.ServiceModel.MessageLogging"
              switchValue="Verbose, ActivityTracing">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
      <source name ="System.Runtime.Serialization" switchValue="Verbose">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
   </sources>
   <sharedListeners>
      <add name="xml" type="System.Diagnostics.XmlWriterTraceListener"
           traceOutputOptions="LogicalOperationStack"
           initializeData="C:\log\WCFTrace.svclog" />
   </sharedListeners>
   <trace autoflush="true" />
  </system.diagnostics>
  <system.serviceModel>
    <diagnostics>
      <messageLogging
           logEntireMessage="true"
           logMalformedMessages="false"
           logMessagesAtServiceLevel="true"
           logMessagesAtTransportLevel="false"/>
    </diagnostics>
  </system.serviceModel>

这会将 WCF 跟踪保存到 C：\log\WCFTrace.svclog。 WCF 跟踪提供了详细信息。

重要

请确保缓解启用跟踪时可能导致的敏感业务数据暴露的潜在安全威胁。有关建议，请参阅消息和实例数据跟踪的最佳做法。

适配器中的 WCF 跟踪

适配器将不同类别的有用信息记录到跟踪文件中，例如错误、警告和信息消息。这些信息有助于了解适配器中的进程流和诊断适配器的问题。可以通过将摘录添加到相应的配置文件来激活 BizTalk 应用程序和 WCF 服务模型应用程序的 WCF LOB 适配器 SDK 和适配器跟踪。此外，还可以在设计时和运行时启用跟踪。

在设计时跟踪。对于设计时体验，可以使用“添加适配器服务引用插件”、“使用适配器服务加载项”或“添加适配器元数据向导”。所有这些工具都可以从 Visual Studio 中使用。因此，若要启用设计时体验跟踪，必须将摘录添加到安装驱动器>：\Program Files\Microsoft Visual Studio version\Common7\IDE 中的< devenv.exe.config 文件。><
运行时跟踪。对于运行时跟踪，必须根据所使用的应用程序添加摘录。
- 对于BizTalk Server应用程序，必须将摘录添加到 BizTalk 配置文件中，通常 BTSNTSvc.exe.config。对于 BizTalk Server 2006 R2，此文件通常在安装驱动器>：\Program Files\Microsoft BizTalk Server 2006 下<提供。对于BizTalk Server，此文件通常在安装驱动器>：\Program Files\Microsoft BizTalk Server 下<提供。
- 对于 WCF 服务模型 .NET 应用程序，必须将摘录添加到项目的 app.config 文件中。
若要启用 WCF LOB 适配器 SDK 和适配器跟踪，请在标记中添加 <configuration> 以下摘录：

<system.diagnostics>
    <sources>
      <source name="Microsoft.ServiceModel.Channels" switchValue="Error">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
      <source name="Microsoft.Adapters.OracleEBS" switchValue="Information">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="xml" type="System.Diagnostics.XmlWriterTraceListener"
   traceOutputOptions="LogicalOperationStack"
          initializeData="C:\log\AdapterTrace.svclog" />
    </sharedListeners>
    <trace autoflush="true" />
  </system.diagnostics>

这会将 WCF 跟踪保存到 C：\log\AdapterTrace.svclog。

查看跟踪

可以使用 Windows Communication Foundation (WCF) Service 跟踪查看器工具查看跟踪。使用服务跟踪查看器查看相关跟踪和故障排除提供有关此工具的更多详细信息。

为 BizTalk 应用程序配置跟踪

BizTalk Server管理控制台允许你为项目配置各种跟踪选项，例如发送端口和接收端口。跟踪配置设置使你能够跟踪入站和出站事件数据、消息属性、消息正文和业务流程。有关为 BizTalk 应用程序配置跟踪的详细信息，请参阅管理和跟踪项目。

还可以使用组中心查看跟踪的消息和实例数据，包括最佳做法、保存跟踪查询等。

另请参阅

适配器疑难解答

通过