APM 서비스 포트 변경 방법 가이드

이 글을 통해 APM 서비스 포트를 언제, 어떻게 변경하면 좋을지 알아보세요.

APM 서비스 포트 변경 방법 가이드

전반적인 포트 변경 작업은 서비스 중단 영향을 최소화하는 것을 목표로 합니다. 변경 사유와 범위를 명확히 한 뒤, 서버 측 프록시(HAProxy 등)와 WAS Agent, SysAgent 설정을 일관성 있게 갱신하고, 재기동 및 검증 절차를 통해 정상 동작을 확인합니다. 아래 절차는 사내 표준 구성(HAProxy 프론트엔드 + KHAN APM Agent 기준)을 가정합니다.

1. APM 서비스 포트를 변경이 필요한 경우는 언제인가요?

보안 및 규정 준수: 표준 포트 노출 최소화, 사내 보안 정책 반영할때

충돌 회피: 동일 서버 내 다른 프로세스와의 포트 충돌이 있을 경우

네트워크 설계 변경: L4 정책, VIP 이관, 신규 구간 분리 등 인프라 리디자인 반영할때

2. 변경 전 사전 준비 사항

변경 포트 확정: 사용 가능 여부를 netstat 혹은 ss로 확인합니다.
- 예) ss -tnlp | grep <포트번호>

방화벽 정책 점검: 서버 보안 그룹, OS 방화벽, 네트워크 ACL에 신규 포트 허용

영향 범위 파악: APM 서버, WAS Agent, SysAgent, 모니터링 및 알림 연동 대상

변경 시나리오 및 롤백 계획 수립: 재기동 순서, 실패 시 원복 명령 정리

작업 시간 확보: 저부하 시간대, 관련자 공지와 모니터링 인력 대기

3. 실제 변경 절차

아래 예시는 기존 80 포트를 8123으로 변경하는 흐름을 설명합니다. 실제 환경에 맞게 포트, 경로, 서비스명을 조정하세요.

3-1. APM Server(HAProxy) 포트 변경

1. 설정 파일 수정

[root@APM01 ~]# vim /etc/haproxy/haproxy.cfg
...
# main frontend which proxys to the backends
frontend  main
    bind *:8123   # 변경할 포트로 수정
    mode http
    option forwardfor
    option http-pretend-keepalive
    option http-keep-alive
    default_backend khan
   
...

2. 재기동 및 리스닝 포트 확인

[root@APM01 ~]# systemctl restart haproxy.service
[root@APM01 ~]# ss -tnlp | grep 8080

3-2. WAS Agent 포트 변경

1. 설정 파일 수정

[jboss@APM_WAS1 ~]$ vim /openmaru/was/domains/khan-agent/khan-agent-jboss11.conf

...
application.name=WAS
khan.host=192.168.130.1
khan.port=8123   # 변경한 APM Server 포트와 일치시킴
...

2. WAS 재기동(환경 기준) 후 로그 확인

Agent 로그에서 APM 서버 연결 성공 여부 확인

3-3. SysAgent 포트 변경

1. 설정 파일 수정

[root@APM_WAS1 ~]# vim /svc/test/khan-agent/khan-sys-agent/conf/khan-sys-agent.conf

...
khan.host=192.168.130.1
khan.port=8123   # 변경한 포트 적용
...

2. SysAgent 재기동 및 상태 확인

[root@APM_WAS1 ~]# systemctl restart khan-sys-agent.service
[root@APM_WAS1 ~]# systemctl status  khan-sys-agent.service

4. 검증 체크리스트

포트 리스닝: APM 서버에서 변경 포트 리스닝 중인지 확인
에이전트 연결: WAS Agent, SysAgent가 새 포트로 정상 수집·전송되는지
모니터링 UI: 트랜잭션, 메트릭이 끊김 없이 갱신되는지
로그 이상 징후: HAProxy, Agent 로그의 에러 유무
방화벽/네트워크: 패킷 드롭, 세션 리셋 등 네트워크 이슈 여부

5. 롤백 가이드

설정 원복: 변경 전 백업본으로 cfg, conf 되돌리기
서비스 재기동: HAProxy, Agent 재기동 후 기존 포트 리스닝 확인

6. 자주 묻는 질문(FAQ)

Q. APM Server와 Agent 포트가 다르면 어떻게 되나요?

A. 반드시 동일하게 맞춰야 연결에 성공합니다. APM Server가 리스닝 중인 포트와 Agent 설정의 khan.port가 일치해야 합니다.

Q. 포트만 바꾸면 되나요, 호스트도 확인이 필요한가요?

A. 네. 네트워크 구간 변경 시 IP 또는 호스트명이 바뀔 수 있으므로 khan.host도 함께 검증하세요.

Q. 재기동 순서는 어떻게 권장하나요?

A. 서버(프록시) → Agent 순으로 변경 후 재기동합니다. 서버가 먼저 새 포트를 리스닝해야 Agent가 즉시 재연결됩니다.

맺음말(마무리)

APM 서비스 포트 변경은 서버 프록시, WAS Agent, SysAgent 설정을 일관되게 맞추고 재기동 순서를 지키는 것이 핵심입니다. 변경 전 가용 포트와 방화벽 정책을 검증하고, 변경 후에는 리스닝 상태와 에이전트 연결, 모니터링 지표를 반드시 확인하십시오. 실패 시에는 사전 백업본으로 즉시 롤백할 수 있도록 준비해 두시면 안전합니다.

APM 서비스 포트 변경 방법 가이드