Node.js Agent Release Notes

2026-10-23

v2.0.7

Fixed NODE_OPTIONS 환경변수로 에이전트를 적용하고 npm run start로 실행하면 에이전트가 중복 초기화·기동되던 현상 수정

Fixed 높은 TPS 환경에서 송신 큐가 가득 차 트랜잭션 데이터가 누락되던 문제 수정

• udp_send_batch_enabled Boolean 옵션 추가 (기본값: true)
• 개선된 송신 방식을 사용하며 false로 설정하면 이전 송신 방식으로 동작

2026-07-13

v2.0.6

Fixed origin_url_querystring_enabled

• trace_normalize_urls에 고정 URL(변수 {}없는 URL)로 설정된 트랜잭션의 경우에도 원본 URL(OriginURL) 수집 시 query string이 포함되도록 변경

Fixed 트랜잭션 Status Code가 200일 경우 미표기되던 현상 수정

Fixed 잔존 lock 파일로 인한 에이전트 기동 실패 수정

2026-07-06

v2.0.4

New origin_url_querystring_enabled

• 기본값: false
• 원본 URL(OriginURL) 수집 시 query string 포함 여부 지정
• trace_normalize_urls에 등록되어 정규화가 발생한 트랜잭션에만 적용됨

2026-06-25

v2.0.3

Fixed 애플리케이션이 루트 디렉토리(/)에서 실행 시 에이전트 초기화 오류로 앱이 시작되지 않던 문제 수정

2026-06-12

v2.0.2

New max_send_queue_size Number

• 기본값: 2000
• UDP 전송 큐(에이전트 → whatap_nodejs 프로세스)의 최대 크기를 설정합니다.

Fixed 헤더의 Host 값에 포트가 존재하지 않으면 도메인이 빈 값으로 나가던 현상 수정

2026-05-26

v2.0.1

Fixed 컨테이너 환경(Docker/Kubernetes) 감지 시 whatap_nodejs 실행 방식 변경(대몬 → foreground)

Fixed whatap_nodejs 프로세스 PID 확인 로직 개선

2026-04-27

v2.0.0

New LLM Observability 지원

• llm_enabled 기본값: false
• openai 라이브러리 추적 지원
• LLM 전용 메트릭, 로그 지원
• llm_model_pricing: LLM 모델의 1M 토큰당 가격 수동 설정
  • 형식: [모델 이름]|[입력 토큰]|[출력 토큰]|[캐시 토큰]
  • 예: gpt-4o|2.50|10.00|1.25,gpt-4o-mini|0.15|0.60|0.075,my-custom-model|1.00|5.00

Fixed 동시 접속 사용자 집계 로직 개선

Fixed Crypto/TLS 취약점 개선

• whatap_nodejs 모듈 Go 버전 변경
• Linux: 1.24.6 → 1.25.9, Darwin: 1.25.6 → 1.25.9

Fixed URL ignore 옵션 미적용 현상 수정

• trace_ignore_url_prefix, trace_ignore_url_set

2026-03-25

v1.0.14

Fixed Prisma v5+ 모니터링 오류 수정

Fixed ActiveStatus 오집계 현상 수정

Fixed profile_http_header_enabled=true 설정 시 Header 값 누락 현상 수정

2026-02-05

v1.0.12

New agent_per_instance_enabled

• 기본값: false
• true 설정 시, PM2 cluster 또는 Node.js cluster 환경에서 각 인스턴스의 독립된 에이전트가 실행됨
• ONAME은 “{WHATAP_NAME}-{인스턴스 번호}” 형태로 생성됨
• ex. WHATAP_NAME=my-app → my-app-0, my-app-1, my-app-2

2026-01-12

v1.0.11

New trace_kafka_enabled

• 기본값: false
• kafkajs 패키지의 producer.send/sendBatch 함수를 모니터링함

New trace_kafka_consumer_enabled

• 기본값: false
• kafkajs 패키지의 consumer.run 함수를 모니터링함

Change trace_cron_enabled

• 기본값: true → false

Fixed NodeJS 23+ 버전에서 힙메모리가 추적되지 않는 현상 수정

Fixed 외부 HTTP 호출 시 http.request()의 모든 시그니처를 지원하도록 인자 정규화 로직 개선

• http.request(options, callback) - 기존 방식
• http.request(URL, callback) - URL 문자열/객체 방식
• http.request(URL, options, callback) - URL + options 혼합 방식

2025-12-12

v1.0.10

New trace_cron_enabled

• 기본값: true
• node-cron, cron, node-schedule 패키지의 CronJob 모니터링 여부 설정

Feature Windows 2022 OS 지원

Fixed .gif, .img 등 정적 파일은 추적에서 제외됨

2025-11-11

v1.0.9

Fixed whatap_nodejs 프로세스 종료될 경우 재실행되도록 개선

Fixed 와탭 로그 파일 이름 변경(whatap-yyyymmdd.log → whatap-hook-yyyymmdd.log)

Fixed Container ID 수집 로직 개선

2025-11-06

v1.0.8

Fixed 사용자 수 집계 오류 수정

2025-10-30

v1.0.6

Fixed gRPC 모니터링 추적 개선

Fixed 브라우저 창 닫기 등 사용자 강제 종료 이벤트 발생 시 close 이벤트를 감지하여 트랜잭션이 즉시 종료되도록 개선

Fixed 클라이언트 IP 수집 오류 개선

2025-10-16

v1.0.4

New hook_method_patterns

• 사용자 애플리케이션의 특정 메소드를 모니터링할 수 있는 옵션
• 설정 파일에 메소드 경로를 지정하면 해당 메소드의 실행 시간과 호출 인자를 수집
• 기본값: false
주의

TypeScript 프로젝트는 빌드된 파일 경로를 설정 (예. ./dist/services/user.service)

Fixed PM2 클러스터 모드로 여러 인스턴스를 실행할 때 whatap_nodejs 모듈 프로세스를 효율적으로 관리하도록 개선

• 첫 번째 인스턴스만 whatap_nodejs 에이전트 시작

• 나머지 인스턴스는 이미 실행 중인 에이전트에 자동 연결

2025-09-25

v1.0.3

New exit_with_parent_process_enabled

• 기본값: false

• true인 경우 애플리케이션 종료 시 whatap_nodejs 프로세스가 종료됨

주의

Node.js 에이전트 v1.0.3 이상

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

• 애플리케이션 이름 설정

• 새로운 데이터 수집 아키텍처

• PM2 클러스터 모드 지원 개선

Fixed 쿠버네티스 컨테이너 환경에서 Container ID가 매핑되지 않는 현상 수정

주의

쿠버네티스 에이전트 v1.8.8 이상 지원

2025-08-22

v0.5.25

New perfx_nodejs_gc_enabled Boolean

• 기본값: false

• 가비지 컬렉션(GC) 성능 메트릭 수집을 실행 (Node.js 16.7버전 이상 지원 가능함)

New 애플리케이션 프로세스가 종료되는 상황을 감지하고, 종료 원인에 대한 메시지를 에이전트 로그에 기록

• SIGTERM: 시스템 또는 프로세스 매니저에 의한 정상적인 종료 요청

• SIGINT: 사용자에 의한 중단 (Ctrl+C 또는 kill 명령)

• SIGHUP: 터미널 연결 해제 또는 부모 프로세스 종료

• SIGUSR1/SIGUSR2: 사용자 정의 신호

• uncaughtException: 처리되지 않은 예외로 인한 비정상 종료

• unhandledRejection: 처리되지 않은 Promise 거부로 인한 종료

2025-07-10

v0.5.23

New Socket.io 모듈 모니터링에서 Broadcast 유형 모니터링 추가

Fixed HTTP 요청 엔드포인트를 탐지하지 못하는 현상 개선

2025-06-30

v0.5.22

New profile_mongodb_param_enabled Boolean

• 기본값: false

• mongoose 모듈 추적 시 쿼리 내 실제 파라미터 값을 표기할 수 있는 옵션 추가

Fixed HTTP 서버와 Socket.IO 서버를 함께 사용하는 구성에서 하나의 클라이언트 요청에 대해 APM에 트랜잭션이 3건(API 요청, Socket.IO handshake, polling)으로 기록되던 문제 수정

• API 요청만 단일 트랜잭션으로 기록되며, Socket.IO 연결 관련 handshake/polling 요청은 별도 트랜잭션으로 기록되지 않음

2025-06-26

v0.5.21

New ignore_env_variable_set String

• 기본값 없음

• 특정 환경변수 수집을 무시하는 옵션 추가

• 콤마(,)로 구분해서 여러 개의 값 지정

• 사용 예시. ignore_env_variable_set=ENV_1,ENV_2

New 트랜잭션 오류 발생 시 이벤트 알람 기능 추가

Fixed Prisma ORM 사용 시 통계 데이터 수집 오류 수정

2025-05-14

v0.5.19

Fixed 에이전트 로그가 삭제되지 않던 문제 수정

Fixed Prisma 오류 발생 시 오류 클래스 명칭이 잘못 표시되던 문제 수정

2025-04-14

v0.5.16

Fixed Redis 모니터링 데이터 누락 현상 수정

2025-04-04

v0.5.14

New oracledb 패키지 모니터링 추가

Fixed Prisma ORM 사용 시 통계 데이터 수집 오류 수정

2025-03-24

v0.5.12

Changed socket.io, websocket 모듈 모니터링 시 CPU 및 메모리 사용량 개선

2025-03-10

v0.5.10

New Prisma ORM 사용을 위한 옵션 추가

• prisma_read_func_name String

  기본값 read

  Replication 사용 시 Read-only 클라이언트를 얻기 위해 호출하는 함수명을 설정합니다.

• prisma_database_url_name String

  기본값 DATABASE_URL

  Prisma ORM에서 데이터베이스 연결 URL이 저장된 환경 변수명을 설정합니다.

2025-03-05

v0.5.9

New Prisma ORM 사용 시 데이터베이스 작업 추적 기능 추가

Fixed 에이전트 로그 파일 자동 정리 로직 개선

2025-02-18

v0.5.8

New GraphQL 모듈(@apollo/server) 모니터링 추가

• profile_graphql_enabled Boolean

  기본값 true

  GraphQL 모니터링 활성화 여부를 설정합니다.

• profile_graphql_variable_enabled Boolean

  기본값 false

  트랜잭션 프로파일에 GraphQL 요청의 variables 정보 포함 여부를 설정합니다.

• ignore_graphql_operation String

  지정된 Operation Name의 모니터링을 무시하도록 설정합니다. 여러 값을 대상으로 할 경우 쉼표(,)를 구분자로 사용하세요.

  whatap.conf

  ignore_graphql_operation=operationNameA,operationNameB

2025-02-07

v0.5.7

Fixed 에이전트 버전 미표기 현상 수정

2025-01-23

v0.5.6

Fixed ECS 환경 시스템의 메트릭스 수집 로직 개선

Fixed 히트맵 데이터 전송 최대 사이즈 수정

2024-11-13

v0.5.4

New 애플리케이션 성능 및 네트워크 오류 모니터링 위한 에이전트 옵션 추가

• profile_error_httpc_time_max Number

  기본값 10000

  HTTPC 수행 시간이 지정된 값을 초과할 경우 TOO SLOW 에러로 처리합니다. 0으로 설정하면 에러 처리를 하지 않습니다.

• profile_error_sql_time_max Number

  기본값 30000

  SQL 수행 시간이 설정한 값을 초과하면 TOO SLOW 에러로 처리합니다. 0으로 설정하는 경우 에러 처리를 하지 않습니다.

• profile_error_sql_fetch_max Number

  기본값 10000

  SQL 결과 건수가 설정한 값을 초과하면 TOO MANY RECORDS 에러로 처리합니다. 0으로 설정하는 경우 에러 처리를 하지 않습니다.

• ignore_http_lost_connection Boolean

  기본값 false

  true로 설정할 경우 Lost connection 오류를 수집하지 않습니다.

2024-10-17

v0.5.2

Fixed SQL 프로파일 수정

• SQL 조회 오류가 발생하면 에러 스택을 프로파일 하단에 표기합니다.

• 수정된 SQL 모듈은 다음과 같습니다. MySQL, MariaDB, PostgreSQL, SQL Server

2024-08-28

v0.5.1

New 포트(port) 번호를 추가하여 에이전트 이름(ONAME)을 생성하는 에이전트 옵션 추가 (예, NODE-14-103-3000)

oname_port_postfix_enabled Boolean 기본값 false

New 로그 모니터링을 위한 에이전트 옵션 추가

• logsink_enabled Boolean

  기본값 false

  로그 모니터링 활성화 여부를 설정합니다.

• logsink_trace_txid_enabled Boolean

  기본값 true

  로그에 트랜잭션 ID를 삽입하여 트랜잭션 트레이스의 로그 탭 노출 여부를 설정합니다.

• logsink_limit_content_enabled Boolean

  기본값 true

  로그 메시지의 최대 크기 제한 여부를 설정합니다.

• logsink_limit_content_length Number

  기본값 10,000

  로그 메시지의 최대 길이를 설정합니다. 이 값은 logsink_limit_content_enabled 옵션이 true로 설정된 경우에만 적용됩니다.

Fixed Global 패키지의 fetch 함수 모니터링 중 예외 발생 시 오류 메세지를 출력되도록 수정

2024-08-12

v0.5.0

New whatap 에이전트 로그 파일의 경로를 설정하는 에이전트 옵션 추가

log_root String 기본값 없음

Feature Node.js 내장 함수인 fetch에 대한 모니터링 기능 추가

Feature Redis 모니터링 패키지 추가(ioredis)

Changed 빌드 파일 모니터링 무시 옵션 명칭 수정

• ignore_nextjs_build_file_enabled → ignore_build_file_enabled
• ignore_nextjs_build_file_path → ignore_build_file_path

Fixed auto_oname_prefix 옵션의 값이 false임에도 true로 적용되는 오류 수정

2024-07-09

v0.4.98

New IP 주소별 트랜잭션 통계를 수집하는 에이전트 설정 옵션 추가

stat_ipurl_enabled Boolean, 기본값 false

Changed License, Server Host 값을 환경변수와 whatap.conf 파일에 동시 적용할 수 있도록 수정

환경변수와 whatap.conf 파일에 모두 적용하면 환경변수 값 기준으로 설정됩니다.

Changed ONODE NAME 설정 시 ONODE 값 생성 로직 수정

2024-06-03

v0.4.97

New 쿠버네티스 환경 사용 여부를 환경변수로 적용 가능

2024-05-30

v0.4.96

Feature 서버에서 클라이언트로 데이터 전송 시 데이터 수집을 위한 websocket 패키지 모니터링 추가

Feature 에이전트 설정 옵션 추가

• ignore_nextjs_build_file_enabled Boolean

  기본값 true

  Next.js 빌드 파일에 대한 모니터링 여부를 설정합니다. 이 옵션값을 true로 설정하면 Next.js 빌드 파일을 모니터링하지 않습니다.

• ignore_nextjs_build_file_path String

  기본값 /next/

  모니터링에서 제외할 Next.js 빌드 파일의 시작 경로를 지정할 수 있습니다. ignore_nextjs_build_file_enabled 값이 true일 경우에 적용됩니다. 쉼표(,)를 구분자로 여러 개의 경로를 설정할 수 있습니다.

  whatap.conf

  ignore_nextjs_build_file_path=/next/abc/,/next/def/

Changed trace_sampling_enabled 옵션의 기본값을 true로 변경

Fixed HTTP 모니터링에서 socket 오류에 대한 통계 데이터 수집을 무시하도록 수정

Fixed 트랜잭션의 결과가 Lost Connection일 경우 URL이 표시되지 않는 문제 수정

2024-04-29

v0.4.95

Feature 프로파일 데이터 압축 전송을 위한 에이전트 옵션 추가

profile_zip_enabled Boolean 

Changed SQL 변수, HTTP 쿼리 조회에 필요한 보안키가 작성된 파일 이름 변경

paramkey.txt → security.conf

2024-03-07

v0.4.94

Feature socket.io 모니터링 모듈 추가

trace_sampling_enabled ,trace_sampling_tps 옵션을 사용하여 샘플링된 데이터를 확인할 수 있습니다. trace_ignore_url_prefix 옵션에 /socket.io 경로를 추가해 추적할 수 없도록 설정하세요.

Feature 에이전트 설정 옵션 추가

• profile_http_header_ignore_keys String

  기본값: Cookie,cookie,accept,user-agent,referer

  HTTP 헤더 이름을 지정해 수집 정보에서 제외할 수 있습니다. 지정한 HTTP 헤더 이름의 값은 수집에서 제외되며, '#'으로 표시됩니다.

• profile_http_parameter_keys String

  설정된 키에 해당하는 파라미터 정보만 기록합니다. 여러 개를 등록할 때는 쉼표(,)를 구분자로 이용하세요. 설정하지 않을 경우 모든 파라미터 정보가 기록됩니다.

Changed profile_http_parameter_enabled 옵션이 true로 설정된 경우

• HTTP 요청의 Body 데이터를 출력하지 않도록 수정
• HTTP 파라미터 정보를 암호화하고, paramkey.txt 값으로 복호화할 수 있도록 수정

Fixed Mongoose 모니터링 예외 오류 수정

2024-02-05

v0.4.90

Feature 에이전트 설정 옵션 추가

• httpc_not_found_ignore Boolean

  기본값 false

  Not Found 오류가 특정 시간(httpc_not_found_ignore_time)에 50건 이상 발생하면 모니터링 감지를 무시합니다.

• httpc_not_found_ignore_time Milisecond

  기본값 300000

  httpc_not_found_ignore 값이 true이면 Not Found 오류를 무시할 시간을 설정합니다.

Fixed Mongoose 트래킹이 되지 않는 문제 수정

2024-01-22

v0.4.89

Fixed ONODE 설정 오류 수정

2024-01-11

v0.4.88

Fixed trace_http_client_ip_header_key=x-forwarded-for 옵션을 설정한 상태에서 헤더로 x-forwarded-for 값에 여러 개의 IP가 전달될 경우(쉼표 기준) 첫 번째 값으로 IP를 설정하도록 수정

Fixed TCP, UDP 소켓 모니터링 수정

Fixed profile_http_header_enabled 옵션의 값이 true이면 profile의 headers 값을 나타내는 방식 수정 (JSON → key=value\n)

2024-01-04

v0.4.86

Feature 에이전트 옵션 추가

• httpc_status_ignore String

  기본값 Empty

  무시할 HTTPC_ERROR 코드를 설정합니다. 여러 값을 대상으로 할 경우 쉼표(,)를 구분자로 사용하세요.

  whatap.conf

  httpc_status_ignore=404,500

• httpc_status_ignore_set String

  기본값 Empty

  whatap.error.HTTPC_ERROR를 무시합니다. 여러 값을 대상으로 할 경우 쉼표(,)를 구분자로 이용하세요.

  노트

  httpc_status_ignore_set=/a/b/c:400,/a/ab/c:404와 같이 설정하세요. 이때 url은 통계/에러 분석에서 HTTPC_URL 값을 입력합니다.

Fixed MariaDB 모니터링 안 되는 문제 수정

Fixed SQL(MySQL, SQL Server) 커넥션 정보 출력 오류 수정