설치
와탭 애플리케이션 모니터링 - Node.js 에이전트 설치 가이드
Node.js 모니터링 서비스를 사용하기 위해서는 모니터링 대상 애플리케이션에 모니터링 에이전트를 설치해야 합니다. 설치는 npm(Node Package Manager)을 통해 가능 합니다.
-
서비스 중인 Node.js 파일의 폴더에 와탭 에이전트 모듈을 설치합니다.
-
탭 라이센스 환경설정(whatap.conf)을 합니다.
-
Node.js 서비스를 다시 실행합니다.
라이센스 및 수집 서버 등록
브라우저를 열고 와탭 서비스 화면에 접속하여 프로젝트 관리화면에서 라이선스를 발급 받습니다. 라이센스 키는 프로젝트별로 귀속되기 때문에, 유출되거나 배포되어서는 안됩니다.
| 와탭은 라이센스 키에 숨겨진 키를 가지고 에이전트와 서버사이에서 데이터를 암호화 합니다. |
node_modules/whatap에 있는 whatap.conf 파일을 루트 디렉토리로 복사 후 라이센스 키를 발급 받은 후 추가해 주세요
whatap.conf
license=x46n3a26be1ah-z2rswcfcvlq2ph-z114c81gfhqpgg
whatap.server.host=52.78.209.94/52.78.224.235host 주소는 와탭 proxy가 설치된 서버의 주소입니다. '/'를 이용하여 와탭서버중 proxy서버가 실행중인 서버의 모든 주소를 지정합니다.
코드 작성
루트 디렉토리의 Node.js 애플리케이션에 위와 같이 에이전트 코드를 삽입합니다. ( 예를 들어 express 의 경우 app.js )
var whatap=require('whatap').NodeAgent;| 코드는 node.js가 기동되고 가장 먼저 실행되어야 하므로 가장 처음 import 보다 먼저 위치해야 합니다. |
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 항목을 참조하세요. |