Node.js Agent v1.0.3

2025년 09월 24일

Changed 독립적인 수집 프로세스 추가 적용

애플리케이션 이름 설정 개선

ONAME 설정: whatap.conf에서 app_name 설정으로 애플리케이션 이름을 지정할 수 있음

## whatap.conf
app_name=MyNodeApp              # 애플리케이션 이름
app_process_name=node           # 프로세스 명, 기본값: NODE

## 애플리케이션의 루트경로를 환경변수 WHATAP_HOME에 입력합니다.
## 기본값: process.cwd()
export WHATAP_HOME={app_root_path}

새로운 데이터 수집 아키텍처
- 독립적인 수집 프로세스: whatap_nodejs 프로세스가 별도로 실행되어 데이터를 취합하고 수집서버로 전송함
- 향상된 성능: Node.js 애플리케이션과 독립적인 프로세스로 실행되어 메인 애플리케이션 성능에 미치는 영향을 최소화함
PM2 클러스터 모드 지원 개선
- 통합 모니터링: PM2 클러스터 모드로 2개 이상의 인스턴스를 실행할 경우, 하나의 app_name으로 통합하여 표현됨
- 효율적인 리소스 관리: 여러 인스턴스의 데이터를 하나의 수집 프로세스에서 처리하여 리소스 사용량을 최적화함
노트
참고
PM2로 실행하더라도 app_process_name은 node로 설정합니다. 이는 실제 프로세스명이 아닌 WhaTap 모니터링에서의 식별 목적입니다.
호환성
- Node.js 버전: 17.0.0 이상
- 플랫폼: macOS (64bit), Linux (64bit)
- 지원 프레임워크: Express, Koa, Fastify, Socket.IO, WebSocket, GraphQL
- 지원 데이터베이스: MySQL, PostgreSQL, MSSQL, Oracle, MariaDB, MongoDB, Redis

정보

NPM 방식 패키지 정보: https://www.npmjs.com/package/whatap

설치 및 적용 방법
```
npm install whatap
```

정보

로컬 설치 파일 방식 다운로드 정보: Node.js Agent v1.0.3

tgz 파일 압축 해제

tar -xzf whatap.agent.nodejs.1.0.3.tgz -C /path/to/app_directory

whatap 및 의존성 패키지 설치

cd /path/to/app_directory 
npm install long-3.2.0.tgz proper-lockfile-4.1.2.tgz uuid-11.1.0.tgz whatap-1.0.3.tgz