資料客戶端追蹤

追蹤有多種選項，有助於捕捉消費者、服務元件、提供者、網路及主機資料來源中的問題。

使用 SQL Server Profiler 進行 SQL 消費者追蹤

SQL Server Profiler 是 SQL Trace 的圖形使用者介面，用於監控資料庫引擎或分析服務的實例。 您可以擷取每一個事件的相關資料，並將資料儲存至檔案或資料表，以供稍後分析。 欲了解更多資訊，請參閱 SQL Server Profiler 介紹 （https://go.microsoft.com/fwlink/?LinkID=180433）。

使用提供者追蹤工具進行資料提供者追蹤

HIS 追蹤工具可擷取並儲存 Microsoft DB2 與 Informix 網路用戶端連線、提供者介面及資料訊息的資訊。 欲了解更多資訊，請參閱追蹤工具幫助及 SNA 追蹤工具。

使用網路監控器進行網路追蹤

網路監控器會擷取網路流量以供顯示與分析。 它能讓你執行如分析先前擷取的資料、從定義的協定解析器中擷取資料等任務。 它包含一個分散式資料管理（DDM）解析器，供 HIS 資料網路用戶端使用。 請聯絡 Microsoft 客服，索取 DDM 解析器副本。 欲了解更多資訊，請參閱 網路監控 （https://go.microsoft.com/fwlink/?LinkID=180448）。

使用 IBM 工具進行 DB2 伺服器追蹤

欲了解更多資訊，請參閱 IBM DB2 管理指南，了解適用的 DB2 平台與版本。

使用 IBM 工具進行 Informix 伺服器追蹤

欲了解更多資訊，請參閱 IBM Informix 管理指南，了解適用的 Informix 平台與版本。

使用事件檢視器監控 Windows Server 事件

事件檢視器是 Microsoft 管理主控台（MMC）的可快速存取功能，讓您能瀏覽和管理事件日誌。 更多資訊請參閱 事件檢視器 （https://go.microsoft.com/fwlink/?LinkID=131274）。

主機檔案用戶端與資料提供者追蹤

主機檔案用戶端與 ADO.NET 資料提供者（Host File Client）支援 Microsoft 主機整合文字追蹤監聽器。此監聽器使用 HIDT（主機整合追蹤定義）設定檔來進行配置，該設定檔在資料消費者的 app.config 檔案中的系統診斷元素中進行引用。

Data Consumer App.Config 檔案

資料消費者的 app.config 檔案包含一個 Microsoft 主機整合追蹤配置區段元素，以及一個主機整合伺服器文字檔案監聽器元素，這些元素負責控制主機檔案客戶端的追蹤。 在此範例中，MsHostFileClient.HITD（Host Integration Tracing Definition）檔案應位於資料消費者程式目錄中。

<?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>

組態區段

configSections 元素包含 Microsoft Host 整合追蹤元件的設定區段與命名空間宣告。

設定區名稱

區 段名稱 屬性定義了 Microsoft 主機整合追蹤元件的名稱。 此必要屬性接受一個字串，其值為Microsoft.hostintegration.tracing。

配置區段類型

type 屬性定義了 Microsoft Host Integration 追蹤文字追蹤監聽器的類型。 此 必要 屬性接受一個字串，值為 Microsoft.HostIntegration.Tracing.TraceSection、Microsoft.HostIntegration.Tracing.Configuration、Culture=neutral、Version=7.0.2300.0、PublicKeyToken=31bf3856ad364e35。

主機整合追蹤區

microsoft.hostintegration.tracing 元素包含 Microsoft Host Integration 追蹤元件文字追蹤監聽器的設定資訊。

追蹤定義檔案

traceDefinitionFile 屬性定義了 Microsoft Host Integration 追蹤文字追蹤監聽器輸出檔的名稱。 這個 必須的 屬性接受一個字串，該值代表追蹤輸出的路徑和檔案名稱。

系統診斷

system.diagnostics 元素包含 Microsoft Host Integration 追蹤元件 Text Trace Listener 的額外設定。

追蹤監聽者名稱

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。

自動沖洗

autoFlush 屬性指示 DRDA 服務自動將資料沖洗至追蹤監聽器。 此可選屬性接受布林值。 預設值為 false 。

追蹤檔案名稱

name 屬性定義了 Host File Client 文字追蹤輸出檔的名稱。 這個必需的屬性需要接受一個字串。

追蹤監聽器初始化

allowNonHisTracingToCreateFile 屬性定義追蹤是否可由除主機檔案用戶端及 Microsoft 主機整合追蹤以外的元件發起。 這個必須的屬性是接受布林值，預設值為 false。

主機整合追蹤定義（HITD）檔案

主機整合追蹤定義（HIDT）設定檔定義了主機整合伺服器文字檔聆聽器的追蹤層級。

追蹤容器

容器元素包含定義每個痕跡點痕跡層級的容器元素。

追蹤容器名稱

name 屬性定義了追蹤容器的名稱。 這個必須的屬性接受一個字串，其值為HostFiles。

追蹤點名稱

name 屬性定義了追蹤源點的名稱。 這個 所需的 屬性必須接受一個 字串。 預設值為空字串。

表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>

另請參閱

資料整合（故障排除）