본문으로 건너뛰기

Pod에서 사용가능한 환경변수

다음은 오픈시프트의 Deployment Config에서 Environment Variable로 설정할 수 있는 OPENMARU APM khan-agent.conf 파일의 설정 항목이다.

설정항목설명기본값
OMAPM_APPLICATION_NAME애플리케이션 그룹명을 지정한다. 단, 빌드번호도 나오지 않는다.예) hostnamejboss-eap-egov-65-zs95r 와 같을 때 eap-${HOSTNAME:-:5} => eap-65
OMAPM_HOST
OMAPM_PORT443
OMAPM_TLStrue
OMAPM_AGENT_IP
OMAPM_USER_KEYNIL
OMAPM_INSTANCE_ID인스턴스 이름을 지정한다. 지정하면 [OMAPM_INSTANCE_ID설정값]-빌드번호-랜덤값 와 같이 표시한다.
지정하지 않으면 Deployment 이름이 사용된다.
예) hostnamejboss-eap-egov-65-zs95r 와 같을 때 eap-${HOSTNAME:-:5}-${HOSTNAME:-:6} => eap-65-zs95r
case1: instanceid-${RANDOM:4} ==> instanceid-qfPb
case1: instanceid-${RANDOM:4}-s ==> instanceid-qfPb-s
case1: instanceid-${IPADDR:3} ==> instanceid-23-10 (ip=192.168.23.10)
case1: instanceid-${HOSTNAME:-:2} ==> instanceid-apm (hostname=test-apm)
case1: instanceid-${HOSTNAME:-:2}-${IPADDR:3}-${RANDOM:4}-s ==> instanceid-apm-23.10-afcg-s (hostname=test-apm, ip=192.168.23.10)
OMAPM_AGENT_TYPEWAS
OMAPM_AGENT_COMPRESS_TYPE에이전트의 압축 알고리즘 타입을 지정한다.lzw (default=snappy)
OMAPM_APDEX_THRESHOLDAPDEX에서 사용자가 만족하는 응답시간을 지정한다.(기본값 3초)3.0
OMAPM_TRANSACTION_TRACE_ENABLED트랜잭션 Trace를 사용할지 여부를 지정한다.true
OMAPM_TRANSACTION_TRACE_THRESHOLD트랜잭션 Trace를 수집할 응답시간을 지정한다(ms단위) 기본값 : 500 ms500
OMAPM_TRANSACTION_TRACE_THRESHOLD
_UNDER_DETAIL_ENABLED
false
OMAPM_SQL_CAPTURE_ENABLED트랜잭션 Trace시 SQL 문장을 수집할지 여부를 지정한다.true
OMAPM_TRANSACTION_TRACE_SQL_PARAMETERIZEfalse
OMAPM_TRANSACTION_SAMPLING_INTERVAL동일한 URL에 대한 트랜잭션 수집 Interval을 지정한다. 10을 지정하면 동일한 URL에 대해 10개중 1개만 Trace를 보관한다.1
OMAPM_TRANSACTION_TRACE_SQL_STACKTRACE
_THRESHOLD
SQL 쿼리의 stacktrace 임계값을 ms로 설정한다.30000
OMAPM_TRANSACTION_TRACE_HEADER_ENABLED요청한 값의 HEADER 추적 활성화 여부를 지정한다.true
OMAPM_TRANSACTION_TRACE_HEADER_KEYS요청한 HEADER의 키 값
OMAPM_TRANSACTION_TRACE_COOKIE_ENABLED요청한 쿠키 추적 활성화 여부를 지정한다.false
OMAPM_TRANSACTION_TRACE_COOKIE_KEYS요청한 쿠키의 키 값JSESSIONID
OMAPM_TRANSACTION_TRACE_PARAMETER_KEYSURL의 매개변수 추가
OMAPM_DATABASE_FETCH_WARNINGSSQL ResultSet Fetch시 컴마로 구분한 지정된 갯수를 Fetch하면 경고를 출력한다.10000,20000,30000
OMAPM_DATABASE_CONN_LEAK_WARNINGDB의 커넥션 부족 경고false
OMAPM_DATABASE_POOL_STAT_ENABLED전체 DB pool 통계 모니터링 활성화 여부 지정false
OMAPM_DATABASE_POOL_STAT_INCLUDE_PATTERNSdatasource 이름을 쉼표로 구분하여 포함할 패턴 목록 지정
OMAPM_DATABASE_POOL_STAT_EXCLUDE_PATTERNSdatasource 이름을 쉼표로 구분하여 제외할 패턴 목록 지정
OMAPM_INCLUDE_PACKAGES
OMAPM_TRANSACTION_EXCLUDE_URL_PATTERNS모니터링에서 제외할 URL(정규식) 예) /test/test.**,\**/abc/test.*\*
OMAPM_TRANSACTION_EXCLUDE_URL_SUFFIX.gif,.swf,.css,.hwp,.xls,.xlsx,.eot,.pptx,
.ppt,.asf,.pdf,.txt,.flv,.mp3,.mp4,.doc,
.html,.wmv,.jpg,.zip,.wav,.png,.ttf,.mov,
.ico,.js,.woff,.xml,.htc,.NewProxyConnection,
.DelegatingConnection,.SqlSessionTemplate,
.CUBRIDConnection,
.PoolableConnection,.WrappedConnection,
/bea_wls_deployment_internal/DeploymentService,
.GIF,.SWF,.CSS,.HWP,.XLS,.XLSX,.EOT,.PPTX,
.PPT,.ASF,.PDF,.TXT,.FLV,.MP3,.MP4,.DOC,
.HTML,.WMV,.JPG,.ZIP,.WAV,.PNG,.TTF,.MOV,
.ICO,.JS,.WOFF,.XML,.HTC
OMAPM_TRANSACTION_EXCLUDE_URL_SUFFIX_EXCLUDEtrue
OMAPM_TRANSACTION_EXCLUDE_USER_AGENT
_PATTERNS
^openmaru-health-check$
OMAPM_TRANSACTION_ERRORPAGE_URL_PATTERNS/session/force500.\*,/test/test500.*
OMAPM_TRANSACTION_WITH_EXCEPTION_VIEW
_ENABLED
true
OMAPM_TRANSACTION_WITH_EXTERNAL_HTTP
_ERROR_VIEW_ENABLED
true
OMAPM_TRANSACTION_WITH_EXTERNAL_HTTP
_ERROR_CODES
OMAPM_TRAFFIC_CONTROL_ENABLEDtrue
OMAPM_TRAFFIC_CONTROL_PATTERN_1지정한 패턴의 동시에 최대로 허용할 요청 값 지정/test/slow., 100
OMAPM_TRAFFIC_CONTROL_PATTERN_2지정한 패턴의 동시에 최대로 허용할 요청 값 지정/test/test., 100
OMAPM_TRAFFIC_CONTROL.PATTERN_3지정한 패턴의 동시에 최대로 허용할 요청 값 지정/test/TestServlet., 100
OMAPM_UBT_CHECK_ENABLEDfalse
OMAPM_UBT_CHECK_TYPEip
OMAPM_UBT_CHECK_USER_COUNT100
OMAPM_UBT_CHECK_TIME_INTERVAL1
OMAPM_UBT_CHECK_ALERT_DUP_PREVENT30
OMAPM_USER_TRACKING_MODE사용자 추적 모드 지정 0 : 클라이언트 IP 1 : JSESSIONID 쿠키 2 : KHANUSER Cookie - default2
OMAPM_USER_THINKTIME_MINUTES5
OMAPM_ENABLE_FILTER_INTERCEPTORfalse
OMAPM_ENABLE_IBATIS_INTERCEPTORfalse
OMAPM_ENABLE_MYBATIS_INTERCEPTORfalse
OMAPM_ENABLE_HTTP_INTERCEPTORfalse
OMAPM_ENABLE_SPRINGBATCH_INTERCEPTORfalse
OMAPM_ENABLE_LOGGING_INTERCEPTORfalse
OMAPM_TRACE_LOGGING_LEVELSWARN,ERROR,FATAL
OMAPM_PUSH_TRANSACTION_NO_DELAYtrue
OMAPM_ACTIVEUSER_COUNTFIRSTREQUESTfalse
OMAPM_USER_CHARSET_ENCODINGAPM의 인코딩 값 지정UTF-8
OMAPM_USER_INTERCEPTOR_FILE사용자의 interceptor 환경변수를 설정한 파일명user-interceptor.conf
OMAPM_LOG_DIRAPM 로그 경로 설정/svc/test/khan-agent/log
OMAPM_LOG_FILE로그 파일 명 지정khan-agent-${INSTANCEID}.log
OMAPM_LOG_LEVEL로그 레벨 지정INFO
OMAPM_LOG_BACKUP_INDEX유지할 로그의 백업 파일 수 설정3
OMAPM_LOG_ROTATE_SIZE전환할 로그 파일의 크기 지정10240000
OMAPM_SESSION_MANAGER_ENABLED세션 매니저 활성화 여부true
OMAPM_ACTIVE_SESSION_COUNT_ENABLED세션 수 카운팅 여부true
OMAPM_AUDIT_LOG_ENABLED감사 로그 파일 활성화 여부true
OMAPM_AUDIT_LOG_USERIDKEYUSER_ID
OMAPM_AUDIT_LOG_DIR감사 로그 경로 설정
OMAPM_AUDIT_LOG_FILENAME감사 로그 파일 명 지정audit-{date: yyyy-MM-dd}.log
OMAPM_AUDIT_LOG_POLICIESdaily: 00:00
OMAPM_AUDIT_LOG_BACKUPS유지할 감사 로그의 백업 파일 수 설정3