共用方式為

資料用戶端追蹤

追蹤有多個選項，可協助擷取取取者、服務元件、提供者、網路和主機資料來源中的問題。

使用 SQL Server Profiler 的 SQL 取用者追蹤

SQL Server Profiler 是 SQL 追蹤的圖形化使用者介面，可用來監視 Database Engine 或 Analysis Services 的執行個體。 您可以擷取每一個事件的相關資料，並將資料儲存至檔案或資料表，以供稍後分析。 如需詳細資訊，請參閱SQL Server Profiler () https://go.microsoft.com/fwlink/?LinkID=180433 簡介。

使用提供者追蹤公用程式進行資料提供者追蹤

HIS 追蹤公用程式會擷取並儲存來自 Microsoft DB2 和 Informix 網路用戶端連線、提供者介面和資料訊息的資訊。 如需詳細資訊，請參閱追蹤公用程式說明和 SNA 追蹤公用程式。

使用網路監視器的網路追蹤

網路監視器會擷取網路流量以供顯示及分析。 它可讓您執行工作，例如分析之前在使用者定義方法中擷取的資料，從定義的通訊協定剖析器中擷取資料。 它包含分散式資料管理 (DDM) 剖析器，以搭配 HIS 資料網路用戶端使用。 如需 DDM 剖析器的複本，請洽詢 Microsoft 客戶支援服務。 如需詳細資訊，請參閱 網路監視器 (https://go.microsoft.com/fwlink/?LinkID=180448) 。

使用 IBM 工具的 DB2 伺服器追蹤

如需詳細資訊，請參閱適用之 DB2 平台和版本的 IBM DB2 管理指南。

使用 IBM 工具的 Informix 伺服器追蹤

如需詳細資訊，請參閱適用 Informix 平臺和版本的 IBM Informix 系統管理指南。

使用事件檢視器的 Windows Server 事件

事件檢視器是 Microsoft Management Console (MMC) 嵌入式管理單元，可讓您瀏覽和管理事件記錄檔。 如需詳細資訊，請參閱事件檢視器 (https://go.microsoft.com/fwlink/?LinkID=131274) 。

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

主機檔案用戶端和 ADO.NET 主機檔案用戶端的資料提供者 (主機檔案用戶端) 支援使用 HIDT (主機整合追蹤定義所設定的 Microsoft 主機整合文字追蹤接聽程式，) 在資料取用者 app.config 檔案的系統診斷元素中參考的組態檔。

資料取用者 App.Config 檔案

資料取用者 app.config 檔案包含 Microsoft Host Integration Tracing 組態區段元素，以及控制主機檔案用戶端追蹤的 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>

組態區段

configSections元素包含 Microsoft 主機整合追蹤元件的組態區段和命名空間宣告。

組態區段名稱

區段 名稱 屬性會定義 Microsoft Host Integration Tracing 元件的名稱。 此 必要 屬性接受 字串，其值為 Microsoft.hostintegration.tracing。

組態區段類型

type屬性會定義 Microsoft Host Integration Trace 文字追蹤接聽程式的型別。 此必要屬性接受字串，其值為Microsoft.HostIntegration.Trace.TraceSection、Microsoft.HostIntegration.Trace.Configuration、Culture=neutral、Version=7.0.2300.0、PublicKeyToken=31bf3856ad364e35。

主機整合追蹤區段

microsoft.hostintegration.trace元素包含 Microsoft Host Integration Trace 元件文字追蹤接聽程式的組態資訊。

追蹤定義檔

traceDefinitionFile屬性會定義 Microsoft Host Integration Trace 文字追蹤文字追蹤接聽程式輸出檔的名稱。 這個 必要 屬性接受 字串，其值代表追蹤輸出路徑和檔案名。

注意

每個使用者帳戶都必須具有 traces 資料夾的寫入權限，才能將行插入文字追蹤檔案中。 每個使用者帳戶都需要與 HIS Runtime Users Local Group 相關聯的資料夾存取控制清單設定。 如需詳細資訊，請參閱標題為安全性與保護一節。

系統診斷

system.diagnostics元素包含 Microsoft 主機整合追蹤元件文字追蹤接聽程式的其他組態。

追蹤接聽程式名稱

name屬性會定義主機檔案用戶端文字追蹤接聽程式的名稱。 此 必要 屬性接受 字串，其值為 HisTextFileListener。

追蹤接聽程式類型

type屬性會定義 DRDA 服務文字追蹤接聽程式的型別。 這個 必要 屬性接受 字串，其值為 Microsoft.HostIntegration.Trace.HisTextFileTraceListener、Microsoft.HostIntegration.Trace.Runtime、Culture=neutral、Version=7.0.2300.0、PublicKeyToken=31bf3856ad364e35、processorArchitecture=MSIL。

追蹤專案上限

maxTraceEntries屬性會指示主機檔案用戶端追蹤最多專案數，然後停止追蹤。 這個 選擇性 屬性接受 整數。 預設值為1000000。

追蹤檔案資料夾

traceFileFolder屬性會指示主機檔案用戶端文字追蹤接聽程式寫入文字接聽程式追蹤輸出檔的位置。 這個 選擇性 屬性接受 字串 值。 預設值為 C：\Program Files\Microsoft Host Integration Server 2013\traces。

注意

每個使用者帳戶都必須具有 traces 資料夾的寫入權限，才能將行插入文字追蹤檔案中。 每個使用者帳戶都需要與 HIS Runtime Users Local Group 相關聯的資料夾存取控制清單設定。 如需詳細資訊，請參閱標題為安全性與保護一節。

自動排清

autoFlush屬性會指示 DRDA 服務自動將資料排清至追蹤接聽程式。 這個選擇性屬性接受 布林 值。 預設值為 false。

注意

主機檔案用戶端文字追蹤接聽程式可以自動排清追蹤資料到追蹤接聽程式，以確保擷取追蹤資料，但會增加磁片 I/O 並降低整體系統效能。 若要改善效能，請將 autoFlush=false 設定為停用自動追蹤排清。

追蹤檔案名

name屬性會定義主機檔案用戶端文字追蹤輸出檔的名稱。 這個 必要 屬性接受 字串。

追蹤接聽程式初始化

allowNonHisTracingToCreateFile屬性會定義是否可以由主機檔案用戶端和 Microsoft 主機整合追蹤以外的元件起始追蹤。 此 必要 屬性接受 布林值，預設值為 false。

主機整合追蹤定義 (HITD) 檔案

主機整合追蹤定義 (HIDT) 組態檔會定義主機整合伺服器文字檔接聽程式的追蹤層級。

追蹤容器

containers元素包含容器元素，定義每個追蹤點的追蹤層級。

追蹤容器名稱

name屬性會定義追蹤容器的名稱。 此 必要 屬性接受 字串，其值為 HostFiles。

追蹤點名稱

name屬性會定義追蹤來源點的名稱。 這個 必要 屬性接受 字串。 預設值為空字串。

值 Description
HostFiles 主機檔案的 ADO.NET 提供者
傳輸 DDM RLIO 的主機檔案用戶端
匯總轉換器 主機整合伺服器編碼器匯總轉換器
基本轉換器 主機整合伺服器編碼器基本轉換器

表 1. 主機檔案追蹤來源點名稱。

追蹤層級

traceLevel屬性會指示主機檔案用戶端追蹤定義的資訊集合，從最小到最大層級的追蹤。 這個 選擇性 屬性接受 字串 值。 預設值為空字串。

值 Description
嚴重 輸出嚴重訊息。
錯誤 輸出錯誤訊息。
警告 輸出警告訊息、錯誤訊息和嚴重訊息。
資訊 輸出資訊訊息、警告訊息、錯誤訊息和嚴重訊息。
「詳細資訊」 輸出所有訊息。
資料 輸出所有訊息和使用者資料。
偵錯 輸出所有訊息、使用者資料，以及偵錯資料。

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

另請參閱

資料整合 (疑難排解)

  • Last updated on