ログの設定
ドライバーのログ記録を有効にすると、問題の診断に利用することができます。
ドライバーに関する情報は、次の方法を使用してログに記録できます。
-
ログに記録された情報を .log ファイルに保存するには、ログファイルの使用を参照してください。
-
ログに記録された情報を DriverManager で指定された LogStream または LogWriter に送信するには、LogStream または LogWriter の使用を参照してください。
接続 URL でドライバーに構成情報を提供します。接続 URL の構文の詳細については、接続 URL の構築を参照してください。
ログファイルの使用
問題をキャプチャするのに十分な時間だけログ記録を起動します。ログ記録によってパフォーマンスが低下し、ディスク容量が大量に消費される可能性があります。
接続 URL での LogLevel キーを設定して、ログファイルに含まれる詳細情報の量を指定しながら、ログ記録を有効にします。次の表に、Amazon Redshift JDBC ドライバーバージョン 2.1 で提供されるログレベルを、冗長性の低いものから高いものの順に示します。
LogLevel 値 | 説明 |
---|---|
1 |
ドライバーの中断につながる重大なエラーイベントを記録します。 |
2 |
ドライバーの実行を続行するよう許可する可能性があるエラーイベントを記録します。 |
3 |
アクションが実行されなかった場合にエラーが発生する可能性のあるイベントをログに記録します。このレベルのロギングと、このレベルを超えるロギングのレベルでは、ユーザーのクエリもログに記録されます。 |
4 |
ドライバーの進行状況を示す全般的な情報を記録します。 |
5 |
ドライバーのデバッグに役立つ詳細な情報を記録します。 |
6 |
すべてのドライバーアクティビティを記録します。 |
ログファイルを使用するログを設定するには
-
LogLevel プロパティを、ログファイルに含める必要があるレベルの情報に設定します。
-
LogPath プロパティを、ログファイルを保存するフォルダへのフルパスに指定します。
例えば、次の接続 URL はログレベル 3 を有効にし、ログファイルを C:\temp フォルダ
jdbc:redshift://redshift.company.us-west- 1.redshift.amazonaws.com:9000/Default;DSILogLevel=3; LogPath=C:\temp
に保存します。 -
新しい設定が有効になっていることを確認するには、JDBC アプリケーションを再起動し、サーバーに再接続します。
Amazon Redshift JDBC ドライバーは、LogPath プロパティで指定された場所に次のログファイルを生成します。
-
接続に固有ではないドライバーのアクティビティをログに記録する redshift_jdbc.log ファイルです。
-
データベースへの接続ごとに redshift_jdbc_connection_[Number].log ファイル。[Number] は各ログファイルを識別する番号です。このファイルは、接続に固有のドライバーアクティビティをログに記録します。
-
LogPath 値が無効な場合、ドライバーはログに記録された情報を標準出力ストリームに送信します (System.out
)。
LogStream または LogWriter の使用
問題をキャプチャするのに十分な時間だけログ記録を起動します。ログ記録によってパフォーマンスが低下し、ディスク容量が大量に消費される可能性があります。
接続 URL で LogLevel キーを設定し、DriverManager で指定された LogStream または LogWriter に送信される詳細情報の量を指定しながら、ログ記録を有効にします。
LogStream または LogWriter を使用するログ記録を有効にするには
-
ドライバーの進行状況を示す一般情報をログに記録するようにドライバーを構成するには、LogLevel プロパティを 1 または INFO に設定します。
-
新しい設定が有効になっていることを確認するには、JDBC アプリケーションを再起動し、サーバーに再接続します。
LogStream または LogWriter を使用するログ記録を無効にするには
-
接続 URL から LogLevel プロパティを削除します。
-
新しい設定が有効になっていることを確認するには、JDBC アプリケーションを再起動し、サーバーに再接続します。