설치

와탭 애플리케이션 모니터링 - Node.js 에이전트 설치 가이드

Node.js 모니터링 서비스를 사용하기 위해서는 모니터링 대상 애플리케이션에 모니터링 에이전트를 설치해야 합니다. 설치는 npm(Node Package Manager)을 통해 가능 합니다.

  • 서비스 중인 Node.js 파일의 폴더에 와탭 에이전트 모듈을 설치합니다.

  • 탭 라이센스 환경설정(whatap.conf)을 합니다.

  • Node.js 서비스를 다시 실행합니다.

Npm install

npm ( Node Package Manager )을 통해서 와탭 에이전트를 설치 합니다.

$ npm install whatap --save

라이센스 및 수집 서버 등록

브라우저를 열고 와탭 서비스 화면에 접속하여 프로젝트 관리화면에서 라이선스를 발급 받습니다. 라이센스 키는 프로젝트별로 귀속되기 때문에, 유출되거나 배포되어서는 안됩니다.

와탭은 라이센스 키에 숨겨진 키를 가지고 에이전트와 서버사이에서 데이터를 암호화 합니다.

node_modules/whatap에 있는 whatap.conf 파일을 루트 디렉토리로 복사 후 라이센스 키를 발급 받은 후 추가해 주세요

whatap.conf
license=x46n3a26be1ah-z2rswcfcvlq2ph-z114c81gfhqpgg
whatap.server.host=52.78.209.94/52.78.224.235

host 주소는 와탭 proxy가 설치된 서버의 주소입니다. '/'를 이용하여 와탭서버중 proxy서버가 실행중인 서버의 모든 주소를 지정합니다.

코드 작성

루트 디렉토리의 Node.js 애플리케이션에 위와 같이 에이전트 코드를 삽입합니다. ( 예를 들어 express 의 경우 app.js )

var whatap=require('whatap').NodeAgent;
코드는 node.js가 기동되고 가장 먼저 실행되어야 하므로 가장 처음 import 보다 먼저 위치해야 합니다.

실행

애플리케이션을 실행합니다.

$ node app.js

로그 파일

어플리케이션 서버가 실행되면 애플리케이션의 모니터링 정보를 수집하기 시작합니다.

에이전트 로그는 logs/whatap-yyyymmdd.log 형태로 출력됩니다.

PaaS

PaaS 애플리케이션에서 에이전트를 설치하는 경우엔 모든 설정을 소스(app.js)에서 설정해야 합니다.

whatap.conf를 사용할 수 없습니다.

라이센스 및 수집 서버 등록

WHATAP_LICENSE와 WHATAP_SERVER_HOST 환경변수에 라이선스와 서버 주소를 설정합니다.

app.js
process.env.WHATAP_LICENSE='x46n3226be1ah-z2rsecfcvlq2ph-z11bc81gfhqpgg';
process.env.WHATAP_SERVER_HOST='52.78.209.94/52.78.224.235';
var whatap=require('whatap').NodeAgent;
...

환경변수로 설정가능한 옵션

whatap.conf를 사용할 수 없기 때문에 소스에 환경변수로 whatap agent 옵션을 설정해야 합니다.

process.env.profile_http_header_enabled=false;
process.env.profile_http_parameter_enabled=false;

process.env.profile_basetime=500;

process.env.auto_oname_enabled=false;
process.env.auto_oname_prefix='nodejs';

process.env.mtrace_rate=0;
process.env.mtrace_spec='v1';
process.env.stat_mtrace_enabled=false;
process.env.stat_domain_enabled=false;
옵션에 대한 자세한 설명은 활용하기 > 에이전트 설정하기 > 애플리케이션에서 Node.js 항목을 참조하세요.