ODL 구성

ODL 로깅 형식을 사용하는 각 Oracle Enterprise Performance Management System 제품에는 로깅 구성 파일인 logging.xml이 하나 이상 있습니다. EPM System 구성요소에는 loggingCOMPONENT_NAME.xml 형식으로 된 설명 이름이 있습니다.

로깅 구성 파일은 log_handlers 및 loggers 두 개의 섹션으로 이루어져 있습니다. log_handlers 섹션은 로거 및 해당 매개변수를 정의하고 loggers 섹션은 사용할 로깅 레벨 및 log_handler를 비롯한 세부정보를 확인합니다.

지정할 수 있는 log_handler 등록정보 목록은 표 3-9를 참조하십시오.

ODL 로깅 레벨

표 3-7 ODL 로깅 레벨

레벨 설명
INCIDENT_ERROR:1 알 수 없는 이유로 인해 발생한 심각한 문제와 관련된 메시지입니다. 사용자는 오라클 고객지원센터에 문의하여 문제를 해결해야 합니다.
ERROR:1 시스템 관리자가 즉각적으로 주의를 기울여야 하지만 EPM System 구성요소의 결함으로 인해 발생하지는 않은 심각한 문제와 관련된 메시지입니다.
WARNING:1 시스템 관리자가 검토해야 하는 잠재적 문제와 관련된 메시지입니다.
NOTIFICATION:1 주요 하위 구성요소 또는 기능의 활성화나 비활성화와 같은 주요 수명 주기 이벤트와 관련된 메시지입니다.
NOTIFICATION:16 EPM System 구성요소의 일반 이벤트와 관련된 메시지입니다.
TRACE:1 EPM System 구성요소의 일반 사용자에게 의미 있는 이벤트에 대한 추적 또는 디버그 메시지입니다.
TRACE:16 오라클 고객지원센터에서 EPM System 구성요소에 대한 문제를 진단하는 데 사용할 수 있는 자세한 추적 또는 디버그 메시지입니다.
TRACE:32 매우 자세한 추적 또는 디버그 메시지이며 일반적으로 오라클 개발자가 오류가 발생한 소스를 찾기 위해 사용합니다.

ODL 구성 파일: 단일 관리 서버 배포

EPM System 구성요소를 단일 관리 서버에 배포하면 모든 배포된 Java 웹 애플리케이션에 대해 통합 로깅 구성 파일 logging.xml이 생성됩니다. Windows 서버의 경우 이 파일은 일반적으로 MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/EPMServer0에 있습니다.

ODL 구성 파일: 표준 배포

EPM System 표준 배포에서는 각각의 배포된 Java 웹 애플리케이션에 대해 하나의 로깅 구성 파일 logging.xml이 생성됩니다. Windows 서버의 경우 이러한 파일의 위치는 일반적으로 다음과 같습니다.

표 3-8 표준 배포의 ODL 구성 파일 위치

구성요소 logging.xml 위치
Administration 서버(Oracle WebLogic Server Administration Console, Oracle Web Services Manager, Enterprise Manager) MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/AdminServer/logging.xml
Oracle Hyperion Provider Services MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/AnalyticProviderServices0/logging.xml
Oracle Hyperion Calculation Manager MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/CalcMgr0/logging.xml
Oracle Essbase Administration Services MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/EssbaseAdminServices0/logging.xml
Oracle Hyperion Foundation Services MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/FoundationServices0/logging.xml
Oracle Hyperion Financial Management 웹 MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/HFMWeb0/logging.xml
Oracle Hyperion Planning MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/Planning0/logging.xml

ODL 구성 파일 수정

logging.xml에 정의된 로거의 등록정보를 수정하여 로깅되는 메시지 레벨을 결정합니다. 기본적으로 EPM System 구성요소의 일반 작업에 적합한 로깅 레벨은 logging.xml에 설정됩니다. 추가 로그 처리기 매개변수를 설정하여 로깅 동작을 변경할 수 있습니다. 예를 들어 로그 처리기에 rotationFrequency 매개변수를 포함하여 로깅 파일 순환 빈도를 지정할 수 있습니다. 포괄적인 매개변수 목록은 표 3-9를 참조하십시오.

표 3-9 구성 가능한 ODL 로그 등록정보

로그 등록정보 설명

path

로그 경로

format

사용할 형식

권장되는 값은 ODL-Text입니다.

maxFileSize

각 로그 파일의 최대 크기(바이트)

기본 로그 파일이 지정된 크기에 도달하면 로그 순환이 트리거되고 기본 로그 파일이 아카이브되며 새 로그 파일이 생성됩니다.

maxLogSize

전체 로그의 최대 크기(바이트)

더 오래된 아카이브 파일이 삭제되어 총 로그 크기가 지정된 한도 내로 유지됩니다.

rotationFrequency

로그 순환 빈도(분)

값은 숫자(분)나 단어 hourly, daily 또는 weekly여야 합니다. (이 설정은 대소문자를 구분하지 않습니다.)

baseRotationTime

시간을 기반으로 하는 로그 순환의 기준 시간(예: rotationFrequency 설정의 시작점)

기본값: 1970년 1월 1일, UTC

다음 형식 중 하나를 사용합니다.

  • HH:mm

  • yyyy-MM-dd

  • yyyy-MM-ddT-HH:mm

  • yyyy-MM-dd-HH:mm:ss.sTZ. 여기서, TZ는 시간대 표시기이며 UTC의 경우 Z이거나 그리니치 표준시의 오프셋(plus_or_minusHH:mmm 형식)일 수 있습니다.

주:

시간 형식이 시간대를 지정하지 않으면 현지 시간대가 사용됩니다.

retentionPeriod

로그 파일 유지 기간

지정된 기간보다 오래된 파일은 삭제됩니다. 로그 순환이 있는 경우에만 파일이 삭제됩니다. 백그라운드 스레드에서 로그 파일을 삭제하지 않습니다. 따라서 유지 기간이 만료된 후에도 한동안 파일이 삭제되지 않을 수 있습니다. 값은 숫자(분)나 day, week, month(30일) 또는 year(값은 대소문자를 구분하지 않음)여야 합니다.

encoding

사용할 문자 인코딩 유형

XML 파일은 확장 문자를 처리하도록 UTF-8 인코딩이어야 합니다. 기본값은 <?xml version="1.0" encoding="UTF-8" ?>입니다.

supplementalAttributes

각 로그 메시지에 추가할 수 있는 쉼표로 구분된 보충 속성 이름 목록

속성 값은 ExecutionContext 클래스에 정의되어야 합니다.

useSourceClassAndMethod

각 로그 메시지에 Java 소스 클래스 및 메소드 이름을 추가해야 할지 여부

값은 레벨 이름입니다. 지정된 레벨 이하의 메시지에는 소스 클래스 및 메소드 이름이 포함됩니다. 상수 true 및 false도 OFF 및 ALL의 별칭으로 사용할 수 있습니다. 기본값은 TRACE:1(Fine)입니다.

useDefaultAttributes

각 로그 메시지에 기본 속성 값을 추가해야 하는지 여부

지정할 수 있는 기본 속성은 HOST_ID, HOST_NWADDR 및 USER_ID입니다. 값은 true 또는 false여야 합니다. 기본값은 ODL-XML 형식의 경우 true이고 ODL-Text 형식의 경우 false입니다.

includeMessageArguments

메시지 ID도 있는 형식 지정된 로그 메시지와 함께 메시지 인수가 포함되는지 여부

가능한 값은 true(기본값) 또는 false입니다.

useThreadName

useThreadName 플래그는 처리기가 java.util.logging.LogRecord를 통해 제공되는 threadID가 아니라 실제 스레드 이름을 로깅하려고 시도할지 여부를 제어합니다.

플래그가 true이면 처리기는 실제 스레드 이름을 로깅하려고 합니다. 처리기가 실제 스레드 이름을 확인할 수 없는 경우도 있으며, 이 경우에는 threadID를 로깅합니다. 기본값은 true입니다.

useRealThreadId

useRealThreadId 플래그는 처리기가 java.util.logging.LogRecord를 통해 제공되는 threadID가 아니라 실제 스레드 ID를 로깅하려는 경우 이를 제어합니다.

플래그가 true이면 처리기는 실제 스레드 ID를 로깅하려고 합니다. 처리기가 실제 스레드 이름을 확인할 수 없는 경우도 있으며, 이 경우에는 threadID를 로깅합니다. 기본값은 false입니다. 실제 스레드 ID 로깅과 useThreadName 등록정보는 상호 배타적입니다. useThreadName이 true이면 useRealThreadId 등록정보 값이 무시됩니다.

locale

메시지 현지화를 위한 기본 로케일 대체

기본값은 EPM System Configurator에 설정된 기본 로케일입니다.

keepOpen

기본 로그 파일을 항상 열려 있는 상태로 유지할 것인지 로그 작업마다 열고 닫을 것인지 여부

가능한 설정은 true 및 false입니다. 기본 설정은 true이며, 기본 로그 파일을 항상 열려 있는 상태로 유지합니다.

대부분의 경우 기본값을 사용해야 합니다.

autoFlushLevel

자동 비우기 레벨 설정

ODLHandler를 사용하면 로그 레코드를 버퍼링할 수 있지만 레벨이 지정된 autoFlush 레벨 이상인 로그 레코드를 가져오는 경우 버퍼를 자동으로 비웁니다. 기본값은 NOTIFICATION:1입니다.

addJvmNumber

로그 파일 이름에 추가된 JVM 번호

JVM 번호는 시스템 등록정보 oracle.process.index를 통해 정의됩니다. 시스템 등록정보가 설정되지 않은 경우 이 옵션은 무시됩니다.

applicationContextProvider

ApplicationContext 인터페이스를 구현하는 클래스의 이름

클래스에는 기본 구성자가 있어야 합니다. 특수 값 disabled를 사용하여 애플리케이션 이름 로깅을 사용 안함으로 설정할 수 있습니다. 기본 애플리케이션 컨텍스트 제공자는 플랫폼에 따라 다릅니다. 대부분의 경우 이 등록정보를 설정하지 않아도 됩니다.

userContextProvider

UserContext 인터페이스를 구현하는 클래스의 이름

클래스에는 기본 구성자가 있어야 합니다. 특수 값 disabled를 사용하여 사용자 이름 로깅을 사용 안함으로 설정할 수 있습니다. 기본 사용자 컨텍스트 제공자는 플랫폼에 따라 다릅니다. 대부분의 경우 이 등록정보를 설정하지 않아도 됩니다.

로거 등록정보를 수정하여 구성요소를 디버깅하거나 오라클 고객지원센터가 EPM System 구성요소 관련 이슈를 확인하기 위해 요청하는 정보를 생성합니다.

예를 들어 Oracle Hyperion Shared Services 디버깅 메시지를 캡처하려면 각 Shared Services 로거 정의의 로깅 레벨을 TRACE:32로 변경합니다.

주:

디버깅이 완료되면 백업 복사본에서 원래 logging.xml을 복원하여 로깅 설정이 최적화되도록 합니다.

로깅 구성 파일을 수정하려면 다음을 수행합니다.

  1. 로깅 동작이 변경될 EPM System 구성요소의 로깅 구성 파일 백업 복사본을 생성합니다. EPM System 제품 로깅 매트릭스를 참조하십시오.

  2. 텍스트 편집기를 사용하여 logging.xml을 엽니다.

  3. 로거 정의를 찾습니다. 예를 들어 Shared Services의 로깅 레벨을 변경하려면 다음 로거 정의를 변경합니다.

    <logger name="oracle.EPMCAS" level="NOTIFICATION:1" useParentHandlers="false">
     <handler name="epmcas-handler" />
</logger>
<logger name="oracle.EPMCES" level="NOTIFICATION:1" useParentHandlers="false">
     <handler name="epmces-handler" />
</logger>
<logger name="oracle.EPMCMS" level="NOTIFICATION:1" useParentHandlers="false">
     <handler name="epmcms-handler" />
</logger>
<logger level="NOTIFICATION:1" name="oracle.EPMCSS">
     <handler name="epmcss-handler" />
</logger>

  4. 필요에 따라 level 등록정보를 수정하여 메시지 로깅 레벨을 변경합니다. 예를 들어 각 로거의 level 등록정보를 TRACE:32로 설정하여 자세한 디버그 메시지를 로깅합니다.

    ODL 로깅 레벨를 참조하십시오.

  5. logging.xml을 저장하고 닫습니다.

  6. EPM System 구성요소를 재시작하여 변경사항을 활성화합니다.