WhaTap Docs | APM User Guide Whatap Support support@whatap.io 2019-03-11 1.0.0

본 문서는 WhaTap APM 사용법에 대해 설명합니다.

APM 사용자 가이드

1. 시작하기

와탭은 모니터링 서비스입니다. SaaS형 모니터링 솔루션이라고도 합니다. Public 클라우드에서 와탭 모니터링이 서비스되고 있습니다.
사용자는 www.whatap.io에 가입하고 프로젝트를 만든후 에이전트를 모니터링 대상 시스템에 설치하면 모니터링 서비스를 사용할 수 있습니다.

1.1. 지원 환경

와탭 모니터링 UI는 웹브라우저상에서 동작하며 지원하는 브라우저 범위는 다음과 같습니다.

브라우저 권장여부 지원버전

Google Chrome

O

최소 58 이상

Mozilla FireFox

O

최소 52 이상

Internet Explorer

X

최소 11 이상

Edge

X

Untested

Safari

X

Untested

브라우저 성능과 반응속도를 이유로 Chrome 및 Firefox 최신버전 사용을 권장 합니다.

모바일 앱은 앱스토어에서 다운로드 받을 수 있습니다.

1.2. 회원 가입

  • http://www.whatap.io 에 접속 후 무료로시작하기 버튼을 클릭합니다.

  • 회사명, 이름, 이메일계정, 비밀번호, SMS 인증 정보를 입력하여 회원가입을 진행합니다.

  • 회원가입 완료 후 등록한 이메일로 가입 승인 안내 메일이 전송됩니다.

  • 이메일을 확인하여 가입승인을 완료하면 와탭 계정이 생성 됩니다.

create account

와탭은 태넌트 개념으로 사용자 권한을 관리합니다.

1.2.1. 와탭 테넌트 이해

와탭 서비스에 사용자는 기본적으로 동등하고 구별이 없습니다. 다만 어떤 사용자가 프로젝트를 만드는 순간 해당 프로젝트에 대해서 소유권(최고 권한)을 갖게 됩니다.

소유권을 가진 사용자는 해당 프로젝트를 관리하기 위한 Admin을 지정할 수 있으며 모니터링만 할 수 있는 사용자를 추가할 수도 있습니다.

이런 방식을 테넌트 권한 관리 방식이라 부릅니다. 다수의 프로젝트와 다수의 사용자가 복잡하게 얽혀서 시스템을 사용해야하는 경우 한사람이 모든 권한을 원할하게 관리할 수없습니다.

수십개 혹은 수백개의 업무시스템을 통합 관리해야한다면 한두사람이 권한을 관리하기 보다는 각 업무팀에서 프로젝트를 만들고 통제하는 방식이 효과적입니다.

tenant

그래서 와탭은 소유자를 통해서 프로젝트를 관리하는 방식을 멀티네넌트 방식의 권한 관리를 제공합니다.

1.2.2. 사용자 종류와 권한

와탭 모니터링 서비스의 사용자 권한 그룹은 Super Admin(SA) / Admin / User 로 구분되며 각 그룹별 사용자 및 고유 역할은 다음과 같습니다.

권한그룹 프로젝트 당 계정 수 모니터링 사용자 초대 사용자 권한 변경 사용자 삭제 프로젝트 삭제

Super Admin

1

O

O

O

O

O

Admin

제한 없음

O

O

O

O

X

User

제한 없음

O

X

X

X

X

Super Admin

프로젝트 당 1개 계정, 사용자 초대, 사용자 권한 변경, 사용자 삭제, 프로젝트 삭제

와탭에 가입 후 프로젝트를 생성한 계정에 부여되는 권한으로 프로젝트 삭제를 포함하여 프로젝트에 대한 모든 권한을 가지게 됩니다.
사용자 초대를 통해 프로젝트에 계정을 추가하거나 변경/삭제 버튼을 통한 계정의 권한 변경/삭제가 가능합니다.
 - 사용자 초대 시에는 Admin 또는 User 그룹으로 초대 할 수 있습니다.
 - 권한 변경 시 Super Admin 권한으로의 변경은 제한되어 있습니다.
 - 사용자 삭제 시에는 로그인 계정 외의 계정만 삭제 할 수 있습니다.
Admin

계정 수 제한 없음, 사용자 초대 권한

사용자 초대를 통해 프로젝트에 계정을 추가하거나 변경/삭제 버튼을 통한 계정의 권한 변경/삭제가 가능합니다.
 - 사용자 초대 시에는 Admin 또는 User 그룹으로 초대 할 수 있습니다.
 - 권한 변경 시 Super Admin 권한으로의 변경은 제한되어 있습니다.
 - 사용자 삭제 시에는 Super Admin 계정 및 로그인 계정을 제외한 계정만 삭제 할 수 있습니다.
User

계정 수 제한 없음

모니터링 전용의 계정으로, 프로젝트 관리 및 사용자 관리 권한이 부여 되지 않습니다.

1.3. 프로젝트 생성

에이전트를 등록하기 위해 우선 프로젝트를 생성합니다.

프로젝트 생성 버튼을 선택하면 아래와 같이 프로젝트 생성 창이 나타납니다.

20

Java 아이콘을 선택한 뒤, 프로젝트명과 데이터 서버 지역(Region), 그룹을 선택한 뒤 프로젝트를 생성합니다

30

이후, 생성된 프로젝트를 클릭하여 관리 화면에 진입합니다

1.3.1. 멀티리전의 이해

와탭은 데이터 수집 리전을 여러곳에 두고 서비스를 합니다. 하나의 수집리전은 N개의 수집서버가 ScaleOut될 수있는 형태로 구축되어 있습니다.

현재는 "서울 클라우드" "도쿄 클라우드" "서울 데이터센터" 3군데에서 서비스를 하고 있습니다.

region

모니터링 대상이 되는 시스템의 위치에 따라서 가까운 곳의 리전을 선택할 수있습니다.

1.4. 라이센스 발급

40

프로젝트 관리화면에서는 우선적으로 라이선스를 발급 받습니다. 라이센스 키는 프로젝트별로 귀속되기 때문에, 유출되거나 배포되어서는 안됩니다. 반드시 본인 프로젝트에 에이전트를 등록할 때에만 이용하시기 바랍니다.

1.5. 에이전트 다운로드

50

라이선스를 발급 받은 후에는 ‘에이전트 파일 다운로드’ 버튼이 활성화 되었음을 확인할 수 있습니다. 해당 버튼을 눌러 와탭 에이전트 파일을 다운로드 받습니다.

다운로드가 완료되면 안에 있는 whatap.conf 파일의 설정을 확인하여 라이선스키와 데이터 수집 서버 주소가 정상적으로 들어가 있는지를 확인합니다.

license={라이센스 키}
whatap.server.host={수집서버 정보}
wget으로 직접 다운 받을 경우, whatap.conf 파일에 라이선스키와 데이터 수집 서버 주소가 정상적으로 들어가지 않습니다.
해당 방식으로 다운 받을 경우 업로드 후 별도로 라이선스키와 데이터 수집 서버 주소를 넣어주시기 바랍니다.

1.6. 에이전트 업로드 및 방화벽 개방

애플리케이션 서버가 설치된 서버에 접속하고, 다운로드 받은 에이전트 파일을 업로드 한 후, 압축해제를 합니다.

  • $WHATAP_HOME은 와탭 APM 모니터링 에이전트의 설치 경로를 가리키며, 이후 본 문서에서 이와 같이 기술합니다.

  • 에이전트는 수집 서버 주소로 애플리케이션 서버의 성능 정보를 전송합니다. 그러므로 방화벽에 수집 서버 IP로의 TCP 아웃바운드 포트 (6600)이 차단되어 있으면 안됩니다.

에이전트 설치에서 가장 중요한 부분중에 하나가 방화벽 개방입니다. 와탭은 멀티리전에서 데이터를 수집합니다. WAS서버와 데이터 수집 리전사이의 방화벽이 개방되어있어야 합니다.

1.7. 에이전트 업데이트

와탭 APM 모니터링 서비스를 이용하면서 에이전트 버전이 업데이트 되었을 경우 새로운 버전을 다운로드 받을 수 있습니다.

660
Figure 1. 관리 > 에이전트 업데이트 메뉴를 통해 에이전트 업데이트를 진행할 수 있습니다.
670

1.8. 프로젝트 관리

1.8.1. 프로젝트 그룹

와탭은 원칙적으로 프로젝트 단위로 테넌트를 관리합니다. 그런데 하나의 사용자는 여러개의 프로젝트를 소유할 수 있고 여러개의 프로젝트를 관리하는데 편의성을 위해 와탭은 그룹 개념을 제공하고 있습니다.

그룹은 배타적 그룹입니다. 즉 하나의 프로젝트는 두개 이상의 그룹에 속할 수없습니다. 그룹에 속하지 않거나 하나의 그룹에만 속할 수있습니다.
650

1.8.2. 미터링 확인

와탭 APM 모니터링 서비스는 CPU 코어 단위의 과금 체계를 적용합니다. 모니터링 정보의 수집 대상인 애플리케이션 서버가 탑재된 물리 서버의 CPU 코어 정보를 탐지하여 월간 추이를 수집하여 차트로 나타내고 상세 정보를 제공합니다.

Metering Information

일간 최대 CPU 코어 수를 기준으로 월간 CPU 코어 추이를 차트로 표시합니다.

750
Monthly Table

일간 최대 CPU 코어 수를 기준으로 월간 CPU 코어 테이블을 표시합니다.

  • 일자(UTC 기준) : 년월일

  • CPU 코어 수 : 전체 코어 수

  • 에이전트 수 : 전체 에이전트 수

  • 호스트 수 : 전체 호스트 수

760
Daily Table

월간 추이 차트의 일 정보 클릭 시, 하단에 시간당 최대 CPU 코어 수를 기준으로 일간 CPU 코어 테이블이 표시됩니다.

일자(UTC 기준) 년월일시 정보

CPU 코어 수

시간대별 최대 코어 수

에이전트 수

시간대별 최대 에이전트 수

호스트 수

시간대별 최대 호스트 수

770

2. 실시간 모니터링

모니터링 대상 서버로부터 실시간으로 수집되고 있는 정보를 통해 프로젝트의 성능 현황을 전체적으로 확인하기 위한 정보를 제공합니다. 즉각적인 대응이 가능하며 잠재적으로 증가 하고 있는 문제를 파악할 수 있습니다.

2.1. 대시보드를 통한 시스템 전체 현황 파악

모니터링 대상 서버로부터 실시간으로 수집되고 있는 정보의 현황을 대시보드를 통해 확인할 수 있습니다. CPU, Memory를 제외한 일반적인 차트는 안정적인 데이터는 파란색으로 표현하며 그 외에 문제라 예측할 만한 색은 붉은 계열로 표시되어 사용자가 쉽게 파악할 수 있습니다.

780
Figure 2. APM 대쉬보드(메인보드)

대시보드를 통해 제공하는 정보는 아래와 같습니다.

  • 수집대상 서버 및 비활성 서버 수

  • 수집대상 서버의 전체 Core 수

  • 수집대상 서버의 호스트 수

선택 버튼을 사용하면 모니터링 대상 서버를 필터링 할 수 있습니다.

agent select
Figure 3. 에이전트 선택
agent select done
Figure 4. 에이전트 선택 적용

2.1.1. 액티브 트랜잭션

액티브 트랜잭션은 Arc Equalizer차트입니다. 모니터링 대상 애플리케이션에 실행 중 트랜잭션을 시각화하여 아크이퀄라이저로 보여줍니다. 인스턴스(에이전트) 수만큼 아크가 분할됩니다.

각 아크의 기둥은 현재 진행중인 트랜잭션 수에따라 표시됩니다.

가운데 숫자는 프로젝트 전체에서 액티브 트랜잭션 수의 합계입니다. 5초마다 현재 서버에서 처리 중인 요청의 수를 표현해서 해당 요청이 각각 어느 정도의 시간동안 처리 중인지 알 수 있습니다. 5초 간격의 시간에 감지된 요청들은 위험 여부도 파악할 수 있도록 다음과 같이 색으로 분류됩니다.

수행 시간에 따른 이퀄라이저 색 변화
  • 0초 ~ 3초: 파란색

  • 3초 ~ 8초: 군청색

  • 8초 이상: 빨간색

파란색이 많이 표현되는 것은 크게 문제가 되지 않지만 이는 아직 진행중이므로 이중에 일부가 보라색이나 빨간색으로 바뀌어 표현될 가능성이 있으므로 추이를 지켜봐야 합니다.

시스템에 장애가 발생하면 액티브 트랜잭션 수가 증가하고 빨간색부분이 많아집니다.

act tx
Figure 5. 액티브 트랜잭션(아크 이퀄라이저)

5초 간격으로 진행중인 트랜잭션 수를 표시합니다. 경우에 따라서는 처리되는 트랜잭션 수 즉 TPS는 높아도 액티브 트랜잭션은 없을 수도 있습니다.

액티브 트랜잭션 둘레에는 5초 동안 두 개의 바가 회전을 하고 있습니다. 5초 사이의 TPS에 따라서 느림,중간, 빠름의 속도로 차트 주변을 회전하게 됩니다. 회전 속도는 사용량이 많아진다는 것을 표현합니다.

2.1.2. 액티브 스테이터스

액티브 트랜잭션을 상태별로 분류하여 이퀄라이저로 보여줍니다. 프로젝트내의 모든 에이전트는 5초마다 액티브트랜잭션 수를 수집함과 동시에 액티브 상태별로 트랜잭션 수를 수집합니다.