pinpoint-docker

Pinpoint는 대규모 분산 시스템의 성능을 분석하고 문제를 진단, 처리하는 플랫폼입니다. 네이버의 pinpoint를 clone하면 기본적으로 quickstart를 통해 단일 머신에서 간단히 pinpoint를 구동시키고 사용할 수 있습니다.

하지만 분산형으로는 구성하는 절차가 복잡하기 때문에 구성에 어려움이 있습니다. 이를 편하게 하기 위해 docker로 구성을 해보았습니다.

분산형으로 pinpoint를 구성하기 위해서는 여기서 사용되는 각 컨테이너들이 모두 구동이 되어야하므로 docker-compose를 사용하여 구동시킬 것을 권장합니다.

pinpoint는 hbase를 사용하고 있는데 이 hbase를 분산형으로 구성하기 위해서 hadoop과 zookeeper가 필요합니다. zookeeper는 기본 쿼럼을 위해 3대가 필요하기 때문에 docker-compose에 zoo1~3으로 세개의 컨테이너가 사용됩니다.

구동을 위해 필요한 이미지들은 제 개인 repository에 push를 해두었습니다. 기본적으로 docker-compose.yml에서는 아래의 repository 이미지를 사용합니다.

• yonghochoi/hadoop (버전 : 2.7.3)
• yonghochoi/hbase (버전 : 1.2.6)
• yonghochoi/pinpoint-collector (버전 : 1.6.2)
• yonghochoi/pinpoint-web (버전 : 1.6.2)

pinpoint의 최신 버전은 Release 페이지를 참고하시길 바랍니다.

여기서는 agent에 대한 구성은 생략하므로 Pinpoint Agent 설치를 참고하여 설정하시길 바랍니다.

컨테이너 구동

컨테이너 구동을 위해서 docker-compose를 사용합니다. 설치가 되어 있지 않다면 Install Docker Compose를 통해 설치 후에 진행을 하셔야 합니다.

기본 설정 그대로 구동 시에는 아래 명령을 사용하여 구동합니다.

$ docker-compose up -d

해당 repository를 수정하여 구동하길 원하는 경우 Dockerfile을 수정한 후에 docker-compose.yml 파일을 수정하여 image로 되어 있는 부분을 아래와 같이 build로 변경 후 경로를 지정합니다.

version: '2'
services:
  hadoop:
    container_name: hadoop
    hostname: hadoop
    # image: yonghochoi/hadoop
    build: hadoop
    restart: always
    expose:
      - "9000"
    ports:
      - "9000:9000"

변경된 Dockerfile을 적용하기 위해 아래 명령을 수행합니다.

$ docker-compose build

적용된 Dockerfile을 통해 컨테이너를 구동시키기 위해 아래 명령을 수행합니다.

$ docker-compose up -d

오류가 발생하는 경우

docker-compose를 사용하여 컨테이너가 구동되는 과정에서 hbase가 완전히 준비되지 않은 상태로 pinpoint-collector 또는 pinpoint-web이 구동되면 제대로 동작되지 않는 경우가 있습니다.

이러한 경우에는 초기화를 진행 한 후 순차적으로 실행을 시켜주면 정상동작합니다. 아래와 같은 순서로 진행해보시길 바랍니다.

1. Pinpoint-collector/web 종료

   $ docker stop pinpoint-collector
   $ docker stop pinpoint-web

2. hbase 종료

   $ docker stop hbase

3. hadoop에서 hbase data 저장 디렉토리 제거

   $ docker exec -it hadoop hadoop fs -rmr /hbase

4. zookeeper에서 hbase znode 제거

   $ docker exec -it zoo1 zkCli.sh -server localhost:2181
   [zk: localhost:2181(CONNECTED) 0] rmr /hbase

   • zookeeper 서버 한군데서만 제거하면 앙상블로 구성된 모든 서버에 동기화됨.

5. hbase 구동 및 로그 확인

   $ docker start hbase
   $ docker logs -f hbase

   • 테이블 생성 절차가 완료되고 정상 동작까지 로그를 확인 후 아래과정 수행

6. pinpoint-collector 구동 및 로그 확인

   $ docker start pinpoint-collector
   $ docker logs -f pinpoint-collector

   • Exception이 발생하지 않고 정상동작하는 지 확인

7. pinpoint-web 구동 및 로그 확인

   $ docker start pinpoint-web
   $ docker logs -f pinpoint-web

   • Exception이 발생하지 않고 정상동작하는 지 확인

참고

• Pinpoint
• 대규모 분산 시스템 추적 플랫폼, Pinpoint