次の方法で共有

データ クライアントのトレース

トレースには複数のオプションがあります。トレースは、コンシューマー、サービス コンポーネント、プロバイダー、ネットワーク、およびホスト データ ソースの問題をキャプチャする場合に役立ちます。

SQL Server Profiler を使用した SQL コンシューマーのトレース

SQL Server Profiler は、データベース エンジンまたは Analysis Services のインスタンスを監視するための SQL トレースのグラフィカル ユーザー インターフェイスです。 各イベントに関するデータをキャプチャし、ファイルやテーブルに保存して、後で分析できます。 詳細については、「SQL Server Profilerの概要 (https://go.microsoft.com/fwlink/?LinkID=180433)」を参照してください。

プロバイダー トレース ユーティリティを使用したデータ プロバイダーのトレース

HIS トレース ユーティリティは、Microsoft DB2 および Informix ネットワーク クライアント接続、プロバイダー インターフェイス、およびデータ メッセージの情報をキャプチャして保存します。 詳細については、トレース ユーティリティ ヘルプと SNA トレース ユーティリティを参照してください。

ネットワーク モニターを使用したネットワーク トレース

ネットワーク モニターは、ネットワークのトラフィックをキャプチャして表示と分析を行います。 ネットワーク モニターを使用すると、ユーザー定義メソッドであらかじめキャプチャしておいたデータを分析したり、定義済みのプロトコル パーサーからデータを抽出したりするタスクを実行できます。 これには、HIS データ ネットワーク クライアントと組み合わせて使用する分散データ管理 (DDM) パーサーが含まれます。 DDM パーサーの入手方法については、マイクロソフト カスタマー サポート サービスに問い合わせてください。 詳細については、「 ネットワーク モニター (https://go.microsoft.com/fwlink/?LinkID=180448)」を参照してください。

IBM ツールを使用した DB2 サーバーのトレース

詳細については、該当する DB2 プラットフォームおよびバージョンの『IBM DB2 Administration Guide』を参照してください。

IBM ツールを使用した Informix サーバーのトレース

詳細については、該当する Informix プラットフォームおよびバージョンの『IBM Informix Administration Guide』を参照してください。

イベント ビューアーを使用した Windows Server イベント

イベント ビューアーは、イベント ログの参照と管理を行うことができる Microsoft 管理コンソール (MMC) スナップインの 1 つです。 詳細については、「イベント ビューアー (https://go.microsoft.com/fwlink/?LinkID=131274)」を参照してください。

ホスト ファイル クライアントとデータ プロバイダーのトレース

ホスト ファイル クライアントとホスト ファイル (ホスト ファイル クライアント) 用 ADO.NET データ プロバイダーは、データ コンシューマー app.config ファイルのシステム診断要素で参照されている HIDT (ホスト統合トレース定義) 構成ファイルを使用して構成された Microsoft Host Integration Text トレース リスナーをサポートします。

データ コンシューマー 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 Host Integration Tracing コンポーネントの構成セクションと名前空間の宣言が含まれています。

構成セクション名

セクションの name 属性は、Microsoft Host Integration Tracing コンポーネントの名前を定義します。 この required 属性は、Microsoft.hostintegration.tracing の値を持つ文字列 を受け付けます。

構成セクションの種類

type 属性は、Microsoft Host Integration Tracing テキスト トレース リスナーの種類を定義します。 この required 属性は、Microsoft.HostIntegration.Tracing.TraceSection, Microsoft.HostIntegration.Tracing.Configuration, Culture=neutral, Version=7.0.2300.0, PublicKeyToken=31bf3856ad364e35 の値を持つ文字列を受け付けます。

ホスト統合トレース セクション

microsoft.hostintegration.tracing 要素には、Microsoft Host Integration Tracing コンポーネント テキスト トレース リスナーの構成情報が含まれています。

トレース定義ファイル

traceDefinitionFile 属性は、Microsoft Host Integration Tracing テキスト トレース リスナー出力ファイルの名前を定義します。 この required 属性は、トレース出力パスとファイル名を表す値を持つ文字列を受け付けます。

Note

各ユーザー アカウントは、テキスト トレース ファイルに行を挿入するために、トレース フォルダーへの書き込みアクセス権が必要です。 各ユーザーアカウントには、HIS ランタイム ユーザー ローカル グループに関連付けられているフォルダー アクセス制御リストの設定が必要です。 詳細については、「セキュリティと保護」のセクションを参照してください。

システム診断

system.diagnostics 要素には、Microsoft Host Integration Tracing コンポーネントのテキスト トレース リスナー用の追加構成が含まれています。

トレース リスナー名

name 属性は、ホスト ファイル クライアントのテキスト トレース リスナーの名前を定義します。 この required 属性は、HisTextFileListener の値を持つ文字列を受け付けます。

トレース リスナーの種類

type 属性は、DRDA サービス テキスト トレース リスナーの種類を定義します。 この required 属性は、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 です。

Note

各ユーザー アカウントは、テキスト トレース ファイルに行を挿入するために、トレース フォルダーへの書き込みアクセス権が必要です。 各ユーザーアカウントには、HIS ランタイム ユーザー ローカル グループに関連付けられているフォルダー アクセス制御リストの設定が必要です。 詳細については、「セキュリティと保護」のセクションを参照してください。

自動フラッシュ

autoFlush 属性は DRDA サービスに、データを自動的にトレース リスナーへフラッシュするように指示します。 この省略可能な属性は、ブール値を受け付けます。 既定値は false です。

注意

ホスト ファイル クライアントのテキスト トレース リスナーはトレース データを自動的にトレース リスナーへフラッシュできます。これにより、トレース データはキャプチャされますが、ディスク I/O が増えてシステム全体のパフォーマンスが低下します。 パフォーマンスを向上させるには、autoFlush を false に設定して、自動トレース フラッシュを無効にします。

トレース ファイル名

name 属性は、ホスト ファイル クライアントのテキスト トレース出力ファイルの名前を定義します。 この必須属性は文字列を受け付けます。

トレース リスナー初期化

allowNonHisTracingToCreateFile 属性は、ホスト ファイル クライアントと Microsoft Host Integration Tracing 以外のコンポーネントによってトレースを開始できるかどうかを定義します。 この必須属性はブール値を受け付け、既定値は false です。

ホスト統合トレース定義 (HITD) ファイル

ホスト統合トレース定義 (HIDT) 構成ファイルは、ホスト統合サーバー テキスト ファイル リスナーのトレース レベルを定義します。

トレース コンテナー

containers 要素には、各トレース ポイントのトレース レベルを定義するコンテナー要素が含まれています。

トレース コンテナー名

name 属性は、トレース コンテナーの名前を定義します。 この必須属性は、HostFiles の値を持つ文字列を受け付けます。

トレース ポイント名

name 属性は、トレース ソース ポイントの名前を定義します。 この必須属性は文字列を受け付けます。 既定値は空の文字列です。

値 説明
HostFiles ホスト ファイルの ADO.NET プロバイダー
トランスポート DDM RLIO のホスト ファイル クライアント
集計コンバーター ホスト統合サーバー エンコーダー集計コンバーター
プリミティブ コンバーター ホスト統合サーバー エンコーダー プリミティブ コンバーター

表 1. ホストファイルトレースのソースポイント名。

トレース レベル

traceLevel 属性はホスト ファイル クライアントに、定義されている情報のコレクションを、トレースの最小レベルから最大レベルまでトレースするよう指示します。 この省略可能な属性は、文字列値を受け付けます。 既定値は空の文字列です。

値 説明
致命的 致命的メッセージを出力します。
エラー エラー メッセージを出力します。
警告 警告メッセージ、エラー メッセージ、および致命的メッセージを出力します。
説明 情報メッセージ、警告メッセージ、エラー メッセージ、および致命的メッセージを出力します。
"詳細" すべてのメッセージを出力します。
Data すべてのメッセージとユーザー データを出力します。
デバッグ すべてのメッセージ、ユーザー データ、およびデバッグ データを出力します。

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

参照

データ統合 (トラブルシューティング)