Siebel 适配器的诊断跟踪和消息日志记录
适配器客户端可以启用诊断跟踪,以有效地诊断使用适配器时遇到的问题。 适配器客户端可以在三个不同的级别激活跟踪:
在适配器客户端和适配器之间
在适配器内
在适配器和业务线之间 (LOB) 应用程序
本部分提供有关在这些级别激活跟踪的信息。
适配器客户端和适配器之间的跟踪
适配器客户端可以启用 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 跟踪 提供了详细信息。
重要
确保通过启用跟踪来缓解暴露敏感业务数据的潜在安全威胁。 请参阅 保护 Siebel 适配器的最佳做法
适配器内的跟踪
BizTalk 适配器包中的适配器会将不同类别的有用信息记录到跟踪文件,例如错误、警告和信息。 此信息有助于了解适配器中的进程流和诊断适配器的问题。 可以通过向相应的配置文件添加摘录来激活 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,此文件通常位于安装驱动器>:\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.Siebel" 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。
适配器和 LOB 应用程序之间的跟踪
必须启用适配器与 LOB 应用程序之间的通信跟踪,以诊断你怀疑在 LOB 应用程序中的问题。 适配器还依赖于 LOB 跟踪 (客户端/服务器端) 来访问此信息。 本文档中排除了有关启用 LOB 跟踪的详细信息。
此外,Siebel 适配器 (LogData) 提供绑定属性,如果设置为 True 并且跟踪级别设置为 “详细”,则 Siebel 适配器将记录适配器与 Siebel 系统之间的信息流。 此信息与适配器跟踪一起记录在同一跟踪文件中。
有关此绑定属性的详细信息,请参阅 阅读有关 Siebel 绑定属性的 BizTalk 适配器。
查看跟踪
可以使用 Windows Communication Foundation (WCF) 服务跟踪查看器工具查看跟踪。 有关该工具的详细信息,请参阅 使用服务跟踪查看器查看相关跟踪和故障排除。
配置 BizTalk 应用程序的跟踪
使用 BizTalk 管理控制台可以为发送端口、接收端口等内容配置各种跟踪选项。 使用跟踪配置设置可以跟踪入站/出站事件数据、消息属性、消息正文和业务流程。 有关为 BizTalk 应用程序配置跟踪的详细信息,请参阅 管理项目。
还可以使用组中心 查看跟踪的消息和实例数据,包括跟踪清单和最佳做法。