通过

数据客户端跟踪

用于跟踪的选项有很多个，它们有助于捕获使用者、服务组件、提供程序、网络和主机数据源中的问题。

使用 SQL Server Profiler 进行 SQL 使用者跟踪

SQL Server Profiler 是 SQL 跟踪的图形用户界面，用于监视数据库引擎或 Analysis Services 的实例。 您可以捕获有关每个事件的数据并将其保存到文件或表中供以后分析。 有关详细信息，请参阅SQL Server Profiler (https://go.microsoft.com/fwlink/?LinkID=180433) 简介。

使用提供程序跟踪实用工具进行数据提供程序跟踪

HIS 跟踪实用工具可捕获和跟踪 Microsoft DB2 和 Informix 网络客户端连接、提供程序接口和数据消息中的信息。 有关详细信息，请参阅“跟踪实用工具帮助和 SNA 跟踪实用工具”。

使用网络监视器进行网络跟踪

网络监视器捕获网络流量以便进行显示和分析。 通过网络监视器，您可以执行以用户定义方法分析以前捕获的数据或从定义的协议分析器提取数据之类的任务。 网络监视器包括用于 HIS 数据网络客户端的分布式数据管理 (DDM) 分析程序。 要获得 DDM 分析器的副本，请与 Microsoft 客户支持服务部门联系。 有关详细信息，请参阅 网络监视器 (https://go.microsoft.com/fwlink/?LinkID=180448) 。

使用 IBM 工具进行 DB2 服务器跟踪

有关详细信息，请参阅适用 DB2 平台和版本的“IBM DB2 管理指南”。

使用 IBM 工具进行 Informix 服务器跟踪

有关详细信息，请参阅适用 Informix 平台和版本的“IBM Informix 管理指南”。

使用事件查看器的 Windows Server 事件

事件查看器是一个 Microsoft 管理控制台 (MMC) 管理单元，可用于浏览和管理事件日志。 有关详细信息，请参阅事件查看器 (https://go.microsoft.com/fwlink/?LinkID=131274) 。

主机文件客户端和数据提供程序跟踪

主机文件客户端和用于主机文件（主机文件客户端）的 ADO.NET 数据提供程序支持使用 HIDT（主机集成跟踪定义）配置文件（数据使用者 app.config 文件的系统诊断元素中引用）配置的 Microsoft 主机集成文本跟踪侦听器。

数据使用者 App.Config 文件

数据使用者 app.config 文件包含 Microsoft 主机集成跟踪配置节元素和 Host Integration Server 文本文件侦听器元素，两者用于控制主机文件客户端跟踪。 在本例中，MsHostFileClient.HITD（主机集成跟踪定义）文件应位于数据使用者程序目录中。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="microsoft.hostintegration.tracing" type="Microsoft.HostIntegration.Tracing.TraceSection, Microsoft.HostIntegration.Tracing.Configuration, Culture=neutral, Version=9.0.1000.0, PublicKeyToken=31bf3856ad364e35" />
  </configSections>

  <microsoft.hostintegration.tracing
    traceDefinitionFile=" MsHostFileClient.HITD" />

  <system.diagnostics>
    <trace>
      <listeners>
        <add
          name="HisTextFileListener"
          type="Microsoft.HostIntegration.Tracing.HisTextFileTraceListener, Microsoft.HostIntegration.Tracing.Runtime, Culture=neutral, Version=9.0.1000.0, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL"
          maxTraceEntries="1000000"
          traceFileFolder="C:\Program Files\Microsoft Host Integration Server 2020\traces\"
          autoFlush="true"
          fileNamePreamble="MsHostFileClient"
          allowNonHisTracingToCreateFile="true"
    />
      </listeners>
    </trace>
  </system.diagnostics>
  <startup>
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
    </startup>
</configuration>

Configuration 节

ConfigSections 元素包含 Microsoft 主机集成跟踪组件的配置节和命名空间声明。

配置节名称

节 name 属性定义 Microsoft 主机集成跟踪组件的名称。 此必需属性接受字符串，其值为 Microsoft.hostintegration.tracing。

配置节类型

type 属性定义 Microsoft 主机集成跟踪文本跟踪侦听器的类型。 此必需属性接受字符串，其值为 Microsoft.HostIntegration.Tracing.TraceSection, Microsoft.HostIntegration.Tracing.Configuration, Culture=neutral, Version=7.0.2300.0, PublicKeyToken=31bf3856ad364e35。

主机集成跟踪节

microsoft.hostintegration.tracing 元素包含 Microsoft 主机集成跟踪组件文本跟踪侦听器的配置信息。

跟踪定义文件

traceDefinitionFile 属性定义 Microsoft 主机集成跟踪文本跟踪侦听器输出文件的名称。 此必需属性接受字符串，其值表示跟踪输出路径和文件名。

注意

每个用户帐户都必须对跟踪文件夹具有写入权限，以便向文本跟踪文件中插入行。 每个用户帐户都需要将“文件夹访问控制列表”设置与“HIS 运行时用户本地组”关联。 有关详细信息，请参阅标题为“安全和保护”的部分。

系统诊断

system.diagnostics 元素包含 Microsoft 主机集成跟踪组件文本跟踪侦听器的其他配置。

跟踪侦听器名称

name 属性定义主机文件客户端文本跟踪侦听器的名称。 此必需属性接受字符串，其值为 HisTextFileListener。

跟踪侦听器类型

type 属性定义 DRDA 服务文本跟踪侦听器的类型。 此必需属性接受字符串，其值为 Microsoft.HostIntegration.Tracing.HisTextFileTraceListener, Microsoft.HostIntegration.Tracing.Runtime, Culture=neutral, Version=7.0.2300.0, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL。

最多跟踪条目数

maxTraceEntries 属性指示主机文件客户端跟踪最多条目数，然后停止跟踪。 此可选属性接受整数值。 默认值为 1000000。

跟踪文件文件夹

traceFileFolder 属性指示主机文件客户端文本跟踪侦听器在何处写入文本侦听器跟踪输出文件。 此可选属性接受字符串值。 默认值为 C:\Program Files\Microsoft Host Integration Server 2013\traces。

注意

每个用户帐户都必须对跟踪文件夹具有写入权限，以便向文本跟踪文件中插入行。 每个用户帐户都需要将“文件夹访问控制列表”设置与“HIS 运行时用户本地组”关联。 有关详细信息，请参阅标题为“安全和保护”的部分。

自动刷新

autoFlush 属性指示 DRDA 服务将数据自动刷新到跟踪侦听器。 此可选属性接受布尔值。 默认值为 false。

注意

主机文件客户端文本跟踪侦听器可以将跟踪数据自动刷新到跟踪侦听器，从而确保捕获跟踪数据，但这样会增加磁盘 I/O 并降低整体系统性能。 要提高性能，请设置 autoFlush=false，以禁用自动刷新跟踪。

跟踪文件名

name 属性定义主机文件客户端文本跟踪输出文件的名称。 此必需属性接受字符串。

跟踪侦听器初始化

allowNonHisTracingToCreateFile 属性定义跟踪是否可由主机文件客户端和 Microsoft 主机集成跟踪以外的组件初始化。 此必需属性接受布尔值，默认值为 false。

主机集成跟踪定义 (HITD) 文件

主机集成跟踪定义 (HIDT) 配置文件定义 Host Integration Server 文本文件侦听器的跟踪级别。

跟踪容器

containers 元素包含定义每个跟踪点跟踪级别的容器元素。

跟踪容器名称

name 属性定义跟踪容器的名称。 此必需属性接受字符串，其值为 HostFiles。

跟踪点名称

name 属性定义跟踪源点的名称。 此必需属性接受字符串。 默认值为空字符串。

值 说明
HostFiles 主机文件的 ADO.NET 提供程序
Transport DDM RLIO 的主机文件客户端
聚合转换器 Host Integration Server 编码器聚合转换器
基元转换器 Host Integration Server 编码器基元转换器

表 1. 主机文件跟踪源点名称。

跟踪级别

traceLevel 属性指示主机文件客户端按照从最小跟踪级别到最大跟踪级别的顺序跟踪定义的信息集合。 此可选属性接受字符串值。 默认值为空字符串。

值 说明
严重 输出严重消息。
错误 输出错误消息。
警告 输出警告消息、错误消息和严重消息。
信息 输出参考消息、警告消息、错误消息和严重消息。
详细 输出所有消息。
数据 输出所有消息和用户数据。
调试 输出所有消息、用户数据和调试数据。

表 2. 主机文件文本跟踪侦听器级别。

<containers>
  <container name="HostFiles">
    <tracePoint name="MsHostFileClient">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
    <tracePoint name="Transport">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
    <tracePoint name="Aggregate Converter">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
    <tracePoint name="Primitive Converter">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
  </container>
</containers>

另请参阅

数据集成（故障排除）