에이전트 설치

와탭 모니터링 서비스를 사용하기 위해서는 회원 가입 후 프로젝트를 생성하고 대상 서버에 에이전트를 설치해야 합니다. 회원 가입에 관한 자세한 내용은 다음 문서를 참조하세요.

다음 동영상 가이드를 참조하세요.

프로젝트 생성하기

에이전트를 설치하기 전에 먼저 프로젝트를 생성하세요.

와탭 모니터링 서비스로 이동한 다음 로그인하세요.
프로젝트를 생성하려면 화면 왼쪽 사이드 메뉴에서 전체 프로젝트 > + 프로젝트 버튼을 선택하세요.
상품 선택 화면에서 프로젝트에 설치할 상품을 선택하세요.
프로젝트 이름, 데이터 서버 지역, 타임 존 등의 항목을 차례로 설정하세요.
모든 설정을 완료한 다음에는 프로젝트 생성하기 버튼을 선택하세요.

노트

데이터 서버 지역은 리전(클라우드 서비스를 제공하기 위해 설치한 데이터 센터의 묶음)을 의미합니다. 특정 리전을 선택하면 해당 리전에 속한 데이터 센터에 사용자의 데이터를 저장합니다.
타임 존은 알림, 보고서를 생성하는 기준 시간입니다.
여러 개의 프로젝트를 그룹으로 묶어 관리하려면 프로젝트 그룹에서 그룹을 선택하거나 그룹을 추가하세요. 그룹에 대한 자세한 설명은 다음 문서를 참조하세요.
조직을 선택한 상태에서 프로젝트를 추가할 경우 조직 하위 그룹을 필수로 설정해야 합니다.

액세스 키 확인

액세스 키는 와탭 서비스 활성화를 위한 고유 ID입니다.

설치 안내 섹션에서 프로젝트 액세스 키 발급받기 버튼을 선택하세요. 액세스 키를 자동으로 발급받은 후 다음 단계를 진행합니다.

노트

프로젝트를 생성한 다음에는 자동으로 에이전트 설치 페이지로 이동합니다. 에이전트 설치 페이지로 이동하지 않는다면 화면 왼쪽 메뉴에서 관리 > 에이전트 설치를 선택하세요.

에이전트 다운로드

액세스 키를 발급받으면 사용하는 운영체제를 선택하세요. 그리고 에이전트 다운로드 섹션에서 해당 운영체제의 명령어를 복사해 에이전트를 설치하세요.

PHP 에이전트 설치 방식은 리눅스 패키지 설치 방식입니다. 설치 순서는 다음과 같습니다.

와탭 리포지토리를 등록하세요.
whatap-php 리눅스 패키지(yum, apt-get)를 설치하세요.
설정 스크립트를 실행하세요. 설정 스크립트를 통해서 트레이서는 PHP 확장 모듈로 등록되고, 에이전트는 whatap-php 서비스로 실행됩니다.
Apache 또는 PHP-FPM을 다시 시작하세요.

노트

에이전트 파일 구성에 대한 자세한 설명은 PHP 파일 구성을 참조하세요.

PHP 에이전트 파일 구성

PHP 에이전트 파일은 애플리케이션 모니터링에 필요한 정보를 추출하여 와탭 수집 서버로 전달하는 트레이서, 수집된 정보를 서버에 전송하기 위한 에이전트, 트레이서와 에이전트를 서버에 동적으로 적용하기 위한 설치 스크립트 파일로 구성되어 있습니다.

whatap_X.Y.Z.so

트레이서로 등록된 PHP 확장 모듈로 추가되어 정보를 수집하고 수집된 정보를 에이전트로 전송하는 라이브러리입니다. 확장 모듈은 PHP 버전(PHP API Version)별, Zend Thread Safe 지원 여부로 구별됩니다. 예시는 다음과 같습니다.
- whatap_zts_20041225.so
  
  PHP 5.2 버전, Zend Thread safe enable
- whatap_20041225.so
  
  PHP 5.2 버전, Non Thread Safe
whatap-php(whatap_php)

에이전트, 트레이서에서 UDP로 전달된 정보를 수집 서버로 전송하는 프로그램입니다.
/etc/init.d/whatap-php

서비스 스크립트입니다.
whatap_php

서비스 실행 파일입니다.
whatap.ini

애플리케이션 서버의 데이터를 수집하는 PHP 확장 모듈의 설정 정보, 수집 서버의 주소와 서버의 가 입력되는 파일입니다.
template.ini

whatap.ini 생성 시 복사해 사용하는 템플릿 파일입니다.
whatap-install-yyyymmdd.log

설치 과정에 대한 로그 파일입니다. 기본 저장 경로는 /usr/whata/php/logs 입니다. 날짜별로 파일이 생성됩니다. 기본 7일 동안의 로그만 유지됩니다.
whatap-boot-yyyymmdd.log

에이전트 로그 파일입니다. 기본 저장 경로는 /usr/whata/php/logs 입니다. 날짜별로 파일이 생성됩니다. 기본 7일 동안의 로그가 유지됩니다.
install.sh

설치 스크립트입니다. PHP 확장 모듈(whatap.so)을 Apache 또는 PHP-FPM에 설치, whatap-php 서비스 설치를 진행합니다. 자세한 내용은 다음 문서를 참조하세요.
WhaTap.php (sample.php)

PHP 소스코드에서 사용할 API 레퍼런스 클래스(/usr/whatap/php/lib/WhaTap.php) 및 예제 소스 파일(sample.php)입니다.