1. Collector 구성하기
git clone https://github.com/pinpoint-apm/pinpoint-docker.git
cd pinpoint-docker
git checkout 2.5.3
docker-compose pull && docker-compose up -d
Collector로 사용할 EC2 생성 후, 위의 명령어로 collector, web, hbase 등을 구성합니다.
web의 포트번호 default는 8080 입니다.
docker-compose에서 pinpoint-agent, pinpoint-agent-attach-example, pinpoint-quickstart 등의 의존은 제거해도 됩니다.
2. Agent 구성하기
# infra-workshop/pinpoint-agent-2.5.3/pinpoint-root.config
profiler.transport.grpc.collector.ip=[Collector IP]
...
# 부하테스트 등 환경을 고려해서 샘플링을 고려
# eg. 1: 100% 20: 5% 50: 2% 100: 1%
profiler.sampling.counting.sampling-rate=1
# front 모듈 구동시 아래 옵션을 추가
-javaagent:pinpoint-agent-2.5.3/pinpoint-bootstrap-2.5.3.jar
-Dpinpoint.agentId=front-api
-Dpinpoint.applicationName=front-api
APM agent·collector·저장·web완료 장면 설명. web(8080)이 저장된 데이터로 Servermap·Callstack·Inspector를 보여 줍니다.
과정 보기
1. USER 요청은 front-api를 거쳐 member-api로 갑니다.
2. agent는 요청과 별도로 span을 gRPC로 collector에 보내고, collector가 HBase에 씁니다.
3. web(8080)이 저장된 데이터로 Servermap·Callstack·Inspector를 보여 줍니다.
3. Pinpoint 웹 콘솔 살펴보기
A. Servermap
서버간 관계 및 트래픽 평균 응답시간, 응답 분포 등을 확인할 수 있습니다. 우측 상단의 응답시간 분포 영역을 마우스 드래그를 통해 특정 콜에 대한 추적이 가능합니다.
B. Callstack Trace
mixed view
요청에 대한 소스레벨의 Trace View를 제공합니다. SQL 쿼리, 에러 로그 및 병목지점 등을 확인할 수 있고, 이를 Call Tree, Server Map 및 Mixed View 등으로 확인해 볼 수 있습니다.
호출 트리와 구간 시간완료 장면 설명. getInputStream self 507 ms에는 원격 응답 대기가 들어 있습니다. member-api 안에서 가장 큰 self는 253 ms입니다.
과정 보기
1. 호출 순서대로 구간이 펼쳐지고, member-api span(448 ms)이 getInputStream(510 ms) 안에서 열립니다.
2. 토큰 만료 → member-api 403 → front IOException → /api/conferences 500.
3. getInputStream self 507 ms에는 원격 응답 대기가 들어 있습니다. member-api 안에서 가장 큰 self는 253 ms입니다.
C. Inspector
CPU, memory, tps, datasource connection count 등 agent 들의 리소스 지표를 확인할 수 있습니다.