LogModules
ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。
データ型
string
デフォルト値
""
解説
本製品 は、実行する各操作の詳細を Logfile 接続プロパティで指定されたログファイルに書き込みます。
ログに記録される各操作は、モジュールと呼ばれるカテゴリに分類されます。各モジュールには対応する短いコードがあり、個々の 本製品 の操作がどのモジュールに属するかを示すラベルとして使用されます。
この接続プロパティにモジュールコードをセミコロン区切りのリストで設定すると、指定したモジュールに属する操作のみがログファイルに書き込まれます。この設定は今後のログ記録にのみ適用され、既存のログファイルの内容には影響しません。例: INFO;EXEC;SSL;META;
デフォルトでは、すべてのモジュールの操作がログに含まれます。
モジュールを明示的に除外するには、先頭に「-」を付けます。例: -HTTP
サブモジュールにフィルターを適用するには、<モジュール名>.<サブモジュール名> の構文で指定します。たとえば、次の値を設定すると、本製品 は HTTP モジュールに属するアクションのみをログに記録し、さらに HTTP モジュールの Res サブモジュールに属するアクションを除外します: HTTP;-HTTP.Res
Verbosity 接続プロパティによるログファイルのフィルタリングは、この接続プロパティによるフィルタリングよりも優先されます。そのため、Verbosity 接続プロパティで指定したレベルよりも高い詳細レベルの操作は、この接続プロパティで指定したモジュールに属していても、ログファイルには出力されません。
次の表は、使用可能なロギングモジュールとサブモジュール、およびそれらのログが機密データを公開するリスクを示すセキュリティ分類を示しています。これらの分類は本製品が意図するロギング動作を反映しており、ログを共有する際にどのモジュールを含めるかを判断する際に役立ちます。プロバイダー固有のコードによってモジュールの下に追加情報がログに記録される場合があるため、組織外にログを共有する前に必ずログの内容を確認してください。
- 安全: 内部イベント、ライフサイクル、プロトコルステータス、スキーマ、メタデータ。顧客データは含まれません。
- 注意: リテラル値を含むSQL、リクエストフィルター、または顧客データを間接的に公開する可能性がある引数値。
- 危険: 結果セット、レスポンスボディ、ペイロード、生のTCP データ、一括アップロード、またはその他の顧客データ。
| モジュール | サブモジュール | 分類 | 備考 |
| INFO | (モジュールレベル) | 安全 | 接続文字列がログに記録されます。パスワード、シークレット、トークンは編集(マスキング)されますが、ホスト名、ユーザー名、接続オプションは残ります。 |
| INFO | Connec | 安全 | 接続のライフサイクル。 |
| INFO | Messag | 安全 | ドライバー内部の情報。 |
| EXEC | Messag | 安全 | ドライバー内部の実行イベント。 |
| EXEC | Normlz | 注意 | リテラル値を保持したまま書き換え/正規化されたクエリ(例:WHERE Email = '[email protected]')。 |
| EXEC | Origin | 注意 | ユーザーが入力したそのままのSQL。クエリ内のリテラル値に個人情報(PII)が含まれる場合があります。 |
| EXEC | Page | 安全 | ページングに関するメタデータ。 |
| EXEC | Parsed | 注意 | リテラル値を含む解析済みSQL。 |
| HTTP | KERB | 注意 | Kerberos に関連するHTTP。認証トークンが含まれる可能性があります。 |
| HTTP | Messag | 安全 | ドライバー内部のHTTP。 |
| HTTP | Unpack | 危険 | 解凍されたAPI レスポンスはソースデータです。 |
| HTTP | Res | 危険 | レスポンスボディはソースデータです。 |
| HTTP | Req | 注意 | リクエストボディには、クエリフィルターまたはPOST 値が含まれる場合があります。 |
| WSDL | — | 安全 | WSDL/XSD の生成のみ。 |
| SSL | Certif | 安全 | 証明書のメタデータ。 |
| AUTH | Messag | 安全 | 認証に関するメッセージ。 |
| AUTH | OAuth | 安全 | OAuth フローに関するメッセージ。 |
| AUTH | Krbros | 安全 | Kerberos に関するメッセージ。 |
| SQL | Bulk | 安全 | 一括クエリ実行のステータス更新。 |
| SQL | Cache | 安全 | キャッシュデータの読み書きステータス。 |
| SQL | Messag | 安全 | ドライバー内部のSQL トランザクションイベント。 |
| SQL | ResSet | 安全 | 結果セットに関するメタデータ。 |
| SQL | Transc | 安全 | トランザクションのメタデータ。 |
| META | Cache | 安全 | カラムおよびテーブルのメタデータの取得/書き込みに関するメッセージ。 |
| META | Schema | 安全 | スキーマメタデータに関するメッセージ。 |
| META | MemSto | 安全 | インメモリメタデータキャッシュのイベント。 |
| META | Storag | 安全 | メタデータの永続化イベント。 |
| FUNC | Errmsg | 安全 | ドライバーからのエラーメッセージ。 |
| TCP | Send | 注意 | 送信される生のTCP バイトデータ。顧客が書き込むデータがログに記録されます。読み取りの場合は安全です。 |
| TCP | Receiv | 危険 | 受信する生のTCP バイトデータ。ソースのペイロードです。 |
| FTP | Info | 安全 | プロトコルのステータス。 |
| FTP | Client | 注意 | クライアントのアクションには、ファイル名や認証情報が含まれる場合があります。 |
| FTP | Server | 危険 | サーバーのレスポンスには、ファイルの内容が含まれる場合があります。 |
| SFTP | Info | 安全 | プロトコルのステータス。 |
| SFTP | To_Server | 注意 | クライアントのアクションには、ファイル名や認証情報が含まれる場合があります。 |
| SFTP | From_Server | 危険 | サーバーのレスポンスには、ファイルの内容が含まれる場合があります。 |
| POP | Client | 注意 | クライアントのアクション。メールボックスまたは認証情報への参照が含まれます。 |
| POP | Server | 危険 | サーバーのレスポンスには、メッセージ本文が含まれる場合があります。 |
| POP | Status | 安全 | プロトコルのステータス。 |
| SMTP | Client | 注意 | クライアントのアクション。メッセージのメタデータが含まれます。 |
| SMTP | Server | 注意 | サーバーのレスポンス。主にステータスに関する情報です。 |
| SMTP | Status | 安全 | プロトコルのステータス。 |
| CORE | — | 安全 | 製品内部の操作。 |
| DEMN | — | 安全 | SQL リモーティングの内部処理。 |
| CLJB | Commit | 安全 | 一括ジョブのステータス更新のみをログに記録します。 |
| SRCE | — | 注意 | 使用方法はドライバーによって異なります。 |
| TPJE | Trace | 安全 | 製品の低レベル操作に関する高度なメッセージ。 |