APM - 핀포인트(2.4.0) 설치

APM은 Application Performence Management의 약자입니다. 말 그대로 어플리케이션 성능 관리 도구입니다.

사내에 JVM APM으로 핀포인트를 도입하게 되었고, 도입하면서 고려하였던 부분과 설치과정 및 유의사항에 대하여 글을 작성하였습니다.

 

설치

서버구성

Instance	Type	OS
EC2	t3a.medium	amazon linux

•  HBase(1.2.7) 설치

#설치 파일 다운로드
sudo yum install -y java-1.8.0-openjdk-devel.x86_64
wget http://archive.apache.org/dist/hbase/1.2.7/hbase-1.2.7-bin.tar.gz -P /home/ec2-user/pinpoint
cd /home/ec2-user/pinpoint 
tar xvfz hbase-1.2.7-bin.tar.gz
ln -s /home/ec2-user/pinpoint/hbase-1.2.7 /home/ec2-user/pinpoint/hbase 

# hbase-env.sh 설정
vim hbase/conf/hbase-env.sh
export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.312.b07-1.amzn2.0.2.x86_64/

# java 8에서 사용되지 않는 Perm 옵션 제거 vim hbase/conf/hbase-env.sh
# Configure PermSize. Only needed in JDK7. You can safely remove it for JDK8+
# 주석처리 후 재작성
#export HBASE_MASTER_OPTS="$HBASE_MASTER_OPTS -XX:PermSize=128m -XX:MaxPermSize=128m -XX:ReservedCodeCacheSize=256m"
#export HBASE_REGIONSERVER_OPTS="$HBASE_REGIONSERVER_OPTS -XX:PermSize=128m -XX:MaxPermSize=128m -XX:ReservedCodeCacheSize=256m"
export HBASE_MASTER_OPTS="$HBASE_MASTER_OPTS -XX:ReservedCodeCacheSize=256m"
export HBASE_REGIONSERVER_OPTS="$HBASE_REGIONSERVER_OPTS -XX:ReservedCodeCacheSize=256m"

#  hbase-site.xml 설정 : 데이터 저장 위치 
vim hbase/conf/hbase-site.xml
<configuration>
  <property>
    <name>hbase.rootdir</name>
    <value>file:///home/ec2-user/pinpoint/hbase-data/data</value>
  </property>
  <property>
    <name>hbase.zookeeper.property.dataDir</name>
    <value>/home/ec2-user/pinpoint/hbase-data/zookeeper</value>
  </property>
  <property>
    <name>hbase.unsafe.stream.capability.enforce</name>
    <value>false</value>
    <description>
      Controls whether HBase will check for stream capabilities (hflush/hsync).

      Disable this if you intend to run on LocalFileSystem, denoted by a rootdir
      with the 'file://' scheme, but be mindful of the NOTE below.

      WARNING: Setting this to false blinds you to potential data loss and
      inconsistent system state in the event of process and/or node failures. If
      HBase is complaining of an inability to use hsync or hflush it's most
      likely not a false positive.
    </description>
  </property>
</configuration>

# 디렉토리 생성(hbase.rootdir 은 자동생성되므로 zookeeper 폴더만 생성)
mkdir /home/ec2-user/pinpoint/hbase-data/zookeeper

# hbase 시작 & 중지
hbase/bin/start-hbase.sh
hbase/bin/stop-hbase.sh

# hbase 시작, 스키마 생성 https://github.com/pinpoint-apm/pinpoint/tree/2.4.x/hbase/scripts에서 hbase-create.hbase 파일 사용
# hbase-create.hbase TTL 값이 31536000초(365일)/5184000초(60일) 유지하도록 되어있어 604800(7일)로 변경 (용량문제)
# 개발 31536000초(365일)/5184000초(60일) 86400(1일)로 변경 (용량문제)
sed 's/31536000/604800/' hbase-create.hbase > hbase-create-me.hbase
sed -i 's/5184000/604800/' hbase-create-me.hbase
/home/ec2-user/pinpoint/hbase/bin/hbase shell /home/ec2-user/pinpoint/hbase/scripts/hbase-create-me.hbase

• 핀포인트(web)

//port 8080
wget https://github.com/pinpoint-apm/pinpoint/releases/download/v2.4.0/pinpoint-web-boot-2.4.0.jar
java -jar -Dpinpoint.zookeeper.address=localhost pinpoint-web-boot-2.4.0.jar &

• 핀포인트(Collector)

//port 8081
wget https://github.com/pinpoint-apm/pinpoint/releases/download/v2.4.0/pinpoint-collector-boot-2.4.0.jar
java -jar -Dpinpoint.zookeeper.address=localhost pinpoint-collector-boot-2.4.0.jar &

• 핀포인트(Batch)

//port 8090
wget https://github.com/pinpoint-apm/pinpoint/releases/download/v2.4.0/pinpoint-batch-2.4.0.jar
java -jar -Dpinpoint.zookeeper.address=localhost pinpoint-batch-2.4.0.jar &