On-premise설치및_구동
▣ 온프레미스 환경에서 서비스되는 Java Applicaiton인 경우 다음의 설치 과정을 수행합니다.
▶ [exem-java-agent] 설치
❶ exem-java-agent 패키지 다운로드
- java agent를 설치하기 위한 패키지를 제공하며, 이름은 아래와 같은 규칙으로 생성됩니다.
EXEM-JAVA-AGENT-x.x.x.x.tar.gz
- 설치할 EXEM-JAVA-AGENT-x.x.x.x.tar.gz 패키지를 서버에 다운로드 또는 직접 업로드 합니다.
wget http://{download URL}/EXEM-JAVA-AGENT-3.0.24.15.tar.gz
▶ 압축 해제
❷ 패키지 압축 해제
tar -zxvf EXEM-JAVA-AGENT-x.x.x.x.tar.gz
▶ 에이전트 적용
❸ JVM 기동 옵션에 에이전트 설정 추가
-javaagent:{패키지_경로}/exem/java/lib/exem-java-agent.jar
❹ 기본 옵션 설정
- 에이전트 사용에 필요한 기본 설정입니다.
- 기동옵션, 환경변수, 설정파일(config)로도 설정이 가능합니다.
- 모든 설정의 우선순위는 기동옵션 > 환경변수 > 설정파일 입니다.
| 설정 이름 | 설명 | 비고 |
|---|---|---|
| EXEM_GROUP_ID | WAS Group ID | 설정하지 않으면 "default"로 설정됨 |
| EXEM_RECEIVER_ADDR | 수집서버(receiver) 주소. ip:port 형식으로 입력합니다. | v3.0.24.16 부터 환경변수 입력 지원 |
| EXEM_JAVA_AGENT_NAME | 화면에 표시될 WAS name | v3.0.24.16 부터 환경변수/config 파일 입력 지원 |
- EXEM_GROUP_ID
- 우선순위 : jvm 옵션(-Dexem.groupid=) > 환경변수(EXEM_GROUP_ID) > config 파일(EXEM_GROUP_ID)
- EXEM_JAVA_AGENT_NAME
- 우선순위 : jvm 옵션(-Dexem.agent.name=) > 환경변수(EXEM_JAVA_AGENT_NAME) > config 파일(EXEM_AGENT_NAME)
- EXEM_RECEIVER_ADDR
- 우선순위 : jvm 옵션(-Dexem.receiver.addr=) > 환경변수(EXEM_RECEIVER_ADDR) > config 파일(RECEIVER_ADDR)