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)収集時にクエリ文字列が含まれるように変更しました。

Fixed トランザクションのステータスコードが200の場合に表示されない現象を修正しました。

Fixed 残存するlockファイルが原因でエージェントが起動できない問題を修正しました。

2026-07-06

v2.0.4

New origin_url_querystring_enabled

既定値: false
元のURL（OriginURL）収集時にクエリ文字列を含めるかどうかを指定します。
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実行方式をデーモンからフォアグラウンドに変更しました。

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 設定時にヘッダー値が欠落する問題を修正

2026-02-05

v1.0.12

New agent_per_instance_enabled

既定値: false
true に設定すると、PM2 クラスターまたは Node.js クラスター環境で各インスタンスごとに独立したエージェントが実行されます
ONAME は「{WHATAP_NAME}-{インスタンス番号}」形式で生成されます
例: 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 Node.js 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 ログファイル名を変更しました (whatap-yyyymmdd.log → whatap-hook-yyyymmdd.log)。

Fixed コンテナ 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 Kubernetes コンテナ環境で Container ID がマッピングされない問題を修正

注意

Kubernetes エージェント 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サーバーを併用する構成において、1つのクライアントリクエストに対して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-04-04

v0.5.14

New oracledbパッケージモニタリング追加

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を使用する時にデータベース作業の追跡機能を追加

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-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

FixedSQLプロファイルを修正

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に設定された場合にのみ適用されます。

FixedGlobalパッケージの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

NewKubernetes環境の使用可否を環境変数として適用可能

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

ChangedSQL変数、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は統計/エラー分析にHTPC_URLの値を入力します。

Fixed MariaDBモニタリングができない問題を修正

Fixed SQL(MySQL、SQL Server) コネクション情報出力エラーを修正