본문으로 건너뛰기

APM 설치

OPENMARU Installer통해서 OPENMARU APM과 System에이전를 설치하는 과정을 설명한다.

요구 사양

OPENMARU APM 수집 서버의 사양은 다음과 같습니다.

CPUMemoryDiskAgent
권장사양8 core16 GB500 GB50 EA
추천사양16 core16 GB1 TB100 EA

방화벽

OPENMARU Installer통해서 OPENMARU APM를 설치하기 위한 방화벽 조건

출발지목적지포트비고
WEB/WASOPENMARU APM Server80모니터링정보 수집
사용자(PC)OPENMARU APM Server80APM 웹모니터링콘솔
OPENMARU APM ServerWEB/WAS22APM 에이전트 관리(SSH 포트)
작업자(PC)OPENMARU APM Server80APM 웹모니터링콘솔
작업자(PC)OPENMARU APM Server8111APM 설치
작업자(PC)OPENMARU APM Server22APM 설치(SSH 포트)
작업자(PC)WEB/WAS22APM 에이전트 설치(SSH 포트)

설치 구성도

대체로 OPENMARU APMOPENMARU Installer가 설치된 서버에 설치한다.

APM 설치 구성

설정파일 목록

  • Installer Web Console 접속
  • 설정 파일 관리 -> 설정 파일 목록 -> hosts-khan-monitoring-sample 선택

파일 템플릿 복제

APM Server Instances

복제한 템플릿 파일에서 서버 인스턴스를 구성한다.

  • IP 주소 : 설치 대상 APM 서버 IP
  • SSH 포트 : 설치 대상 SSH PORT
  • BIND 주소 : Network LISTEN IP(기본값: 127.0.0.1)
  • PEM 파일명 : AWS등과 같이 username/password로그인 방식이 아닌 키페어 로그인 방식인 경우 사용한다.
    • pem파일은 files디렉토리에 위치 시키고 pem파일명 영역에는 /opt/khan/provisioning/cli/files/[pem file name]을 입력한다.
  • 인스턴스 : 이중화를 위해 khan11, khan12 두개의 인스턴스 설치
    • 인스턴스 이름 : APM 인스턴스 이름
    • 포트 오프셋 : APM 인스턴스에 할당할 포트 오프셋(8080 포트에 더함, ex) 100 = 8180)


APM 서버 인스턴스 설정

설치할 디렉토리, Linux 그룹과 사용자 정보를 설정한다.

  • APM 서버 홈 디렉토리 : Linux 사용자 계정의 HOME 디렉토리
  • APM 서버 업로드 디렉토리 : 설치에 필요한 임시 파일들이 업로드 된다.
  • 데이터 디렉토리 : 수집서버가 사용하는 Database의 데이터가 저장된다.
  • 모니터링 서버 포트 : 브라우저로 서비스할 포트를 설정한다.(이중화된 서버 인스턴스를 로드발란싱)
  • Linux 사용자 그룹명(GID) : APM 수집서버를 관리할 Linux 사용자 그룹
  • Linux 사용자명(UID) : APM 수집서버를 관리할 Linux 사용자


Java 환경 설정

Java 환경 설정에서 가상머신 메모리 확인 후 변경 필요 시 수정 (특이사항 없을 시 권장값 사용)

  • Java Version : OpenJDK 타입 및 버전을 선택한다.(yum or Potable)
  • Java Heap 최소값/최대값 : 에이전트가 100개 이상이라면 4096m 권장)


APM 설치

저장 후 APM 설치 진행

설치 로그 확인

******************************* end task ************************************** 메시지가 확인되면 완료

APM 서버 접속

APM 라이센스 적용

라이센스는 고객지원을 통해 발급받을 수 있습니다.

  • 설정 -> 라이센스 -> 라이센스 관리 -> 추가 라이센스 키 값 복사 붙여넣기 후 저장

Sytem 에이전트 설치 구성

APM sytem agent 설정

기본적으로 APM 수집서버에 System Agent를 설치하고 필요에 따라 모니터링하고자 하는 서버에 System Agent를 설치한다.

OPENMARU Installer를 통해 운영중인 서버에 System Agent 설치 주의

설치과정에서 OS Kernel Parameter, ulimit튜닝이 일어나고 Chrony 타입 서버도 설치 되므로 기존에 운영중인 서버에 설치하는 경우 주의가 필요
이미 운영중인 경우 System Agent 설치 매뉴얼을 따라 수동으로 설치한다.

  • 서버 추가 : System 에이전트를 설치할 서버를 추가한다.
  • IP 주소 : 설치 대상 APM 서버 IP
  • SSH 포트 : 설치 대상 SSH PORT
  • PEM 파일명 : AWS등과 같이 username/password로그인 방식이 아닌 키페어 로그인 방식인 경우 사용한다.
    • pem파일은 files디렉토리에 위치 시키고 pem파일명 영역에는 /opt/khan/provisioning/cli/files/[pem file name]을 입력한다.


APM sytem agent 인스턴스 설정

설치할 디렉토리, Linux 그룹과 사용자 정보를 설정한다.

  • System Agent 홈 디렉토리 : Linux 사용자 계정의 HOME 디렉토리
  • System Agent 업로드 디렉토리 : 설치에 필요한 임시 파일들이 업로드 된다.
  • 데이터 디렉토리 : 수집서버가 사용하는 Database의 데이터가 저장된다.
  • APM 서버 IP/PORT : 수집된 데이터를 전송할 APM 수집서버 IP/PORT
  • Linux 사용자 그룹명(GID) : System Agent를 관리할 Linux 사용자 그룹
  • Linux 사용자명(UID) : System Agent를 관리할 Linux 사용자


Sytem 에이전트 설치

System Agent 설치 진행

실행 관리 -> 실행 큐 에서 설치 확인

APM에 접속하여 확인

APM 접속 -> 시스템 -> 대시보드 확인