ロギング

コンポーネントのログをキャプチャすることは、エラーメッセージやその他の予期しない動作を診断するときに非常に役立ちます。

コンポーネントロギングのキャプチャを開始するには、2つの接続プロパティを設定する必要があります。

•ログファイル：ログファイルの名前と場所を指定するファイルパス。

•詳細度：これは、ログの詳細量を決定する数値（1〜5）です。 5つのレベルの内訳については、「接続のプロパティ」セクションのページを参照してください。

•MaxLogFileSize：制限に達すると、同じフォルダーに新しいログが作成され、日付と時刻が末尾に追加されます。デフォルトの制限は100MBです。 100 kB未満の値は、代わりに100kBを値として使用します。

•MaxLogFileCount：ログファイルの最大ファイル数を指定する文字列。制限に達すると、同じフォルダに日付と時刻が追加された新しいログが作成され、最も古いログファイルが削除されます。サポートされる最小値は2です。0または負の値の値は、カウントに制限がないことを示します。

このプロパティを設定すると、コンポーネントは、認証の実行時やクエリの実行時など、さまざまなタスクを実行するときにログファイルにデータを入力します。指定したファイルがまだ存在しない場合は作成されます。

詳細レベルは、コンポーネントがログファイルに報告する詳細の量を決定します。 1〜5の詳細レベルがサポートされています。これらについて、次のリストで説明します。

1. Verbosityを1に設定すると、クエリ、クエリによって返される行数、実行の開始と所要時間、およびエラーがログに記録されます。

2. Verbosityを2に設定すると、Verbosity 1に含まれるすべてのものと、該当する場合はリクエストに関する追加情報がログに記録されます。

3. Verbosityを3に設定すると、リクエストの本文とレスポンスがさらにログに記録されます。

4. Verbosityを4に設定すると、データソースとのトランスポートレベルの通信がさらにログに記録されます。これにはSSLネゴシエーションが含まれます。

5. Verbosityを5に設定すると、データソースとの通信と、問題のトラブルシューティングに役立つ可能性のある追加の詳細が追加でログに記録されます。これには、インターフェイスコマンドが含まれます。

通常の操作では、Verbosityを1より大きく設定しないでください。かなりの量のデータがより高い詳細度でログに記録される可能性があり、実行時間が遅れる可能性があります。

特定のカテゴリの情報を表示/非表示にしてログに記録されたコンテンツをさらに絞り込むには、LogModulesを参照してください。

ログファイルに記録される正確な情報を絞り込むことができます。これは、LogModulesプロパティを使用して実行できます。

このプロパティを使用すると、セミコロンで区切られたロギングモジュールのリストを使用してロギングをフィルタリングできます。

すべてのモジュールは4文字の長さです。 3文字を含むモジュールには、必要な末尾の空白スペースがあることに注意してください。使用可能なモジュールは次のとおりです。

•EXEC：クエリの実行。元のSQLクエリ、解析されたSQLクエリ、および正規化されたSQLクエリの実行メッセージが含まれます。クエリとページの成功/失敗のメッセージもここに表示されます。

•情報：一般情報。接続文字列、ドライバーバージョン（ビルド番号）、および初期接続メッセージが含まれます。

•HTTP：HTTPプロトコルメッセージ。 HTTP要求/応答（POSTメッセージを含む）、およびKerberos関連のメッセージが含まれます。

•SSL：SSL証明書メッセージ。

•OAUTH：OAuth関連の失敗/成功メッセージ。

•SQL：SQLトランザクション、SQL一括転送メッセージ、およびSQL結果セットメッセージが含まれます。

•META：メタデータキャッシュとスキーマメッセージ。

•TCP：TCPトランスポート層メッセージの受信および進行中のrawバイト。

これらのモジュールは、Verbosityを考慮した後に取得される情報を改良することに注意してください。