개요 및 설치
본 장에서는 AnyLink 모니터링의 기본적인 개념과 설치 방법에 대하여 설명합니다.
1. 개요
AnyLink APM(Application Performance Monitoring)은 AnyLink 7.5 시스템의 전체적인 성능 모니터링이 가능한 애플리케이션입니다. 각 업무시스템(MS)에 존재하는 Agent를 통해 AnyLink APM 서버로 데이터가 전송되며, 이를 통해 실시간 모니터링이 가능합니다.
트랜잭션 처리 현황, 어댑터 및 엔드포인트 상태, 서버 리소스 사용량 등을 실시간으로 확인할 수 있으며, 과거 데이터를 기반으로 한 분석 기능도 제공합니다.
2. 화면 구성
모니터링 화면은 다음과 같은 탭으로 구성됩니다.
| 탭 | 설명 |
|---|---|
통합 |
시스템 전체 현황을 한눈에 파악할 수 있는 대시보드 |
어댑터 |
어댑터 및 엔드포인트 상태 모니터링 |
거래별 |
거래 그룹 및 거래 단위의 트랜잭션 모니터링 |
분석 |
과거 데이터를 기반으로 한 통계 분석 |
에러 |
에러 발생 현황 조회 |
4. AnyLink 7.5 설정
AnyLink APM을 사용하기 위해서는 AnyLink 7.5에 대한 설정이 필요합니다.
4.1. 추가 패키지 설치
AnyLink APM은 Network I/O 정보 모니터링을 위해 OS로부터 관련 정보를 수집합니다. APM을 적용할 MS에 다음 패키지 설치가 필요합니다.
$ sudo apt-get install net-tools4.2. JVM 옵션 설정
APM을 적용할 MS에 JVM 옵션을 설정합니다.
JEUS WebAdmin에서 [Server] > [Jvm Config] > [Jvm Option]에 다음 옵션을 추가합니다.
-Dcom.tmax.anylink.monitoring.app.host.ip=[APM 서버 IP]
-Dcom.tmax.anylink.monitoring.app.port=[APM 서버 PORT]| 옵션 | 설명 |
|---|---|
monitoring.app.host.ip |
AnyLink APM 서버의 IP 주소 |
monitoring.app.port |
AnyLink APM 서버와 연결 시 사용할 포트 (예: 11011) |
5. 모니터링 애플리케이션 실행
다음 명령어를 이용하여 AnyLinkAPM.jar 파일을 실행합니다.
java -jar -Dio.netty.tryReflectionSetAccessible=true \
-Dspring.profiles.active=[DB profile] \
-Dserver.ip=0.0.0.0 \
-Dserver.port=[APM Port] \
-Dnetty.host.ip=[APM Server IP] \
-Dnetty.port=[MS 연결 PORT] \
-Ddb.url=[DB URL] \
-Ddb.username=[DB username] \
-Ddb.password=[DB password] \
AnyLinkAPM.jar \
--add-opens java.base/jdk.internal.misc=ALL-UNNAMED -Xmx1024m --illegal-access=deny| 옵션 | 설명 |
|---|---|
spring.profiles.active |
사용하는 DB Vendor에 따른 프로파일 설정
|
server.port |
APM 웹 서버 포트 (예: 8081) |
netty.host.ip |
APM 서버 IP |
netty.port |
MS와 연결 시 사용할 포트 (예: 11011) |
db.url |
AnyLink 7.5 DB 연결 URL |
db.username |
AnyLink 7.5 DB 사용자명 |
db.password |
AnyLink 7.5 DB 비밀번호 |
6. AnyLink APM 접속
AnyLink 7.5 WebAdmin에서 [관리자] > [DIS 설정] > [AnyLink APM URL 설정]에 APM URL을 설정한 후 재로그인합니다.
http://[APM Server IP]:[APM Port]설정 완료 후 AnyLink 7.5 WebAdmin 헤더의 [APM] 버튼을 클릭하여 AnyLink APM 화면으로 이동할 수 있습니다.
7. 연결 상태 확인 및 문제 해결
AnyLink 7.5와 AnyLink APM 간의 연결 상태를 확인하는 방법 및 트랜잭션 데이터 수신 오류 발생 시 조치 방법을 설명합니다.
7.1. 연결 상태 확인
AnyLink 7.5와 AnyLink APM의 연결 상태는 MS RTE 로그를 통해 확인할 수 있습니다.
-
정상 연결
연결이 정상적으로 이루어지면 다음과 같은 로그가 출력됩니다.
// AnyLink7.5 MS RTE 로그 anylink.agent.MonitoringAgent|||||||Attempting to connect to [IP:PORT]|#] anylink.agent.MonitoringAgent|||||||MonitoringAgent started successfully.|#] anylink.agent.MonitoringAgentHandler|||||||Connection successful to [IP:PORT]|#] -
연결 중지
AnyLink APM 사용 설정을 '미사용’으로 변경하여 연결이 정상적으로 중지되면 다음과 같은 로그가 출력됩니다.
// AnyLink7.5 MS RTE 로그 anylink.monitor.SystemResourceMonitor|||||||Now stopping.|#] anylink.agent.MonitoringAgent|||||||Agent stopped.|#]