로깅 및 추적에 대한 특성 설명

pureQuery는 로그 파일에 전송된 정보의 유형을 제어하는 구성 가능한 심각도 레벨과 함께 로깅 및 추적 기능을 제공합니다.

다음과 같은 두 가지 특성을 설정할 수 있습니다.

pdq.traceFile
로그 정보가 기록되는 실제 파일을 지정합니다. 절대 경로 또는 pureQuery Log 유틸리티가 실행되는 디렉토리와 관련된 경로를 사용할 수 있습니다.
Java 애플리케이션에 대한 파일이 이미 있는 경우 pureQuery는 새 로그 엔트리에 대한 파일을 사용하기 전에 파일의 컨텐츠를 삭제합니다.
pdq.traceLevel
로그 파일에 작성할 세부사항의 레벨을 지정합니다. 최소 세부사항에서 In order 최대 세부사항 순서로 레벨은 다음과 같습니다.
  • OFF
  • SEVERE
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST
  • ALL
기본 레벨은 OFF입니다.

Java 애플리케이션 사용법 참고

pureQuery는 java.util.logging 프레임워크를 사용합니다. 해당 프레임워크 내에서 pureQuery는 상위 로그 프로그램의 이름을 com.ibm.pdq.logger로 지정합니다. Java™ 로그 API 규칙 및 도구를 사용하여 사용자 및 사용자 애플리케이션은 pureQuery 로그 메시지가 com.ibm.pdq 로그 프로그램에 전달되도록 해당 로그 프로그램의 로그 레벨 및 로그 파일을 설정할 수 있습니다.

java.util.logging 프레임워크 아래에 있는 로그 프로그램을 구성하는 관리 도구를 제공하는 모든 애플리케이션 서버(AS)(예: WebSphere® Application Server 6.1)는 pureQuery 로깅 및 추적을 제어하도록 com.ibm.pdq 로그 프로그램을 구성할 수 있습니다. 이러한 구성은 pureQuery 특성으로 pureQuery 로그를 구성하는 대안을 제공합니다. pureQuery는 com.ibm.pdq 로그 프로그램 레벨이 pureQuery pdq.traceLevel 특성에 지정된 레벨보다 높고 com.ibm.pdq 로그 프로그램 레벨이 INFO보다 높은 경우에 com.ibm.pdq 로그 프로그램 레벨을 사용합니다. WebSphere Application Server 통합 솔루션 콘솔에서 문제점 해결 > 로그 및 추적을 선택하여 com.ibm.pdq 로그 프로그램 레벨을 설정할 수 있습니다.

com.ibm.pdq 로그 프로그램 추적 레벨이 INFO보다 포괄적인 레벨로 설정되었고 pureQuery 특성이 com.ibm.pdq 로그 프로그램 추적 레벨보다 포괄적인 레벨을 지정하지 않는 경우, pureQuery는 com.ibm.pdq 로그 프로그램의 레벨을 상속합니다.

pureQuery 애플리케이션에 WebSphere Application Server를 사용할 계획인 경우, WebSphere Application Server에 대한 로그에 pureQuery 로그 항목을 표시하려면 INFO보다 높은 레벨을 설정해야 합니다.

pureQuery는 로그를 JDBC 드라이버 로그와 명시적으로 통합하지 않습니다. 하지만 Java 로깅 API를 사용하여 로그하는 JDBC 드라이버는 로그 프레임워크 통합에 참여할 수 있습니다. 이는 JDBC 드라이버가 Java 로그 프레임워크도 사용하고 두 로그 프로그램이 모두 동일한 목표에 작성하도록 구성된 경우에만 pureQuery 및 JDBC 드라이버 로그 항목이 동일한 로그에 인터리브됨을 의미합니다.

로깅이 pureQuery에 대해 구성된 경우, pureQuery 아래에서 실행되는 pureQuery가 아닌 API 애플리케이션에서 발생하는 예외는 pureQuery 로그 파일에 표시됩니다. 일부 pureQuery 엔트리는 JDBC 드라이버 로그가 구성된 경우 이 로그에도 표시될 수 있습니다.

getJccSpecialRegisterProperties() 메소드에 대한 호출의 결과 로깅

애플리케이션이 IBM® Data Server Driver for JDBC and SQLJ를 사용하여 지원되는 DB2® 데이터베이스에 연결하고 Connection 오브젝트에 대해 getJccSpecialRegisterProperties() 메소드를 호출하는 경우 pureQuery는 오브젝트에 대해 해당 메소드를 처음 호출한 결과를 로그할 수 있습니다. pureQuery가 로그에 기록하는 메시지에는 드라이버가 데이터베이스에 대해 지원하는 특수 레지스터에 대한 널(NULL)이 아닌 모든 값이 나열됩니다.

로그에서 이 메시지를 확인하려면 추적 레벨을 FINE으로 설정하십시오.

DB2 CLI 및 IBM Data Server Driver 사용법 참고

DB2 CLI(Call Level Interface) 또는 IBM Data Server Driver를 pureQuery 런타임에 사용하는 경우 pureQuery Runtime 특성을 구성 키워드로 사용할 수 있습니다.

db2cli.ini 또는 dsdriver.cfg 구성 파일에 두 개의 키를 설정할 수 있습니다.

IBM CLI 키워드 구문
traceFile = level

CLI 애플리케이션이 실행하는 디렉토리에 대한 절대 경로나 상대 경로를 사용할 수 있습니다. 파일이 존재하면 새 로그 메시지가 파일의 기존 컨텐츠에 추가됩니다.

traceLevel = path-to-logfile
IBM Data Server Driver 구성 구문
<parameter name="traceFile" value="level" />

CLI 애플리케이션이 실행하는 디렉토리에 대한 절대 경로나 상대 경로를 사용할 수 있습니다. 파일이 존재하면 새 로그 메시지가 파일의 기존 컨텐츠에 추가됩니다.

<parameter name="traceLevel" value="path-to-logfile" />
.NET 연결 문자열 키워드에 대한 해당 IBM Data Server Provider
N/A

다음 라인은 db2cli.ini 파일에서 traceFile을 /user/CLIOPTtraces.log로 설정하고 traceLevel을 INFO로 설정합니다.

traceFile=/user/CLIOPTtraces.log
traceLevel=INFO

피드백