IBM Support

[Db2] JDBC トレース の確認方法

Question & Answer


Question

以下の資料取得ガイドに従って JDBC トレースを取得しました。必要な情報を取得できているか、確認する方法はありますか。

Answer

以下の点を確認の上、出力されたファイルを IBM テクニカル・サポートに送付してください。
  1. トレース取得手順で指定した出力ファイルに問題再現時のタイムスタンプが含まれていること
  2. エラー調査の場合は、エラー・コードが含まれていること
  3. traceLevel が IBM テクニカル・サポートに指定されたレベルであること


例: アプリケーションに Db2 のエラー (Exception) が返る場合
  1. アプリケーションの画面やログで Exception の内容と出力された時刻を確認します。
  2. 取得した JDBC トレースに、アプリケーション側で確認したエラーと時刻が一致したエントリーが捉えられていることを確認します。
    JDBC トレース出力例:
    [17/04/28 9:53:24:356 JST] 0000047b ConnectionEve A   J2CA0056I: 接続マネージャーは、リソース jdbc/LOCDBPG のリソース・アダプターから致命的接続エラーを受け取りました。 例外: com.ibm.db2.jcc.am.DisconnectNonTransientConnectionException: [jcc][t4][2030][11211][3.69.66] 接続の基礎となるソケット、ソケット入力ストリーム、またはソケット出力ストリーム上での操作中に、
    通信エラーが発生しました。  エラーのロケーション: Reply.fill() - socketInputStream.read (-1)。  メッセージ: Broken pipe。 ERRORCODE=-4499, SQLSTATE=08001:java.net.SocketException: Broken pipe
    [17/04/28 9:53:24:363 JST] 0000047b logwriter     3   [jcc][Time:2017-04-28-09:53:24.363][Thread:WebContainer : 1][DB2XAConnection@179416af]removeConnectionEventListener (WSRdbManagedConnectionImpl@2d493c1f) called
    [17/04/28 9:53:24:363 JST] 0000047b logwriter     3   [jcc][SystemMonitor:start]
  3. JDBC の traceLevel が IBM テクニカル・サポートに指定されたレベルであることを、トレース内のプロパティーの出力で確認します。※以下は traceLevel が -1 の場合の例です。
    JDBC トレース出力例:
    [jcc] END TRACE_DRIVER_CONFIGURATION
    [jcc] BEGIN TRACE_CONNECTS
    [jcc] Attempting connection to db01:50000...
    [jcc] Using properties: { maxStatements=0, currentPackagePath=null, currentLockTimeout=-2147483647, timerLevelForQueryTimeOut=0, optimizationProfileToFlush=null, timeFormat=1,
     <中略>
    activateDatabase=0, xaNetworkOptimization=true, plugin=null, traceOption=0, pdqProperties=null, currentSchema=null, CR_LOCKBLOB=null, traceLevel=-1, enableRowsetSupport=0, clientDebugInfo=null, dataSourceName=null, enableAlternateServerListFirstConnect=0, maxRetriesForClientReroute=1, fetchSize=-1, queryDataSize=0, queryTimeoutInterruptProcessingMode=1, alternateGroupServerName=null, clientRerouteAlternateServerName=db01,db02, DBTEMP=/tmp, enableT2zosLBF=0,
     <中略>
    deferPrepares=true, currentDegree=null, DUMPMEM=null, memberConnectTimeout=10 }
    [jcc] END TRACE_CONNECTS
    ただし、循環型のトレースの場合には、上記のように TRACE_CONNECTS セクションが出力されず、プロパティーの値を確認できないケースもあります。その場合は、最低限問題再現時のタイムスタンプが含まれていることを確認の上、出力ファイルと、構成ファイルを使用している場合は DB2JccConfiguration.properties を IBM テクニカル・サポートに送付してください。

    なお、db2.jcc.tracePolling グローバル構成プロパティーを設定していて、Java アプリケーションを起動後に db2.jcc.override.traceFile プロパティーまたは db2.jcc.override.traceDirectory プロパティーを設定してトレースを開始した場合には、出力ファイルから、以下のようにグローバル構成トレース・プロパティーが変更されたことと、[jcc] END TRACE_DRIVER_CONFIGURATION のタグで、db2.jcc.traceLevel を確認します。
    JDBC トレース出力例:
    Global trace properties changes detected ..
    Old trace override properties :
    traceLevel=null traceFile=null traceDirectory=null traceFileAppend=null traceOption=null traceFileSize=null traceFileCount=null
    New trace override properties :
    traceLevel=2147483647 traceFile=null traceDirectory=/tmp/jcc traceFileAppend=false traceOption=0 traceFileSize=1048576 traceFileCount=2
    
    [jcc] BEGIN TRACE_DRIVER_CONFIGURATION
     <中略>
    [jcc] Dumping all file properties: { db2.jcc.traceFileAppend=true, db2.jcc.override.traceDirectory=/tmp/jcc, db2.jcc.tracePollingInterval=15, db2.jcc.traceLevel=-1, db2.jcc.tracePolling=true }
    [jcc] END TRACE_DRIVER_CONFIGURATION
関連情報
[Db2] パスポート・アドバンテージによく寄せられる質問
IBM Data Server Driver for JDBC and SQLJ を使用するアプリケーションのトレースの取得

お問い合わせ先
技術的な内容に関して、パスポート・アドバンテージの契約のもと Db2 テクニカル・サポートへお問い合わせください。
Db2 テクニカル・サポート

[{"Type":"MASTER","Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSEPGG","label":"Db2 for Linux, UNIX and Windows"},"ARM Category":[{"code":"a8m500000008PmVAAU","label":"Programming Interface-\u003EJDBC"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"}]

Document Information

Modified date:
02 February 2024

UID

swg22006573