APM Insight Node.js Agent - Release Notes

Node.js Version 5.1.2

Release Date: 04-11-2025

Enhancements

• Support for auto-scale detection for Kubernetes, AWS, and Azure environments.
• Implemented structured error handling to enhance reliability.
• Centralized the connection payload keys for better maintainability.
• Introduced a fallback mechanism to handle issues when creating the agent log folder (apminsightdata folder).
• Errors occurring during agent logger initialization are now logged to the console for improved debugging visibility.
• Improved error handling with try-catch blocks while updating instance status in the apminsight.json file.

Issues fixed

• Fixed an issue where the agent failed to create a new log file after reaching the maximum size due to a configInstance.getBaseDir is not a function error.
• Proper instance discovery of virtual machines (VMs) within auto-scaling groups and pods in Kubernetes environments.

Node.js Version 5.0.0

Release Date: 16-06-2025

Enhancements

• Support for monitoring PM2-based applications in Kubernetes (K8s) using the NODE_OPTIONS environment variable.
• The isPositiveNumber utility function has been enhanced.

Node.js Version 4.9.0

Release Date: 05-05-2025

Issues fixed

• Fixed an issue that caused the following error when attempting to ignore a transaction:
  Error while ignoring the transaction - txn_name - TypeError: Cannot read properties of undefined (reading 'toString')
• Improved the accuracy and reliability of the isNumber utility function, which is used in the averageCustomMetric computation.

Node.js Version 4.8.0

Release Date: 09-04-2025

Enhancements

• The minimum supported Node.js version has been upgraded to v16.20.2.
• Support to capture transactions based on specific HTTP response codes. Users can define the error codes to be tracked using the errorCodes key in the apminsightnode.json file (Eg: errorCodes: 400,500,600).

Node.js Version 4.4.1

Release Date: 10-02-2025

Enhancements

• Support for SodaCollection methods and SodaDatabase methods in Oracle DB monitoring.
• Support for multiple Applications Manager endpoints to efficiently manage failover setups.

Issues fixed

• The issue with external calls not being tracked while using the HTTPS package has been resolved.

Node.js Version 4.3.2

Release Date: 11-12-2024

Issues fixed

• The issue with response time data mismatch between the widget and tree view in the Traces tab has been fixed.

Node.js Version 4.3.0

Release Date: 12-04-2023

Issues fixed

• Issue in ignoring http error code has been fixed.
• Issue in docker container environment check has been fixed.
• Trace was not captured for error transactions.

Node.js Version 4.2.0

Release Date: 21-03-2023

Issues fixed

• The issue with the Hapi and Koa frameworks has been fixed.
• The external call total count calculation issue in the service map has been fixed.

Node.js Version 4.0.0

Release Date: 31-10-2023

Enhancements

• Support for various options to start the agent without modifying the user code. Refer to know more.

Node.js Version 3.1.2

Release Date: 25-08-2023

Enhancements

• Reduced noise in your monitoring environment by excluding HTTP error codes like 400, 401, and 500 from monitoring.
• Additional cloud-type detections, such as AWS (EKS, ECS, Fargate) and GCP, are supported for autoscaling.
• Support for Elastic search.
• Automatic detection of application port numbers is now supported if not specified in the configuration file.
• Support for capturing IP address list.
• Redis is now supported.
• Supported frameworks - Hapi, Koa.
• A new configuration, processManagerEnabled: true, has been added to the apminsightnode.json file for process management.
• Support for Axios module.
• Grouping of similar transactions is now supported.

Issues fixed

• The data discrepancy between the overview and transaction pages has been resolved.
• The issue with ignoring HTTP error codes has been fixed.
• The issue with the skip transaction feature has been resolved.
• The issue with the aggregated exception count and error count has been fixed.
• An issue with capturing Bytes In and Bytes Out has been resolved.
• The PM2 load balancer issue has been addressed.
• The MySQL query issue has been resolved.

Node.js Version 2.2.2

Release Date: 02-02-2022

Issues fixed

• There was an issue with data collection of Traces when the datatype of Emitter name was symbol.

Node.js Version 2.2.1

Release Date: 25-11-2021

Issues fixed

• 'Top Error codes' and 'Transaction Split Up by Error Code' were missing data in the 'Exceptions' tab.
• Validation for the application port is done.

Enhancements

• Support for capturing external HTTP calls using 'request' module.
• Support for providing application port (dynamic port) in the application start file.
• Support for capturing Query Statement when the query is executed by pg-query-stream.
• Support for providing License key, Agent Port, Host as environmental variables.
• Security - Agent configuration initialization information moved to new file 'apminsightnode.json' instead of application startup file. Learn more
• Support for capturing HTTP params.
• Support for capturing HTTP Headers
• Support for viewing the exact URL in 'Traces' tab.

Node.js Version 1.7.2

Release Date: 19-08-2020

Enhancements

• Support for Oracle database instrumentation.
• Support for Distributed Tracing.
• Agent dependency package 'https-proxy-agent' updated to latest version.
• Added custom parameters to trace.