소프트웨어 프록시

제목 : Software Proxy
작성자 : Whatap Support
이메일 : support@whatap.io
날짜 : 2019-06-29
버전 : 1.0.0

설명 : 소프트웨어 프록시에 대해 설명합니다.

에이전트에서 수집서버로 직접 접속이 어려운 경우 프록시 모듈을 사용해 경유 할 수 있습니다.
haproxy [1] 와 같은 범용 프록시를 사용하거나 와탭에서 제공하는 proxy를 사용 할 수 있습니다.

proxy
Figure 1. Proxy

1. 설치

APM 에이전트 설치안내에 따라 에이전트 설치를 진행하게 되면 whatap.agent.java.tar.gz 와 같이 에이전트 설치 파일을 다운로드 받게 됩니다. 압축을 해제하고 whatap.agent.proxy-*.jar 파일을 와탭 수집 서버와 통신 가능한 서버 위치에 두는 것으로 설치는 완료 됩니다. 이미 설치된 에이전트가 있다면 해당 위치의 파일을 사용 할 수 있습니다.

편의상 에이전트가 위치한 서버의 대역을 내부망 이라 하고 소프트웨어 프록시가 위치한 서버의 대역을 외부망 이라고 합니다.

2. 설정

2.1. 외부망

whatap.agent.proxy-*.jar 파일을 적절한 곳에 복사 했다면 proxy.conf 파일을 작성해 와탭 수집서버 IP 와 포트를 설정합니다.
whatap.agent.proxy-*.jar 가 위치한 경로가 $PROXY_HOME 입니다.

$PROXY_HOME/proxy.conf
whatap.server.host=52.78.209.94/52.78.224.235 (1)
listen_port=6600 (2)
1 52.78.209.94 와 52.78.224.235 는 와탭 어플리케이션 모니터링의 수집서버 주소 입니다.
2 6600 은 Proxy 가 Listen 하는 포트 입니다.

2.2. 내부망

$WHATAP_HOME 은 에이전트가 설치된 위치를 의미 합니다.
$WHATAP_HOME/whatap.conf 내 whatap.server.host 항목을 외부망 서버의 IP로 변경 합니다.

$WHATAP_HOME/whatap.conf
whatap.server.host=<외부망 프록시 서버 IP>

안정성을 위해 외부망에 프록시를 여러개 구성 할 수도 있습니다. 이 경우 각각 <외부망 프록시 서버 IP> 를 / 로 구분 해 등록하면 됩니다.

$WHATAP_HOME/whatap.conf
whatap.server.host=<외부망 프록시 서버 IP #1>/<외부망 프록시 서버 IP #2>

3. 실행

소프트웨어 프록시의 실행은 java 명령을 통해 whatap.agent.proxy-*.jar 를 실행하는 것 만으로 됩니다.

java -jar whatap.agent.proxy-*.jar &

proxy.sh 파일을 하나 만들어 wrapping 할 수도 있습니다.

proxy.sh
#!/usr/bin/env bash
EXE_JAR=`ls *.proxy* | sort | tail -1`
${JAVA_HOME}/bin/java ${JAVA_OPTS} -jar $EXE_JAR
sh proxy.sh &

4. 종료

소프트웨어 프록시가 동작중이라면 $PROXY_HOME/{PID}.proxy.run 파일이 생성되게 됩니다. 이 파일을 삭제하면 소프트웨어 프록시는 종료 됩니다.


1. 범용적으로 널리 쓰이는 검증된 오픈소스 Proxy 소프트웨어 - http://www.haproxy.org