[Linux] PinPoint 설치 및 구성(Install with Docker)

PinPoint 공식 홈페이지 : https://pinpoint-apm.gitbook.io/pinpoint 

 

 

서버 Spec

• AWS EC2
• vCPU : 2 Core
• Memory : 16GB
• OS : Amazon-linux 2

 

 

 

# PinPoint 서버 작업

 

1. Docker 설치

# amazon-linux-extras install docker

 

2. Docker compose 설치

# curl -L https://github.com/docker/compose/releases/download/1.22.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose

# chmod +x /usr/local/bin/docker-compose

# docker-compose version

 

3. PinPoint 서버 설정 파일 수정 후 배포

# yum -y install git

# git clone https://github.com/pinpoint-apm/pinpoint-docker.git

# cd pinpoint-docker

# vi .env // 필요시 수정

# docker-compose pull && docker-compose up -d

# 이후 web port <서버 IP>:8080으로 접속

「

필자의 경우 서버 사양이 낮아서인지 순서대로 실행은되나 애플리케이션 실행이 오래걸려

 

의존성이 걸려있는 애플리케이션이 에러가 나는 경우가 종종 있었습니다.

 

만약 정상적으로 웹 접속이 안되거나 어떤 APM 기능에 문제가 있다면 컨테이너의 로그를 확인하여야 합니다.

」

 

 

# PinPoint Agent 작업

 

1. 자바 애플리케이션이 실행되는 서버에 pinpoint Agent 다운로드 후 압축해제

( https://github.com/pinpoint-apm/pinpoint/releases )

# wget https://github.com/pinpoint-apm/pinpoint/releases/download/v2.4.1/pinpoint-agent-2.4.1.tar.gz
# tar -xzf pinpoint-agent-2.4.1.tar.gz

 

2. PinPoint 서버 정보 수정

# vi pinpoint-agent-2.4.1/pinpoint-root.config
.
.
profiler.transport.grpc.collector.ip=127.0.0.1 // PinPoint 서버 IP로 변경
profiler.collector.ip=127.0.0.1 // PinPoint 서버 IP로 변경


# vi pinpoint-agent-2.4.1/profiles/release/pinpoint.config
.
.
profiler.transport.grpc.collector.ip=127.0.0.1 // PinPoint 서버 IP로 변경
profiler.collector.ip=127.0.0.1 // PinPoint 서버 IP로 변경



# vi pinpoint-agent-2.4.1/profiles/local/pinpoint.config
.
.
profiler.transport.grpc.collector.ip=127.0.0.1 // PinPoint 서버 IP로 변경
profiler.collector.ip=127.0.0.1 // PinPoint 서버 IP로 변경

 

3. 자바 애플리케이션 실행

$ java -jar -javaagent:<pinpoint-bootstrap.jar 파일 경로> -Dpinpoint.agentId=<Agent ID> -Dpinpoint.applicationName=<application Name> <jar 파일 경로>
ex) $ java -jar -javaagent:pinpoint-agent-2.4.1/pinpoint-bootstrap.jar -Dpinpoint.agentId=app-in-docker -Dpinpoint.applicationName=quickapp JAVA_Application.jar

 

 

 

 

# PinPoint 구성 완료

 

PinPoint Web에 접속하면 위의 화면 확인 가능