pureQuery 컴포넌트 로깅 및 추적의 특성 설명

Java 애플리케이션의 경우 pureQuery Runtime API, pureQuery 클라이언트 최적화, CMX 모니터링과 같은 다른 pureQuery 컴포넌트의 로그 레벨을 제어할 수 있습니다. 또한 pureQuery Runtime이 모니터하는 데이터베이스 로그 이벤트를 저장소에 보낼 수도 있습니다.

pureQuery는 java.util.logging 프레임워크를 사용합니다. pureQuery 로깅 및 java.util.logging Framework에 대한 정보는 Java 애플리케이션 사용법 참고의 내용을 참조하십시오.

pureQuery 컴포넌트 로깅 매개변수

pureQuery 컴포넌트 기반 로깅은 다음 로그 레벨을 지원합니다. 최소 세부사항에서 In order 최대 세부사항 순서로 레벨은 다음과 같습니다.
  • OFF
  • SEVERE
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST
  • ALL
기본 레벨은 OFF입니다.
다음 pureQuery Runtime 특성은 pureQuery 컴포넌트 기반 로깅을 제어합니다.
com.ibm.pdq
특정 컴포넌트가 추가 지정되지 않는 경우 모든 pureQuery 컴포넌트의 로그 레벨을 지정합니다.
com.ibm.pdq.api
인라인 메소드 또는 DAO 스타일 pureQuery API를 실행할 때 로그 레벨을 지정합니다.
com.ibm.pdq.api.static
pureQuery Runtime DAO가 정적으로 실행하는 로그 레벨을 지정합니다.
com.ibm.pdq.api.dynamic
pureQuery Runtime DAO 스타일이 동적으로 실행하는 로그 레벨을 지정합니다.
com.ibm.pdq.co
pureQuery 클라이언트 최적화가 SQL문을 실행 중일 때 로그 레벨을 지정합니다.
com.ibm.pdq.co.static
pureQuery 클라이언트 최적화가 SQL문을 정적으로 실행 중일 때 로그 레벨을 지정합니다.
com.ibm.pdq.co.dynamic
pureQuery 클라이언트 최적화가 SQL문을 동적으로 실행 중일 때 로그 레벨을 지정합니다.
com.ibm.pdq.cmx
CMX 클라이언트 모니터링의 로그 레벨을 지정합니다.
com.ibm.pdq.database
pureQuery Runtime에서 레코드하는 데이터베이스 이벤트를 로그하는 로그 레벨을 지정합니다. 로그 레벨 설정을 이 특성에 명시적으로 설정해야 합니다. 특성은 com.ibm.pdq 특성의 하위 특성이 아닙니다.

다음 테이블에는 com.ibm.pdq.database 특성에 로그된 데이터베이스 이벤트가 나열됩니다.

표 1. pureQuery 데이터베이스 이벤트 로깅의 로그 레벨
로그 레벨 데이터베이스 이벤트
CONFIG dumpLogsOnSqlCodes에서 나열되고 dumpLogsExcludedSqlCodes에서 나열되지 않은 SQL 오류
FINE 저장소의 pureQuery 특성을 새로 고침
FINER pureQuery 클라이언트 최적화에 의한 SQL문의 동적 PREPARE
FINEST pureQuery 클라이언트 최적화에 의한 SQL문의 정적 PREPARE

애플리케이션이 pureQuery 데이터의 저장소를 사용하도록 구성되는 경우 pureQuery Runtime은 저장소에서 로그 레코드의 작은 서브세트를 저장할 수 있습니다. 저장소는 전역 pdq.properties 파일에 지정해야 합니다. 애플리케이션 레벨 또는 데이터 소스 레벨에 지정되는 저장소 위치는 로깅 목적을 위해 무시됩니다.

로그 레코드는 IBMPDQ.LOG 테이블에 저장됩니다. 저장소에 저장된 모든 로그 레코드를 보기 위해 다음 SQL문을 실행할 수 있습니다.
 select * from ibmpdq.log
주: 로그 레코드를 기존 저장소에 저장하려면 저장소를 업그레이드해야 합니다. ManageRepository 유틸리티의 -upgrade 옵션을 참조하십시오.

사용 참고사항

독립형 Java 사용자의 경우 로그 레벨을 pureQuery Runtime pdq.properties 파일 및 기타 방법으로 관리할 수 있습니다. 애플리케이션이 dq.properties로 pureQuery 컴포넌트 로깅을 관리하는 경우 로그 파일은 디스크에 상주할 수 있거나 로그의 컨텐츠를 저장소에 저장할 수 있습니다. pureQuery 컴포넌트 로깅의 로그 레벨을 제어하기 위해 JRE가 JRE/lib 폴더의 logging.properties 파일을 지원합니다.

pureQuery 컴포넌트 로깅 특성의 경우 하위 로그 특성이 상위 레벨의 로그 설정을 상속받습니다. 하위 로그 설정을 명시적으로 설정하여 상위 레벨 로그 설정을 겹쳐쓸 수 있습니다.

예를 들어, com.ibm.pdq.co 특성의 로그 레벨만 FINE으로 설정하는 경우 하위 특성 com.ibm.pdq.co.staticcom.ibm.pdq.co,dynamic의 로그 레벨도 FINE입니다.

java.util.logging이 제공하는 메소드를 사용하여 로그 레벨을 설정할 수 있습니다. 기타 애플리케이션에는 java.util.logging 로거를 관리하기 위한 기타 메소드도 있을 수 있습니다.

pureQuery 컴포넌트 로그 특성의 로그 레벨을 설정하지 않는 경우 WebSphere® 환경의 해당 상위 레벨(예: com.ibm)을 상속받습니다.

다음 WebSphere Application Server 예는 pureQuery 컴포넌트 로그 특성을 모두로 설정합니다.

com.ibm.pdq.*=all 

pureQuery Runtime 컴포넌트 특성의 추적 레벨 지정

pureQuery 컴포넌트 추적의 로그 레벨을 설정하기 위해 전역 pdq.properties 파일에서 다음 구문을 사용할 수 있습니다.

pdq.traceLevel=OFF 
pdq.traceLevel.com.ibm.pdq.co=FINER
pdq.traceLevel.com.ibm.pdq.co.static=FINE

해당 pureQuery Runtime 특성은 저장소 또는 디스크의 pdq.properties 파일에 지정할 수 있습니다. pureQuery Runtime이 새로 고침 간격 시 저장소의 특성을 새로 고칠 때 로그 레벨이 pureQuery 로거에 적용됩니다.

pureQuery 컴포넌트 로깅 특성의 pdq.traceFile에 해당하는 항목은 없습니다.

저장소에서 pureQuery Runtime 추적 특성 지정

pdq.traceLevel, pdq.traceLevel.com.ibm.pdq.* 및 특성 dumpLogsOnSqlCodes 추적에 사용되는 pureQuery Runtime 특성은 저장소에 지정될 수 있습니다. pdq.properties 파일에서 pureQuery Runtime을 설정하고 파일의 정보를 저장소에 업로드하십시오. 저장소 새로 고침 간격이 지정되면 지정된 시간에 저장소에서 업데이트된 로그 특성을 읽고 pureQuery Runtime으로 사용 가능한 애플리케이션에 이를 적용합니다.

저장소는 전역 pdq.properties 파일에 지정해야 합니다. 애플리케이션 또는 데이터 소스 레벨에 지정되는 저장소 위치는 로깅 목적을 위해 무시됩니다.

-pureQueryProperties 옵션과 함께 ManageRepository 유틸리티를 사용하여 pureQuery Runtime 특성 파일을 저장소에 업로드할 수 있습니다. 다음 명령이 스크립트에서 실행되고 추적 레벨을 포함하는 pdq.properties 파일이 저장소에 업로드됩니다.

java -cp %PQ_USER_CLASSPATH% com.ibm.pdq.tools.ManageRepository 
   -update runtimeGroup
   -pureQueryProperties pdqrep.properties 
   -runtimeGroupID %1 -runtimeGroupVersion %2 
   -repositoryURL %PQ_REP_URL% 
   -repositoryUsername %PQ_REP_USERNAME% 
   -repositoryPassword %PQ_REP_PASSWORD% 
   -repositoryDriverClass com.ibm.db2.jcc.DB2Driver

스크립트가 명령행에서 실행되는 경우 변수 %1%1은 스크립트가 실행될 때 지정된 값으로 대체됩니다. %PQ_USER_CLASSPATH%와 같은 변수는 환경 변수가 지정한 지정된 값으로 대체됩니다.


피드백