Node.js Agent 发布说明
版本 5.4.0
2026 年 4 月 8 日
增强功能：
- 增强了在 Kubernetes 环境中对 appName 的自动检测能力。
- 修订了 Agent 日志清理标准。
版本 5.3.1
2026 年 3 月 9 日
增强功能：
- 支持新加坡 DC。
- 对 AutoProfiler 进行了增强。
版本 5.3.0
2026 年 2 月 2 日
增强功能：
- 添加了 APM 自动分析器相关增强功能。
- 将依赖包 @apminsight/native-stats 升级至 v2.0.0。
- 将最低支持的 Node 版本更新至 v18。
问题修复：
- 已解决与 Agent 安装过程相关的所有警告。
版本 5.2.1
2025 年 12 月 25 日
增强功能：
- 通过改进安全措施增强了 Docker 镜像。
版本 5.2.0
2025 年 11 月 7 日
增强功能：
- 支持 S247Data Exporter 发送指标。配置详情请参阅此处。
版本 5.1.1
2025 年 8 月 28 日
增强功能：
- 为 Kubernetes、AWS 和 Azure 环境添加了自动扩展检测支持。
- 实施了结构化错误处理以提高可靠性。
- 集中管理连接有效载荷密钥以提高可维护性。
问题修复：
- 修复了在 Kubernetes 环境中自动扩展组和 Pod 内虚拟机（VM）实例发现不准确的问题。
版本 5.1.0
2025 年 7 月 9 日
增强功能：
- 引入了回退机制，用于处理创建 Agent 日志文件夹（apminsightdata 文件夹）时出现的问题。
- Agent 日志记录器初始化期间发生的错误现在会输出到控制台，以提高调试可见性。
- 通过 try-catch 块改进了更新 apminsight.json 文件中实例状态时的错误处理。
- 支持从事务名称中排除分组。
问题修复：
- 修复了 Agent 在达到最大大小后由于 configInstance.getBaseDir is not a function 错误而无法创建新日志文件的问题。
版本 5.0.0
2025 年 6 月 12 日
增强功能：
- 增加了对使用 NODE_OPTIONS 环境变量在 Kubernetes（K8s）中监控基于 PM2 的应用程序的支持。
- 增强了 isPositiveNumber 工具函数。
- 细微增强（命名规范等）。
版本 4.9
2025 年 4 月 24 日
增强功能：
- 更正了语法和命名不一致问题：
- agentInstace 更正为 agentInstance
- markCompeletd 更正为 markCompleted
问题修复：
- 修复了忽略事务时导致以下错误的问题：
Error while ignoring the transaction - txn_name - TypeError: Cannot read properties of undefined (reading 'toString'). - 提高了 isNumber 工具函数的准确性和可靠性，该函数用于 averageCustomMetric。
版本 4.8.0
2025 年 3 月 26 日
更新：
- 最低支持的 Node 版本已升级至 v16.20.2。
问题修复：
- 修复了通过 apminsightnode.json 文件设置的错误码配置问题。
- 无论 appGroupName 配置如何，标签现在都将正常发送。
版本 4.7.0
2025 年 2 月 25 日
增强功能：
- 添加了从 v4.1.1 到 v4.6.0 版本更新的边界情况验证，解决了检索关键事务阈值配置文件数据时的边界情况问题。
版本 4.6.0
2025 年 2 月 19 日
增强功能：
- 支持 UAE Collector。
- 支持根据特定 HTTP 响应码捕获事务，可通过以下两种方式配置：
- apminsightnode.json 文件中的 errorCodes 键。
例如："errorCodes": "400,500,600" - Agent 配置文件中的要跟踪的 HTTP 错误码列表部分。
- apminsightnode.json 文件中的 errorCodes 键。
版本 4.5.0
2025 年 1 月 29 日
增强功能：
- 支持监视器组和标签。
版本 4.4.1
2025 年 1 月 20 日
增强功能：
- 完成细微增强。
版本 4.4.0
2025 年 1 月 6 日
增强功能：
- 支持 Oracle Database 模块。
- 将外部组件名称 WEBREQUEST 重命名为 HTTP。
- 支持 SQL 调用中的 index 查询。
版本 4.3.2
2024 年 12 月 7 日
增强功能：
- 追踪现在包含摘要，提供方法调用总数、SQL 查询数和异常数。
版本 4.3.1
2024 年 10 月 10 日
问题修复：
- 修复了在传入 null 时出现 TypeError: httpHeadersFromReq[eachHeaderKey].split is not a function 的问题。
版本 4.3.0
2024 年 4 月 9 日
问题修复：
- 修复了忽略 HTTP 错误码的问题。
- 修复了错误事务不捕获追踪的问题。
版本 4.2.0
2024 年 1 月 29 日
问题修复：
- 修复了 Hapi 和 Koa 框架的问题。
- 修复了服务地图中外部调用失败数计算的问题。
版本 4.0.0
2023 年 8 月 18 日
增强功能：
- 现在提供多种无需修改用户代码即可启动 Agent 的选项。详情请参阅 Node.js 安装页面。
- 在配置文件中或以环境变量（APMINSIGHT_APP_GROUP_NAME）方式设置应用程序组名称（appGroupName）。
版本 3.1.2
2023 年 7 月 11 日
增强功能：
- 追踪标签页现在显示追踪的总入站字节数和总出站字节数数据。
版本 3.1.1
2023 年 5 月 25 日
问题修复：
- 修复了概览页面与事务页面之间数据不一致的问题。
版本 3.1.0
2023 年 5 月 19 日
增强功能：
- 支持额外的云类型检测（如 AWS（EKS、ECS、Fargate）和 GCP）用于自动扩展。
版本 3.0.0
2023 年 4 月 3 日
新功能：
- Agent 收集 NVM 指标，并在单独的标签页中显示。
版本 2.9.1
2023 年 3 月 2 日
安全问题修复（ZVE-2023-0246）：
- 对 apminsightnode.json 文件中的许可证密钥进行了加密。
版本 2.9.0
2023 年 1 月 17 日
增强功能：
- 支持 Next.js。
版本 2.8.0
2022 年 11 月 30 日
增强功能：
- 支持 Elasticsearch。
- 支持在配置文件中未指定应用程序端口号时自动检测。
- 支持捕获 IP 地址列表。
版本 2.7.0
2022 年 10 月 20 日
增强功能：
- 支持框架：Hapi、Koa。
- Node.js Agent 支持 RUM 脚本注入。
版本 2.6.0
2022 年 9 月 20 日
增强功能：
- 支持对相似事务进行分组。
- 支持基于前缀对事务进行分组。
问题修复：
-
修复了跳过事务功能的问题。
版本 2.5.1
2022 年 8 月 5 日
增强功能：
- 已在 apminsightnode.json 文件中为进程管理添加新配置。
processManagerEnabled : true
问题修复：
-
修复了聚合异常数和错误数的问题。
版本 2.5.0
2022 年 7 月 4 日
增强功能：
- 支持 Axios 模块。
问题修复：
- 修复了在 MySQL2 和 pgSQL 中使用未声明功能的问题。
- 修复了忽略 HTTP 错误码的问题。
版本 2.4.0
2022 年 6 月 15 日
新功能：
- 支持将任意事务设置为关键事务。
问题修复：
-
修复了入站字节数和出站字节数捕获的问题。
版本 2.3.1
2022 年 5 月 13 日
问题修复：
- 修复了 PM2 负载均衡器问题。
- 修复了 MySQL 查询问题。
版本 2.3.0
2022 年 3 月 30 日
增强功能：
- 可排除 400、401、500 等 HTTP 错误码的监控，以减少监控环境中的噪声。
版本 2.2.1
2021 年 11 月 19 日
增强功能：
- Agent 现在可以捕获 HTTP 请求头。
版本 2.2.0
2021 年 10 月 1 日
增强功能：
- 用户可以将配置值设置为环境变量。
- 修复了"pg-query-stream"模块下的 PGSQL 查询未在"追踪"标签页中捕获的问题。
版本 2.1.0
2021 年 8 月 10 日
增强功能：
- 应用程序依赖详情现在打印到日志文件以供调试，而非通过连接请求发送。
- 当"instance_id"键的值为空时，不再在连接请求中发送该键。
问题修复：
- 修复了"异常"标签页中"最高错误码"和"按错误码划分的事务"数据缺失的问题。
版本 2.0
2021 年 6 月 24 日
安全修复：
- APM Agent 配置文件的读/写权限现在仅授予运行应用程序服务器的当前用户。
版本 1.8
2021 年 4 月 30 日
增强功能：
- Agent 现在可以捕获 HTTP 查询参数。
版本 1.7.2
2020 年 7 月 30 日
增强功能：
- 自定义参数可在"追踪"中跟踪和查看。
版本 1.7.1
2020 年 6 月 2 日
增强功能：
- Agent 已更新，以支持依赖包 https-proxy-agent 的最新版本（版本 5.0）。
版本 1.7.0
2020 年 5 月 7 日
增强功能：
- 支持 Oracle DB 监控
版本 1.6.0
2019 年 7 月 31 日
增强功能：
- 支持 MSSQL 监控
版本 1.5.0
2019 年 5 月 17 日
增强功能：
- 现在支持 ECMA 脚本监控
- 对于 Web 事务，可捕获入站字节数和出站字节数
版本 1.4
2019 年 3 月 12 日
增强功能：
- 可通过自定义检测 API 跟踪用户定义的类和方法以及已处理的错误。
- 支持监控后台事务。
- 支持应用程序参数。
版本 1.3.0
2018 年 1 月 8 日
增强功能：
- 支持 Node.js v10 监控
- 支持在 AWS 和 Azure 环境中部署的 Node.js 应用程序的自动扩展
- 支持使用 HTTP/2 构建的应用程序监控
版本 1.2.0
2018 年 10 月 24 日
增强功能：
- 支持 MySql2、ioredis 和 Mongoose。
- Agent 可自动检测并监控 Docker 环境。
版本 1.1
2018 年 8 月 24 日
增强功能：
- Agent 可监控和跟踪 Promise、Async/Await 调用
- 支持 Redis 和 Cassandra
版本 1.0
2018 年 7 月 18 日
功能：
Node.js Agent 支持的功能如下：
- 组件概览：查看与应用程序连接的外部组件，以及正在进行的请求数和失败的请求数。每个组件的响应时间也在此显示。
- Web 事务：显示所选时间段的事务及其最近追踪，包括错误事务、错误组件、响应时间和吞吐量，以及 HTTP 组件。
- 数据库操作：显示所有数据库操作及其调用次数和吞吐量时间。
- 追踪详情：显示事务摘要及其各组件和错误码。
- RUM 集成：将 Node.js 应用程序与 Site24x7 真实用户监控（RUM）集成，以获取实时数据，包括浏览器详情、JS 错误、Ajax 调用以及应用程序的区域性能。