Node.js Agent Release Notes

2026-10-23

v2.0.7

Fixed Fixed the agent being initialized and started twice when applied through the NODE_OPTIONS environment variable and run with npm run start.

Fixed Fixed transaction data loss caused by a full send queue in high-TPS environments.

• Added the udp_send_batch_enabled Boolean option (default: true).
• Uses the improved send method. Set it to false to use the previous send method.

2026-07-13

v2.0.6

Fixed origin_url_querystring_enabled

• Changed so that the query string is included when collecting the original URL (OriginURL), even for transactions registered as fixed URLs (URLs without {} variables) in trace_normalize_urls.

Fixed Fixed an issue where the transaction status code was not displayed when it was 200.

Fixed Fixed an issue where the agent failed to start due to a leftover lock file.

2026-07-06

v2.0.4

New origin_url_querystring_enabled

• Default: false
• Specifies whether to include the query string when collecting the original URL (OriginURL).
• Applies only to transactions normalized via URLs registered in trace_normalize_urls.

2026-06-25

v2.0.3

Fixed Fixed an issue where the application failed to start due to an agent initialization error when running from the root directory (/).

2026-06-12

v2.0.2

New max_send_queue_size Number

• Default: 2000
• Sets the maximum size of the UDP transmission queue (agent → whatap_nodejs process).

Fixed Fixed an issue where the domain was sent as an empty value when the Host header did not include a port.

2026-05-26

v2.0.1

Fixed Changed the whatap_nodejs execution mode from daemon to foreground when detecting container environments (Docker/Kubernetes).

Fixed Improved the whatap_nodejs process PID detection logic.

2026-04-27

v2.0.0

New Added LLM Observability support

• llm_enabled default: false
• Added tracing support for the openai library
• Added LLM-specific metrics and log support
• llm_model_pricing: Manually configure price per 1M tokens for LLM models
  • Format: [model name]|[input tokens]|[output tokens]|[cache tokens]
  • Example: 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 Improved concurrent user aggregation logic

Fixed Addressed Crypto/TLS vulnerability

• Updated Go version for the whatap_nodejs module
• Linux: 1.24.6 → 1.25.9, Darwin: 1.25.6 → 1.25.9

Fixed Fixed URL ignore option not being applied

• trace_ignore_url_prefix, trace_ignore_url_set

2026-03-25

v1.0.14

Fixed Fixed Prisma v5+ monitoring error

Fixed Fixed ActiveStatus miscounting issue

Fixed Fixed missing header values when profile_http_header_enabled=true is set

2026-02-05

v1.0.12

New agent_per_instance_enabled

• Default: false
• When set to true, an independent agent runs for each instance in a PM2 cluster or Node.js cluster environment
• ONAME is generated in the format “{WHATAP_NAME}-{instance number}”
• Example: WHATAP_NAME=my-app → my-app-0, my-app-1, my-app-2

2026-01-12

v1.0.11

New trace_kafka_enabled

• Default value: false
• Monitors the producer.send/sendBatch functions of the kafkajs package

New trace_kafka_consumer_enabled

• Default value: false
• Monitors the consumer.run function of the kafkajs package

Change trace_cron_enabled

• Default value: true → false

Fixed Fixed an issue where heap memory was not traced in Node.js version 23+

Fixed Improved argument normalization logic to support all signatures of http.request() when making external HTTP calls

• http.request(options, callback) - existing method
• http.request(URL, callback) - URL string/object method
• http.request(URL, options, callback) - mixed URL + options method

2025-12-12

v1.0.10

New trace_cron_enabled

• Default: true
• Configures whether to monitor CronJob executions from node-cron, cron, and node-schedule packages

Feature Windows 2022 OS support

Fixed Static files such as .gif and .img are excluded from tracing

2025-11-11

v1.0.9

Fixed Improved to automatically restart the whatap_nodejs process when it terminates.

Fixed Changed the WhaTap log file name (whatap-yyyymmdd.log → whatap-hook-yyyymmdd.log).

Fixed Improved container ID collection logic.

2025-11-06

v1.0.8

Fixed Fixed an error in user count aggregation

2025-10-30

v1.0.6

Fixed Improved gRPC monitoring trace.

Fixed Improved transaction handling to immediately terminate when a user forcibly closes the browser window or triggers a close event.

Fixed Improved client IP collection error handling.

2025-10-16

v1.0.4

New hook_method_patterns

• Option that allows monitoring of specific methods in user applications.
• When the method path is specified in the configuration file, the execution time and call arguments of that method are collected.
• Default: false
Caution

For TypeScript projects, specify the built file path (e.g. ./dist/services/user.service).

Fixed Improved process management for the whatap_nodejs module when running multiple instances in PM2 cluster mode.

• Only the first instance starts the whatap_nodejs agent.

• The remaining instances automatically connect to the already running agent.

2025-09-25

v1.0.3

New exit_with_parent_process_enabled

• Default: false

• If set to true, the whatap_nodejs process terminates when the application exits

Caution

Node.js Agent v1.0.3 or higher

Changed Introduced an independent collector process

• Application name configuration

• New data collection architecture

• Improved PM2 cluster mode support

Fixed Fixed an issue where the Container ID was not mapped in Kubernetes container environments

Caution

Supported from Kubernetes agent v1.8.8 or higher

2025-08-22

v0.5.25

New perfx_nodejs_gc_enabled Boolean

• Default: false

• Enables collection of Garbage Collection (GC) performance metrics (Supported in Node.js version 16.7 or higher)

New Detects when the application process terminates and records the termination reason in the agent log

• SIGTERM: Normal termination request from the system or process manager

• SIGINT: Interruption by the user (Ctrl+C or kill command)

• SIGHUP: Terminal disconnection or parent process termination

• SIGUSR1/SIGUSR2: User-defined signals

• uncaughtException: Abnormal termination due to an unhandled exception

• unhandledRejection: Termination due to an unhandled Promise rejection

2025-07-10

v0.5.23

New Added monitoring support for Broadcast type in Socket.io module monitoring

Fixed Improved detection of HTTP request endpoints

2025-06-30

v0.5.22

New profile_mongodb_param_enabled Boolean

• Default: false

• Added an option to display actual query parameter values when tracing the mongoose module

Fixed Fixed an issue where three transactions (API request, Socket.IO handshake, and polling) were recorded for a single client request when using both an HTTP server and a Socket.IO server together

• Now only the API request is recorded as a single transaction. Socket.IO handshake and polling requests are no longer recorded as separate transactions

2025-06-26

v0.5.21

New ignore_env_variable_set String

• No default value

• Added an option to exclude specific environment variables from collection

• Supports multiple values separated by commas (,)

• Example usage: ignore_env_variable_set=ENV_1,ENV_2

New Added event alarm feature triggered on transaction errors

Fixed Fixed an issue with collecting statistical data when using Prisma ORM

2025-04-04

v0.5.14

New Added the oracledb monitoring package.

2025-03-10

v0.5.10

New Added the option to use the Prisma ORM.

• prisma_read_func_name String

  Default read

  Set the name of the function called to obtain a read-only client when using replication.

• prisma_database_url_name String

  Default DATABASE_URL

  Set the environment variable name in Prisma ORM where the database connection URL is stored.

2025-03-05

v0.5.9

New Added the database operation tracing feature when using the Prisma ORM.

Fixed Improved the automatic cleanup logic for the agent log file.

2025-02-18

v0.5.8

New Added monitoring for GraphQL modules (@apollo/server).

• profile_graphql_enabled Boolean

  Default true

  Set whether or not to enable the GraphQL monitoring.

• profile_graphql_variable_enabled Boolean

  Default false

  Set whether to include variables from GraphQL requests in the transaction profile.

• ignore_graphql_operation String

  It sets monitoring of the specified operation name to be ignored. For multiple values, use comma (,) as the delimiter.

  whatap.conf

  ignore_graphql_operation=operationNameA,operationNameB

2025-02-07

v0.5.7

Fixed Fixed the issue where the agent version does not appear.

2025-01-23

v0.5.6

Fixed Improved the metrics collection logic for ECS-environment systems.

Fixed Modified the maximum size for hitmap data transmission.

2024-11-13

v0.5.4

New Added the agent option for monitoring the application performance and network errors.

• profile_error_httpc_time_max Number

  Default 10000

  If the HTTPC execution time exceeds the specified value, it is treated as the TOO SLOW error. If it is set to 0, error handling is not performed.

• profile_error_sql_time_max Number

  Default 30000

  If the SQL execution time exceeds the specified value, it is treated as the TOO SLOW error.If it is set to 0`, it is not treated as an error.

• profile_error_sql_fetch_max Number

  Default 10000

  If the number of SQL results exceeds the specified value, it is treated as the TOO MANY RECORDS error. If it is set to 0`, it is not treated as an error.

• ignore_http_lost_connection Boolean

  Default false

  If it is set to true, Lost connection errors are not collected.

2024-10-17

v0.5.2

Fixed Modified the SQL profile.

• If a SQL query error occurs, the error stack is displayed at the bottom of the profile.

• The modified SQL module is as follows. MySQL, MariaDB, PostgreSQL, SQL Server

2024-08-28

v0.5.1

New Added the agent option to create the agent name (ONAME) by adding the port number (e.g. NODE-14-103-3000).

oname_port_postfix_enabled Boolean Default false

New Added the agent option for log monitoring.

• logsink_enabled Boolean

  Default false

  Set whether or not to enable the log monitoring.

• logsink_trace_txid_enabled Boolean

  Default true

  Set whether or not to expose the log tab of the transaction trace by inserting the transaction ID into the logs.

• logsink_limit_content_enabled Boolean

  Default true

  Set whether or not to limit the maximum size for log messages.

• logsink_limit_content_length Number

  Default 10,000

  Set the maximum length of the log message. This value is applied only when the logsink_limit_content_enabled option is set to true.

Fixed Modified to output an error message when an exception occurs while monitoring the fetch function in the global package.

2024-08-12

v0.5.0

New Added the agent option to set the path of WhaTap agent log file.

log_root String Default none

Feature Added the monitoring feature for the Node.js's built-in function, fetch.

Feature Added the Redis monitoring package (ioredis).

Changed Modified the name of the option to ignore the build file monitoring.

• ignore_nextjs_build_file_enabled → ignore_build_file_enabled
• ignore_nextjs_build_file_path → ignore_build_file_path

Fixed Fixed the error where the value of the auto_oname_prefix option is applied as true even though it is false.

2024-07-09

v0.4.98

New Added the agent configuration options to collect transaction statistics by IP address.

stat_ipurl_enabled Boolean, Default false

Changed Modified to apply the license and server host to both environment variables and whatap.conf file.

When applied to both the environment variables and whatap.conf file, they are configured based on the environment variable's value.

Changed Modified the ONODE value creation logic when setting the ONODE NAME.

2024-06-03

v0.4.97

New Whether or not to use the Kubernetes environment can be applied as an environment variable.

2024-05-30

v0.4.96

Feature Added the websocket package monitoring to collect data while transmitting data from the server to clients.

Feature Added the agent setting options.

• ignore_nextjs_build_file_enabled Boolean

  Default true

  Set whether to monitor the Next.js build files. If this option is set to true, the Next.js build files are not monitored.

• ignore_nextjs_build_file_path String

  Default /next/

  You can specify the startup path of Next.js build files to exclude from the monitoring. It is applied when the value of ignore_nextjs_build_file_enabled is true. With comma (,) as the delimiter, multiple paths can be set.

  whatap.conf

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

Changed Changed the default value of the trace_sampling_enabled option to true.

Fixed Modified the HTTP monitoring to ignore statistical data collection for socket errors.

Fixed Fixed the issue where the URL is not displayed when the transaction result is Lost Connection.

2024-04-29

v0.4.95

Feature Added the agent option for compressed transmission of the profile data.

profile_zip_enabled Boolean

Changed Changed the file name where the security key for querying SQL variables and HTTPs has been created.

paramkey.txt → security.conf

2024-03-07

v0.4.94

Feature Added the socket.io monitoring module.

Using the trace_sampling_enabled and trace_sampling_tps options, you can see the sampled data. Make it untraceable by adding the /socket.io path to the trace_ignore_url_prefix option.

Feature Added the agent setting options.

• profile_http_header_ignore_keys String

  Default Cookie,cookie,accept,user-agent,referer

  You can specify the HTTP header name to exclude from collection. The set HTTP header names are excluded from collection, and they are marked with "#."

• profile_http_parameter_keys String

  Only the parameters corresponding to the set key are recorded. For multiple values, use comma (,) as the delimiter. If not specified, all parameters are recorded.

Changed In case the profile_http_parameter_enabled option is set to true

• Modified not to output the body data of an HTTP request.
• Modified to encrypt HTTP parameters and decrypt them with the paramkey.txt value.

Fixed Fixed the Mongoose monitoring exception error.

2024-02-05

v0.4.90

Feature Added the agent setting options.

• httpc_not_found_ignore Boolean

  Default false

  If more than 50 Not Found errors occur in a certain time (httpc_not_found_ignore_time), monitoring detection is ignored.

• httpc_not_found_ignore_time Milisecond

  Default 300000

  If the value of httpc_not_found_ignore is true, set the time to ignore the Not Found errors.

Fixed Fixed the issue where the Mongoose tracking does not work.

2024-01-22

v0.4.89

Fixed Fixed the ONODE setting error.

2024-01-11

v0.4.88

Fixed When the trace_http_client_ip_header_key=x-forwarded-for option has been set and multiple IPs are passed to the x-forwarded-for value via the header, modified to set the IP to the first value (based on comma).

Fixed Modified the TCP and UDP socket monitoring.

Fixed When the value of the profile_http_header_enabled option is true, modified the display method of the profile's header values (JSON → key=value\n).

2024-01-04

v0.4.86

Feature Added the agent options

• httpc_status_ignore String

  Default Empty

  Set the HTTPC_ERROR codes to ignore. For multiple values, use comma (,) as the delimiter.

  whatap.conf

  httpc_status_ignore=404,500

• httpc_status_ignore_set String

  Default Empty

  whatap.error.HTTPC_ERROR is ignored. For multiple values, use comma (,) as the delimiter.

  Note

  Set it as httpc_status_ignore_set=/a/b/c:400,/a/ab/c:404. In Statistics/Error Analysis, enter the value for HTTPC_URL.

Fixed Fixed the issue where the MariaDB monitoring does not work.

Fixed Fixed the SQL (MySQL, SQL Server) connection information output error.