1.HBase 설치 및 실행

• 수집한 Metrics가 저장되는 공간인 HBase를 설치해야 한다.

• Pinpoint 버전에 따라 호환되는 HBase와 JDK 버전이 있으므로 버전 호환성을 신경써줘야 한다.
  글 작성 시 사용한 버전은 Pinpoint 2.3.3, HBase 1.4.6, JDK8이다.

• 호환 버전은 Pinpoint Github 문서에서 확인할 수 있다.

• HBase 과거 버전 다운로드는 apache archive에서 다운 가능하다.

• HBase 데이터베이스에 Pinpoint 관련 스키마를 생성해줘야 하는데, 이를 위한 스크립트를 핀포인트에서 제공한다.
  스키마 생성 스크립트는 여기에서 다운로드 받을 수 있다.

• 아래는 설치 과정이다.

  1. 8버전 이상의 사용할 Hbase와 호환되는 JDK를 설치해준다.

  2. JAVA_HOME 환경변수를 설정해준다.

  3. HBase를 다운 받고 압축을 해제한 후 bin 디렉토리로 이동한다.

  4. 아래 명령어로 hbase를 실행시킨다.

     ./start-hbase.sh

  5. hbase shell에 접속한다.

     ./hbase shell

  6. Shell에서 아래 명령어로 hbase가 정상적으로 띄워졌는지 확인한다.

     status

     

  7. HBase가 실행됐으면 스키마 생성 스크립트를 실행시켜서 스키마를 생성해준다.

     ./hbase shell hbase-create.hbase

     

2. Pinpoint Collector 설치 및 실행

• Pinpoint Agent로부터 Metric을 받아서 HBase에 저장하는 역할을 수행하는 Collector를 실행시켜줘야한다.

• Collector JAR 파일은 Github Release 페이지에서 자신이 사용할 버전을 선택 후 다운 받으면 된다.
  

• Collector JAR파일 다운로드 후 아래 명령어로 Collector를 실행시킨다.

  java -jar -Dpinpoint.zookeeper.address=localhost pinpoint-collector-boot-{다운로드 버전}.jar

3. Pinpoint Web 설치 및 실행

• 수집한 Metric을 보기 쉬운 그래프 등으로 확인하며 분석할 수 있도록 해주는 Pinpoint Web을 실행해야한다.

• Web JAR 파일은 Collector JAR 파일 다운받은 곳에서 함께 찾을 수 있다.

• 다운로드 후 아래 명령어로 Pinpoint Web을 실행시킨다.

  java -jar -Dpinpoint.zookeeper.address=localhost pinpoint-web-boot-{다운로드 버전}.jar --server.port={포트번호}

• 실행 후 localhost:8080으로 접속해서 Pinpoint Web 화면이 정상적으로 보이는지 확인한다.
  

4. 모니터링 대상 Application을 Pinpoint Agent를 적용해서 실행

• Application을 Jar 파일로 만든 후 아래 명령어로 실행한다.

• 아래 명령어에서 주요 실행 옵션의 역할은 다음과 같다.
  - applicationName: 여러 애플리케이션을 모니터링 할 때 각각의 애플리케이션을 구분하는 이름
  - agentId: 동일 종류의 애플리케이션 여러 개 띄워져있을 때 1번 서버, 2번 서버 등을 구분하는 ID

  java -jar -javaagent:pinpoint-agent-2.3.3/pinpoint-bootstrap.jar -Dpinpoint.applicationName=TESTAPP -Dpinpoint.agentId=test-agent {Application Jar파일명}

• 정상적으로 기동했을 경우 Pinpoint Web을 확인해보면 애플리케이션 목록에서 TESTAPP이 추가된 것을 확인할 수 있다.
  
  

5. Windows에 설치 시 발생한 이슈

1. HBase 설치 시 Hadoop 실행 시 필요한 winutils 경로를 찾지 못해서 에러 발생
   • 여기 문서 참고해서 해결
2. Pinpoint Jar 파일 실행 시 -D 옵션이 안먹는 문제 발생
   • 아래와 같이 Key와 Value를 홑따옴표로 묶어줘서 해결
   • -D'pinpoint.zookeeper.address=localhost'