# APM Insight Node.js Agent - Release Notes ## Node.js Version 5.4.1 **Release Date:** 25-05-2026 ### Enhancements - Enhanced automatic detection of appName in Kubernetes environments. - Revamped the criteria for agent log clean-up. - Support for Applications Manager Data Exporter to send metrics. Refer [here](https://www.manageengine.com/products/applications_manager/help/apm-insight-nodejs-agent-install.html#dataexporter) for configuration details. - Enhanced Docker images with improved security measures. - Added APM Auto Profiler related enhancements. - Upgraded the dependent package @apminsight/native-stats to v2.0.0. - Updated the minimum supported node version to v18. - Enhancements to the AutoProfiler. ### Issues fixed - All warnings associated with the agent installation process have been resolved. --- ## 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](https://www.manageengine.com/products/applications_manager/help/apm-insight-nodejs-agent-install.html) 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](https://pitstop.manageengine.com/portal/en/kb/articles/managing-node-js-applications-using-applications-manager#Configure_PM2_Process_Manager_to_manage_Nodejs_applications), 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](https://www.manageengine.com/products/applications_manager/help/apm-insight-nodejs-agent-install.html). - Security - Agent configuration initialization information moved to new file 'apminsightnode.json' instead of application startup file. [Learn more](https://www.manageengine.com/products/applications_manager/help/apm-insight-nodejs-agent-install.html) - 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](https://www.manageengine.com/products/applications_manager/help/apm-insight-nodejs-agent-custom-instrumentation.html#Custom-params) to trace.