Instana 代理程序发布说明

在线编辑

代理程序更新与 SaaS 及自托管 Instana 更新分开发布，并拥有独立的版本号。

有关代理的更多信息，请参阅主机代理。

代理程序引导与组装

在线编辑

代理程序引导程序提供了一组静态库，这些库作为代理程序程序集的一部分提供。 这些库是静态的，无法自动更新。 代理程序的组装也是静态的。 作为 Debian （RPM）软件包的一部分，还添加了 JVM 文件。

要更新代理程序引导程序和程序集，必须重新安装代理程序。 参见更新主机代理。

在代理程序组件发布后，所有后续的代理程序发布都会自动包含新的组件。

表 1. 特工组装发布
发布日期 代理启动版本 版本与变更
2026年5月14日 1.2.54
1.2.54Agent-Bootstrap 已更新为：
  • Netty 已更新为 4.1.133.Final.

sharedMaven 仓库配置已简化，仅使用 仓库 shared ，而非同时使用 shared 和 features-public，因为 features-public 已包含在 中。
2026年5月6日 不适用
Sigar 已更新以修复文件系统枚举过程中 AIX 发生的严重崩溃：
  • 修复了代理在扫描缺少 vmount 元数据字段的文件系统时可能出现的 问题 SIGSEGV 。
  • 在代理解引用本机指针之前，增加了对零 vmount 偏移量的验证。

J9 基于代理的系统已更新至 11.0.31.
2026年4月29日 1.2.53

基于祖鲁语的代理已更新至 11.0.31.

1.2.53Agent-Bootstrap 已更新为：
  • 已修复环境变量处理逻辑，现使用 INSTANA_AGENT_ENABLE_MONITOR 代替 ENABLE_AGENT_MONITOR。
Windows 代理卸载程序现可自动清理.NET 的跟踪配置：
  • LastKnownWASProcessId删除 Instana 专用的注册表项（CLRManagedLibsVersion 和）。
  • 如果这些环境变量引用了 Instana 的分析器，则删除.NET Core 的分析器环境变量（ CORECLR_ENABLE_PROFILING、 CORECLR_PROFILER、 CORECLR_PROFILER_PATH_32、 CORECLR_PROFILER_PATH_64 ）。
  • 从 DOTNET_STARTUP_HOOKS 环境变量中移除 Instana 的跟踪挂钩，同时保留其他启动挂钩。
2026年4月22日 不适用

pax-logging-* 已更新至 1.12.16 ，以缓解 CVE-2026-34478、 CVE-2026-34480 和 CVE-2026-34477 中的问题。

2.6.17.instana-3pax-url-aether 已更新为：
  • plexus-utils 已更新至 3.6.1 ，以缓解 CVE-2025-67030 问题。
2026年4月17日 不适用
Sigar 已更新以解决关键的内存管理问题：
  • 通过 SIGAR_CHEX 宏修复了原生内存泄漏问题。
  • 已解决 JNI 本地引用表耗尽的问题。
  • 修复了 Win32 的资源泄漏问题。
  • 改进了 Linux 在glibc 2.28 及更高版本上的构建兼容性。

trueINSTANA_AGENT_ENABLE_MONITOR 默认已启用（设置为）。

-Xshareclasses:none 已添加到启动选项中。
2026年4月8日 不适用 默认抖动配置已com.instana.agent.main.config.UpdateManager.cfg 从90分钟更新为180分钟±90分钟。
2026年4月1日 1.2.52
Agent-Bootstrap 已更新为 1.2.52
  • Netty 已更新为 4.1.132.Final.

commons-compress 已添加到 startup.properties.
2026年3月25日 1.2.51
1.2.51Agent-Bootstrap 已更新为：
  • Netty 已更新为 4.1.131.Final.
  • jackson-core 已更新为 2.21.1.
  • commons-io 已更新为 2.21.0.
  • commons-codec 已更新为 1.21.0.
  • commons-lang3 已更新为 3.20.0.
2026年4月13日 不适用

Instana 适用于物理隔离的 AIX 64 位系统的 agent AIX RPM 软件包现已可通过 Instana 用户界面获取。 如需了解更多信息，请参阅 《在物理隔离环境中安装主机代理》。
2026年3月3日 不适用 新增支持通过 Linux 内核权限机制，以非root用户身份运行代理程序。 如需了解更多信息， 请参阅 《以非 root 用户身份运行 Instana 代理（公开预览版）》。
2025年12月24日 1.2.50
1.2.50Agent-Bootstrap 已更新为：
  • Netty 已更新为 4.1.129.Final.
2025年12月9日 不适用

更新 felix fileinstall 至版本 3.7.5-INSTANA-2 ，以解决传感器快速启动和停止时导致磁盘和内存泄漏的竞争条件问题。 更多信息请参阅 FELIX-6812 和 apache/felix-dev#458。

更新 agent-diagnostic 至版本 1.0.7 以解决 CVE-2025-11226 问题。
2025年11月12日 1.2.49

基于Zulu的代理程序已更新至 11.0.29 版本，适用于 ppc64 系统。

更新 Agent-Bootstrap 至版本 1.2.49，新增通过环境变量 INSTANA_AGENT_UPDATES_VERSION 设置代理版本的功能。
2025年10月30日 不适用

基于Zulu的代理已更新至 11.0.29 ， ppc64 除外。

J9-based 代理程序已更新至 11.0.29 版本。
2025年9月25日 不适用 已将 Bouncy Castle 升级至新版本1.79 以修复 CVE-2025-8916 中的问题，并将其bctls-jdk18on 添加到支持netty.common:4.1.125.Final列表中，这解决了“未找到”BouncyCastleJsseProvider 的问题，并确保代理启动时能正确加载 Bouncy Castle JSSE。
2025年9月17日 1.2.48

打包了一个定制版的 Windows 服务封装器，以防止 Instana 代理服务被标记为病毒。

通过跳过对状态和停止命令的 TLS 检查来提升性能。

更新 Agent-Bootstrap 至版本 1.2.48，将升级 io.netty_netty-codec-http 至版本 4.1.125.Final 以解决 CVE-2025-58056 问题。
2025年9月11日 1.2.47 已更新Agent-Bootstrap 至新版1.2.47，该版本为 Kubernetes 的发现功能新增了环境变量控制。 将其设置INSTANA_FEATURE_DISCOVERY_KUBERNETES_ENABLED=true 为启用状态；否则，discovery-kubernetes 该功能将自动添加到排除列表中。
2025年9月3日 1.2.46

更新 Agent-Bootstrap 至版本 1.2.46，其中更新 jgit 至版本 5.13.5.202508271544-r 以解决 CVE-2025-4949 问题，并将 agent-gitops 更新至版本 1.1.11。

更新 pax-url-wrap 至版本 2.6.17.instana-2 以修复 commons-lang3 识别问题。
2025年8月27日 1.2.45

更新 Memory Calculator 至版本 1.2.14 ，采用GO语言开发 1.23.12。

更新 Agent-Bootstrap 至版本 1.2.45，重新打包了以下依赖项： commons-io/2.20.0.instana-1、 commons-codec/1.19.0.instana-1、 commons-compress/1.28.0.instana-1、 commons-csv/1.14.1.instana-1、、 commons-lang3/3.18.0.instana-1 （将版本标识符从 -instana 修正为 .instana），并将 commons-collections4 更新至版本 4.5.0。
2025年8月22日 1.2.44 已更新Agent-Bootstrap 至版本1.2.44，该版本将更新netty 至版本4.1.124.Final。
2025年8月20日

1.2.43

1.2.42

更新 Agent-Bootstrap 至版本 1.2.42 （仅限内部使用，未公开发布），该版本采用更新后的 commons-lang3 版本 3.18.0。

更新 Agent-Bootstrap 至版本 1.2.43，该版本使用重新打包的 commons-lang3 版本 3.18.0-instana-1。

重新 pax-url-wrap 打包 commons-lang3 3.18.0 并更新版本字符串为 2.6.17.instana-1。

有关存档的发布说明，请参阅 “代理程序初始化和组装 ”。

代理程序的计划更新

无论采用何种部署方式，代理程序引导组件均不会自动更新，必须通过重新安装代理程序手动更新。 若未定期手动更新，该代理程序可能导致部署问题。

下表提供了有关代理引导程序计划中的破坏性变更的信息，以帮助您规划手动更新并规避风险。 有关更多信息，请参阅代理引导程序。

表 2. 代理程序的计划更新
更新日期 描述 实施发布
2025年2月27日 服务网格旁路配置选项将于2025年3月起废弃，并在未来的 Instana 代理版本中移除。 请改用 Instana 原生服务网格支持，适用于 Istio 和 OpenShiftServiceMesh。 如需了解更多信息， 请参阅“支持的服务网格”。 2025年3月
2025年1月23日 不建议在 Kubernetes 和 Red Hat OpenShift 上使用静态 YAML 文件部署代理，因为这些文件已不再维护。 请改用其他受支持的部署方法，例如 Instana 操作符或 Helm 图表。 不适用
2024年9月13日
操作员安装与 Helm 图表部署
  • Kubernetes 和 Red Hat OpenShift 中的 Instana 代理操作员将与 Helm 图表部署程序一同静默安装。 当您运行 ` Helm ` 安装命令时，该命令会部署一个自定义资源类型（CRD）和一个自定义资源 ` YAML ` 文件，该文件会从 ` Helm ` 配置中获取配置信息。 此项过渡旨在将代理部署简化为单一流程，从而确保部署工作流更加集成且可定制。 此项变更还提供了更优的自动化、配置能力以及整体部署一致性。
领袖选举人的撤换
  • 过渡期结束后，您将无法继续使用旧的 kubernetes-sensor. 相反，你必须使用其新版本。 k8s-sensor 因此， 同样不可 leader-elector 用。 在即将发布的版本中，计划将 leader-elector 这些图像完全从注册表中移除。
 即将发布
2024年8月21日
特工组装切换至 Java 11
  • 当前版本的 Instana 代理支持 Java 8和 Java 11。 然而，在即将发布的版本中，新的 Instana 代理可能停止对 Java 8的支持，仅使用 Java 11来支持Karaf运行时更新。 此更改应用于代理引导层级。 现有代理不受此变更影响，因为这些代理的传感器代码与 Java 8兼容。 不过，建议您切换至 Java 11以避免潜在问题。
过渡阶段：
  • 第一阶段： HotSpot-based 代理程序过渡至 Java 11 - 代理程序组件随预打包的 HotSpot 发布，仅支持 JVM 中的 Java 11。 您必须使用 Java 11来处理这些代理程序组件。
  • 阶段 2：使用 Java 8 的新代理的监控问题 - 当您使用基于 Java 8 的 JVM 启动新的代理程序集时，会出现监控问题。 此监控问题将提醒您即将需要切换至 Java 11。 您可以在代理仪表板和事件菜单中的监控问题选项卡中找到此监控问题。
  • 第三阶段：更新至Karaf运行时环境 - 已完成Karaf运行时环境的更新。 此阶段之后发布的代理程序集不支持 Java 8。 您必须仅使用 Java 11。

第一阶段：2024年9月

第二阶段：2025年1月

特工套装

在线编辑

代理程序包为其他传感器的运行提供了基础。

表 3. 代理程序包发布
发布日期： 2026年5月22日 | 版本：1.2.65 | 变更标签： 2026.05.22.0659
捆绑更新
  • agent 1.1.775: 改进了网络接口检测功能。
  • agent-jvm-handling 1.0.46: 解决了 JVM 连接卡顿的问题。
  • agent-process-handling 1.0.49: 减少日志冗余。
  • agent-sensor 1.0.5: 增加了对自定义标签的支持。
  • agent-socket-server 1.0.14: 提高了连接管理的可靠性。
功能部件

在 configuration.yaml 中配置的自定义标签现已上报至后端，从而能够更好地组织和筛选受监控的实体。

现在，您可以通过环境变量 INSTANA_NETWORK_LOOKUP_INTERVAL_SECONDS 配置网络接口的检测间隔（最小为 10 秒），从而根据环境需求调整网络接口的检测频率。
修订

此前，当新连接取代等待中的连接时， JVM 连接可能会陷入停滞，从而导致无法正常进行性能监控。 现在，代理会正确关闭旧的待处理连接，以防止系统卡死。

此前，无论状态如何，系统都会返回所有网络接口，这可能会导致连接问题。 目前，该代理仅包含处于活动状态（UP）的网络接口。

此前，环境变量会被记录在进程 toString() 输出中，从而产生了过多的日志噪音。 现在，该代理仅在 toDebugString() 经过适当混淆的方法中包含环境变量。
发布日期： 2026年5月19日 | 版本：1.2.64 | 变更标签： 2026.05.19.1442
捆绑更新
  • 代理 1.1.774: 改进了配置文件监控功能，并增强了 JVM 的附件诊断功能。
  • agent-jvm-handling 1.0.45: 已针对 JVM 附件权限失败问题提交监控工单。
  • javaagent-loader 1.3.76: 修复了在 Java 1.6 上使用 IBM WebSphere 时加载器的启动问题。
功能部件

JVM 附件权限失败现在会生成一个专门的监控问题（jvm_attach_permission），以便简化诊断和故障排除。
修订
  • 此前，配置目录中损坏的符号链接会导致错误日志不断生成，并阻碍配置文件的处理。 现在，代理会优雅地跳过已断开的符号链接，并继续正常进行配置监控。
  • 此前，由于 MBean 服务器初始化过程中发生了未处理的异常，导致 javaagent-loader 无法在 Java 1.6 上启动，具体错误信息为 IBM WebSphere。 现在，加载器会在 MBean 服务器预加载期间处理所有异常，并成功继续启动。
内部更新

agent-util 1.0.21
发布日期： 2026年5月11日 | 版本：1.2.63 | 变更标签： 2026.05.11.1525
捆绑更新
  • agent 1.1.773: 改进了配置文件的更改检测功能。
  • agent-jvm-handling 1.0.44: 添加了可配置的 JVM 附件日志功能。
  • agent-process-handling 1.0.48: 扩展了 IBM i 的进程监控功能，并提升了容器检测性能。
功能部件

IBM i 系统现在除了能够检测 PASE 进程外，还能检测原生作业，从而支持对 IBM MQ 及其他原生工作负载的监控。

JVM 附件操作现在可以通过环境变量 INSTANA_JVM_ATTACHMENT_LOG_TO_STDOUT 将日志输出到标准输出（stdout），这有助于在容器化环境中进行故障排除。
修订

此前，由于 inotify 的限制， Kubernetes 环境中的配置文件更改可能会被忽略。 现在，该代理将基于事件的检测与轮询相结合，从而能够可靠地检测到配置更新。

此前， Podman 的容器 ID 检测在 cgroupv2 环境中会进行不必要的处理，从而导致 CPU 使用率上升。 目前，代理在 cgroupv2 环境中会跳过此操作，以提升性能。
内部更新
  • agent-cgroup 1.0.12
  • agent-runtime-api 1.0.18
  • agent-runtime 1.0.22
  • sensor-api 1.2.181
  • agent-json 1.2.181
  • netty 4.1.133.Final
发布日期： 2026年4月29日 | 版本：1.2.62 | 变更标签： 2026.04.29.0859
捆绑更新
  • 代理 1.1.772: 改进了 Kubernetes 环境中的唯一 ID 生成机制，增强了 AWS Fargate 的主机 ID 处理功能，并修复了 Windows 上日志文件重复显示的问题。
  • agent-backend 1.0.13: 添加了主动监控功能，用于检测后端连接变慢和消息队列卡顿的情况，并进行恢复。
  • agent-jvm-handling 1.0.43: 在 z/OS 系统上重新启用了对过期附加文件的清理功能。
  • agent-process-handling 1.0.47: 修复了容器进程识别中的竞争条件。
功能部件
  • OVN- Kubernetes 接口过滤功能通过将管理端口接口排除在唯一ID生成之外，从而防止跨集群的MAC地址冲突。
  • 当无法获取 MAC 地址时，自动激活代理 ID 持久化功能，确保在动态环境中代理识别的稳定性。
  • 后端连接健康状况监控可检测到响应缓慢的后端和卡住的消息队列，并自动进行恢复，以防止内存耗尽。
  • DNS 在 Kubernetes 环境中进行查找优化，可在设置了该 NODE_NAME 环境变量时，减轻 CoreDNS 的负载并提升启动性能。
修订
  • 此前，包含正斜杠的 AWS Fargate 任务 ARN 会导致日志下载失败，并返回 HTTP 400 错误。 现在，代理会对主机 ID 进行清理，以确保与 URL 兼容。
  • 此前，由于路径比较未进行标准化处理， Windows 系统会在用户界面中显示重复的日志文件。 现在，该代理会对路径进行规范化处理，并在 Windows 上进行不区分大小写的比较。
  • 此前，并发线程可能会将有效的容器进程 ID 覆盖为空值。 现在，通过正确的同步机制，可以避免在容器进程识别过程中出现竞争条件。
  • 此前，过期的附件文件会在 z/OS 系统上不断累积。 现在，清理机制会正确地删除过期的临时文件。
内部更新
  • agent-netty42-pki 1.0.1
  • agent-util 1.0.20
发布日期： 2026年4月16日 | 版本：1.2.61 | 变更标签： 2026.04.16.1110
捆绑更新
  • javaagent-loader 1.3.75: 增强了与 Elasticsearch 的兼容性，并改进了附加机制的配置。
  • agent-jvm-handling 1.0.42: 改进了 JVM 附件的清理操作、权限处理以及与instana-sudo的集成。
  • agent-process-handling 1.0.46: 增强了对 WebSphere 和 Liberty 选择性监控的 z/OS 支持。
  • agent-windows-extensions 1.3.82: 针对 .NET 增强了 IIS 重启检测功能，支持完整的框架监控。
功能部件
  • 通过字节码转换增加了对 Elasticsearch 授权系统的兼容性，使代理能够附加而不触发安全违规。
  • 在 z/OS 平台上，针对 WebSphere 和 Liberty 进程提供选择性监控支持。
  • 增强了针对 J9 和 OpenJ9 JVM 的附加机制。 现在，当代理使用 JDK ` tools.jar ` 时，会自动将堆大小调整为 128 MB。
修订
  • 此前，来自已终止进程的 .dll 孤立 .so 文件会积聚在 /tmp/.instana. 现在，清理操作会正确删除这些文件，包括 libprofsensor 库文件。
  • 此前，在非root模式下， J9 挂载目录清理操作会因“操作不被允许”错误而失败。 现在，诸如 CAP_FOWNER 和 CAP_DAC_OVERRIDE 之类的权限检查可确保清理操作仅在具备相应权限的情况下运行。
  • 此前，当 CLR 仪器化需要.NET 框架时 iisreset，IIS 工作进程无法被检测到。 现在，discovery-clr 传感器会在需要重置 IIS 时发出通知，并在用户界面中显示清晰的提示信息。
内部更新 agent-permission-api 1.0.2
发布日期： 2026年4月13日 | 版本：1.2.60 | 变更标签： 2026.04.13.1329
捆绑更新
  • 代理 1.1.771: 已添加 z/OS 专用的持久化路径，以确保代理 ID 在重启后保持稳定。
  • agent-configuration-integration-vault 1.0.19: 增强型密钥 Vault V2 配置验证，并针对前缀-密钥路径组合提供详细日志记录。
修订
  • 此前，在没有标准网络接口命令的环境中， z/OS 代理会在每次重启时生成一个新的唯一 ID。 此行为可能会干扰监控，并导致历史数据连续性中断。 代理现在将 ID 持久化存储/var/instana/instana-agent-id ，以便在重启后重复使用。
  • 此前，错误的键 Vault V2 前缀与键路径组合会导致注入 /data/ 错误，且没有明确提示。 该代理现在会记录有关配置问题的详细信息，以帮助您识别并修复配置错误。
发布日期： 2026年4月8日 | 版本：1.2.59 | 变更标签： 2026.03.11.1009
捆绑更新 此更新修改了第三方组件的内部引用，以便日后更轻松地进行升级。
功能部件 此版本不包含任何新功能。
修订 此版本未包含任何修复内容。
内部更新
  • 代理 1.1.770
  • agent-backend 1.0.12
  • agent-cgroup 1.0.11
  • agent-config-provider 1.0.2
  • agent-configuration-integration-vault 1.0.18
  • agent-cri-client 1.0.7
  • agent-grpc 1.0.20
  • agent-grpc-channel-cache 1.0.5
  • agent-http 1.0.8
  • agent-ibm-secrets-manager 1.0.3
  • agent-ibmi-handler 1.0.4
  • agent-internal-api 2.0.1
  • agent-jvm-handling 1.0.41
  • agent-open-telemetry-base 2.2.6
  • agent-open-telemetry-grpc 1.1.18
  • agent-open-telemetry-http 1.1.17
  • agent-open-telemetry-http-api 1.0.7
  • agent-open-telemetry-service 1.1.15
  • 代理进程处理 1.0.45
  • agent-prometheus 1.0.15
  • agent-runtime 1.0.21
  • agent-self-profiling 2.0.1
  • agent-sensor 1.0.4
  • agent-socket-server 1.0.13
  • agent-socket-server-api 1.0.9
  • agent-support-karaf 1.0.2
  • agent-task-orchestrator 1.0.10
  • agent-task-orchestrator-api 1.0.4
  • agent-util 1.0.19
  • commons-codec 1.21.0.instana-1
  • commons-io 2.21.0.instana-1
  • commons-lang3 3.20.0.instana-1
  • discovery-ibmiseries 1.0.82
  • discovery-power-hmc 1.0.22
  • discovery-websphere 1.1.53
  • jackson-annotations 2.21
  • jackson-core 2.21.1
  • jackson-databind 2.21.1
  • jackson-dataformat-yaml 2.21.1
  • jackson-datatype-jdk8 2.21.1
  • netty-buffer 4.1.132.Final
  • netty-codec 4.1.132.Final
  • netty-codec-dns 4.1.132.Final
  • netty-codec-http 4.1.132.Final
  • netty-codec-http2 4.1.132.Final
  • netty-codec-socks 4.1.132.Final
  • netty-common 4.1.132.Final
  • netty-handler 4.1.132.Final
  • netty-handler-proxy 4.1.132.Final
  • netty-resolver 4.1.132.Final
  • netty-resolver-dns 4.1.132.Final
  • netty-transport 4.1.132.Final
  • netty-transport-native-unix-common 4.1.132.Final
  • otel-sensorsdk-genai 1.0.4
  • sensor-ibmiseries 1.0.82
  • sensor-power-hmc 1.0.22
  • sensor-websphere 1.1.53
  • sensor-websphere-dmgr 1.1.53
  • snakeyaml 2.6
发布日期： 2026年3月25日 | 版本：1.2.58 | 变更标签： 2026.03.11.1232
捆绑更新
  • 代理 1.1.769: 改进了 IBM i 和 z/OS 平台上的流程生命周期管理。
  • agent-jvm-handling 1.0.40: 增强了 JVM 的发现功能，支持配置挂载目录并支持非根目录挂载。
  • agent-open-telemetry-grpc 1.1.17: 修复了 gRPC 端点对 TLS 的支持。 OTLP
  • agent-process-handling 1.0.44: 优化了容器进程的匹配机制，并为低效文件系统添加了重试机制。
  • agent-prometheus 1.0.14: 为 Prometheus 指标添加了 Snappy 解码器支持。
  • agent-socket-server 1.0.12: 修复了 gRPC OTLP 端点的 TLS 支持。
  • agent-windows-extensions 1.3.81: 改进了对 InstanaPCP 中因缺少性能计数器和配置无效而引发的错误处理。
功能部件
  • 可配置 JVM 发现功能的自定义挂载目录，以支持非标准临时目录位置。
  • 支持 Prometheus 指标的Snappy压缩解码器。
  • 监控因 HOME 目录配置缺失而引发的问题。
修订
  • 此前，在 IBM i 和 z/OS 系统上，已终止的进程会显示为仍在运行，并带有 [cmdline_absent] 标记。 现在，对于缺失的进程，系统会抛出正确的 SigarException 异常。
  • 此前， gRPC OTLP 端点（端口 4317）不支持 TLS 连接。 现在， TLS 已正确配置并可正常运行。
  • 此前，在速度较慢的 proc 文件系统上，容器的 PID 检测可能会失败。 现在，重试机制可以处理文件系统中的短暂延迟。
  • 此前，当缺少性能计数器或配置无效时， InstanaPCP 可能会退出。 现在， InstanaPCP 仍在运行，并已进行适当的错误处理。
内部更新
  • agent-netty42-pki 1.0.0
  • 代理权限 1.0.2
  • agent-permission-api 1.0.1
  • agent-runtime 1.0.20
  • agent-runtime-api 1.0.17
  • agent-socket-server-api 1.0.8

发布日期： 2026年3月11日 | 版本号：1.2.57 | 变更标签： 2026.03.11.1015
捆绑更新
  • 代理 1.1.768: 修复了容器化环境中的代理ID持久化路径。
  • agent-cgroup 1.0.10: 修复了 cri- containerd 环境中的 cgroup 解析问题。
  • agent-process-handling 1.0.43: 增强了容器运行时对静态链接和musl的支持。
  • agent-self-profiling 2.0.0: 基于 Java 飞行记录器的现代化性能分析工具。
功能部件
  • 现在，自我分析使用 Java Flight Recorder (JFR) 而不是 JVMTI，从而可以在 HotSpot, OpenJDK, OpenJ9 和 IBM Semeru JVM 上进行分析，而无需原生依赖项。
修订
  • 此前，由于动态库依赖关系，在旧版 Linux 发行版上无法获取 Podman 容器信息。 现在，静态链接确保了在所有 Linux 环境中的兼容性。
  • 此前，由于路径中存在多余的冒号，cgroup文件解析在cri- containerd 运行时环境中失败。 现在，解析功能已正确处理 cri- containerd 分隔符格式。
内部更新
  • 代理权限 1.0.1
  • agent-runtime 1.0.19
  • agent-runtime-api 1.0.16
  • agent-util 1.0.18

发布日期： 2026年3月3日 | 版本：1.2.56 | 变更标签： 2026.03.03.2113
捆绑更新
  • agent-process-handling 1.0.42: 改进了与 Windows 的兼容性，并优化了进程参数的处理。
  • agent-jvm-handling 1.0.39: 提高了套接字通信的可靠性。
功能部件
  • 此前，代理曾尝试在 Windows 系统上部署该 instana-sudo 二进制文件，导致权限错误。 现在，代理跳过了在 Windows 上部署二进制 instana-sudo 文件，因为 Windows 的操作不需要它。
  • 此前，在配置了代理的环境中，代理与受监控的 JVM 之间的套接字连接可能会失败。 现在，该代理会绕过代理设置，直接与 JVM 进行通信。
  • 此前，在运行 Windows 的系统上，如果进程命令行长度超过3,000个字符，代理会因 UTF-16 的截断问题而丢失所有进程参数。 现在，代理会清理并保留进程参数。 它将无效的 UTF-8 字节替换为替换字符（�）。
  • 此前，代理在 CRI-O 环境中可能无法检索容器元数据，导致选择性监控功能出现故障。 现在，代理已正确获取了容器的元数据。 在 CRI-O 环境中，选择性监控功能运行正常。

发布日期： 2026年3月2日 | 版本：1.2.55 | 变更标签： 2026.03.02.1407
捆绑更新
  • agent-permission 1.0.0: 全新的权限检查基础设施，具备 Linux 功能检测，支持非root操作。
  • agent-permission-api 1.0.0: 权限检查 API ，支持可组合谓词并提供详细的权限结果。
  • agent-jvm-handling 1.0.38: 针对 JVM 附件操作的集成权限检查。
  • agent-process-handling 1.0.41: 整合了容器操作的权限检查，并新增了对 instana-sudo 二进制文件的支持。
  • unix-socket-util 1.2.11: 在建立套接字连接前添加了预检权限检查，并支持缓存。
功能部件
  • 非root代理操作，具备全面的 Linux 功能检测与验证能力，包括在需要时通过instana-sudo二进制文件支持用户切换。
  • 一种权限检查系统，用于检测监控操作所需的权限（CAP_DAC_OVERRIDE, CAP_DAC_READ_SEARCH, CAP_KILL, CAP_SETUID CAP_SETGID, CAP_NET_ADMIN, CAP_NET_RAW, CAP_SYS_CHROOT, CAP_SYS_PTRACE,, 和 CAP_SYS_ADMIN）。
  • 在连接前对 Unix 套接字权限进行验证，并启用 1 分钟缓存，以防止连接失败并提供早期诊断反馈。
内部更新
  • agent-cgroup 1.0.9
  • agent-process-handling-api 1.0.8
  • agent-runtime 1.0.18
  • agent-runtime-api 1.0.15
  • agent-util 1.0.17

发布日期： 2026年2月26日 | 版本：1.2.54 | 变更标签： 2026.02.26.0814
捆绑更新
  • 代理 1.1.767: 添加了持久化代理 ID 功能，以确保在重启后仍能保持稳定的标识。
  • agent-jvm-handling 1.0.37: 提升了 IBM MQ 监控与 OpenJ9 JVM 之间的兼容性。
功能部件

如果启用了该 INSTANA_PERSIST_HOST_UNIQUE_ID 环境变量，代理 ID 现在可以在重启后保留。 此功能可在网络配置不断变化的动态环境（如容器和虚拟机）中保持代理身份的稳定性。
修订

此前，在 Windows 上监控 IBM MQ 进程时，由于 HotSpot 和 OpenJ9 之间尝试连接的 JVM 不兼容，导致不断弹出错误提示。 现在，代理已正确使用 来 MQ_JRE_PATH 将 IBM MQ 进程与 OpenJ9 JVM 关联。

发布日期： 2026年2月24日 | 版本：1.2.53 | 变更标签： 2026.02.24.1336
捆绑更新
  • agent-open-telemetry-service 1.1.14: 提升了 OpenTelemetry 的指标处理性能。
  • agent-jvm-handling 1.0.36: 修复了过期附件文件的清理问题。
修订
  • 此前， OpenTelemetry 的指标处理会触发多次 DNS 查询以解析主机名。 这种行为会导致性能下降，并在受限的网络环境中引发潜在故障。 现在，主机名解析使用缓存值，这消除了冗余的 DNS 查询，并提高了可靠性。
  • 此前，当代理程序附加过程中目标 JVM 进程终止时，应用程序工作目录中会积累过期的 .attach_pid 文件。 现在，即使进程意外终止，附件文件的清理功能也能正常运行，从而避免了文件的堆积。

发布日期： 2026年2月16日 | 版本：1.2.52 | 变更标签： 2026.02.16.0626
捆绑更新

agent-socket-server 1.0.11: 修复了因熵不足导致的代理启动卡死问题。
修订

此前，代理在启动时生成自签名证书的过程中，可能会因熵不足而卡住。 现在，该代理采用非阻塞 SecureRandom 实现来避免启动延迟。

发布日期： 2026年2月12日 | 版本：1.2.51 | 变更标签： 2026.02.12.0856
捆绑更新
  • agent-cgroup 1.0.8: 通过全面的 cgroup 文件跟踪和诊断信息，增强了数据收集功能。
  • agent-jvm-handling 1.0.35: 添加了唯一的内存标记，用于识别和过滤内部的 JVM 版本检查进程。
  • agent-sensor 1.0.3: 通过改进异步重置处理，修复了传感器数据收集中的阻塞问题。
  • agent-socket-server 1.0.10: 已为 TLS 端点添加了自动生成自签名证书的功能。
功能部件
  • Cgroup 支持数据现已包含进程到 Cgroup 的映射关系、文件存在清单、原始文件内容，以及针对 cgroup v1 和 v2 两个地址空间中 CPU、内存和块 I/O (blkio) 子系统的解析统计数据。 这些数据提供了用于排查容器资源管理问题的详细诊断信息。
  • TLS 当用户证书不可用时，终端会自动生成自签名证书。 此行为可防止明文响应，并确保连接安全。
修订
  • 此前，cgroup 的 ` v2 ` 内存解析功能在用户空间计算中错误地将内核内存计入其中，且总内存未包含所有用于内存不足（OOM）评估的组件。 现在，用户空间内存反映了应用程序的内存使用情况。 所有内存组件均已正确暴露，且“总内存”准确包含了用于评估 cgroup 内存不足（OOM）状况的所有内存。
  • 此前，代理传感器重置操作会阻断数据收集。 现在，将运行模式重置为异步模式，这可确保代理传感器能够始终不间断地提供数据。
  • 此前，代理程序内部的 JVM 版本检查进程在监控中显示为“未知”实体。 现在，该代理使用独特的内存标记（-Xms15728640 和 -Xmx15728640）来识别并自动过滤这些进程。
内部更新
  • 代理 1.1.766
  • agent-backend 1.0.11
  • agent-config-provider 1.0.1
  • agent-internal-api 2.0.0
  • agent-memory 1.0.2
  • agent-open-telemetry-grpc 1.1.16
  • agent-open-telemetry-http 1.1.16
  • 代理进程处理 1.0.40
  • agent-process-handling-api 1.0.7
  • agent-self-profiling 1.0.2
  • agent-socket-server-api 1.0.7
  • agent-task-orchestrator 1.0.9
  • agent-task-orchestrator-api 1.0.3
  • sensor-api 1.2.180
  • agent-json 1.2.180

发布日期： 2026年2月2日 | 版本号：1.2.50 | 变更标签： 2026.02.02.1438
捆绑更新
  • agent-jvm-handling 1.3.73: 新增对 Java 26 的支持，并改进了 z/OS Liberty 的进程发现功能。
  • agent-process-handling 1.0.39: 改进的选择性监控，支持父进程继承。
功能部件
  • Java 通过更新instrumentation-shared（ 1.0.148 ）和instrumentation-boot（ 1.1.33 ）依赖项，支持在最新 Java 版本上运行的应用程序的监控。
  • 在 z/OS 平台的 CICS 区域中，为 WebSphere Liberty 实施进程发现，以提升大型机可见性。
  • 父进程继承机制在 OPT_IN 和 OPT_OUT 模式下的选择性监控中，确保了跨进程层次结构的行为一致性。
修订
  • 修复了插件配置顺序不一致的问题，以确保行为可预测。
  • JVM 发现功能现已在后台线程中异步运行，避免了代理启动阻塞。
内部更新
  • 代理 1.1.765
  • 传感器API 1.2.178

发布日期： 2026年1月19日 | 版本号：1.2.49 | 变更标签： 2026.01.19.1539
捆绑更新
  • agent-jvm-handling 1.0.33: 改进了 JVM 的版本检测和附加逻辑。
  • agent-netty-allocator 1.0.4: 针对 Netty 通道的内存管理优化。
  • agent-process-handling 1.0.38: 改进进程监控及 Windows 性能计数器的处理。
功能部件

JVM 早于 1.6 的版本将自动排除在监控之外，从而提升代理程序的启动性能。
修订
  • 修复了在非英语版 Windows 系统上， InstanaPCP 因未正确计算翻译后性能计数器名称的缓冲区大小而导致的崩溃问题。
  • 修复了对命令行空白的容器进程监控错误；代理现可正确识别成功读取操作，仅在必要时创建进程进行监控。
  • 通过为 WeakReferenceNetty 通道清理实现修复了潜在内存泄漏问题。

发布日期： 2025年12月18日 | 版本号：1.2.48 | 变更标签： 2025.12.18.0819
捆绑更新
  • agent-jvm-handling 1.0.32: 改进了对被忽略的 Java 进程和 JVM 附加的处理。
  • agent-ibmi-handler 1.0.3: 添加一个 API ，用于从连接访问 AS400 对象。
  • 代理 1.1.764: 增强了自定义日志路径的日志文件发现功能。
功能部件
  • Agent UI 可发现并显示来自自定义路径的日志，这些路径在配置中设置，旨在 org.ops4j.pax.logging.cfg 增强对存储在非标准位置的应用程序日志的可见性。
  • IBM i 传感器可直接从 AS400Connection 实例访问 AS400 对象，从而更高效地与 IBM i 系统集成。
修订
  • 修复了忽略 Java 进程时 hsperfdata 文件删除错误的问题；代理现在停止监控时不再删除附加文件。
  • 修复了将转换进程误识别为JVM的问题，该问题导致向非 Java 进程发送SIGQUIT信号。 配置 INSTANA_JVM_HANDLING_REQUIRE_ATTACH_FILES=true 为仅附加到具有有效附加文件的JVM（默认禁用）。
  • 更新了 Netty 从 4.1.125.Final 到 4.1.129.Final 以解决安全漏洞 CVE-2025-67735。
内部更新
  • thirdparty-netty 4.1.129.Final
  • 代理进程处理 1.0.37
  • 传感器API 1.2.177

发布日期： 2025年12月11日 | 版本号：1.2.47 | 变更标签： 2025.12.11.0930
捆绑更新
  • agent-open-telemetry-grpc 1.1.15: 新增对可配置的传统 OTLP 协议端口 gRPC 的支持。
  • javaagent-loader 1.3.72: 在代理升级期间防止类加载错误。
  • agent-jvm-handling 1.0.31: 改进 JVM 附件兼容性。
  • agent-process-handling 1.0.36: 增强进程监控稳定性并实现机密信息屏蔽。
功能部件
  • 可配置的传统 OTLPgRPC 端口(55680)通过 INSTANA_AGENT_OTEL_GRPC_LEGACY_PORT_ENABLED 环境变量或配置文件。 操作员根据部署需求控制端口使用。
    • 默认值：对于早于 1.310.0 的代理版本，默认为true
    • 默认值：对于代理版本 1.310.0 及更高版本，默认值为false
  • 作为替代方案，您还可以在 com.instana.plugin.opentelemetry -> grpc -> legacy_port_enabledconfiguration.yaml 中启用旧版端口。

有关更多信息，请参阅旧版 OTLP 的 gRPC 端口。
修订
  • 修复了代理重启期间进程启动时间变化导致的虚假服务警报问题；现在代理更新和重启期间启动时间保持稳定。
  • 修复了运行时删除JAR NoClassDefFoundError 文件 javaagent-loader 导致的故障，通过在启动时固定加载器类实现。
  • 修复了错误排除具有自定义类加载器的JVM的问题（例如 WebLogic'sLaunchClassLoader）；代理现在仅排除不受支持的SAS自定义类加载器。
  • 修复了使用CRI客户端时Containerd容器环境变量中机密泄露的问题；代理现已在所有容器配置位置正确屏蔽机密。
内部更新
  • InstanaPCP 1.3.79
  • 代理 1.1.763
  • agent-runtime 1.0.17
  • agent-runtime-api 1.0.14

有关存档的发布说明，请参阅 “代理程序包 ”。

Agent Helm Chart

在线编辑

Instana 代理程序 Helm 的图表更新与 Instana SaaS, 的自托管版本及代理程序更新分开发布。

有关代理 Helm 图表的更多信息，请参阅代理 Helm 图表的源代码库 ： Instana。

表 4. Helm 专辑发行
发行版本 发布日期 代理运营商版本 功能和修订 更多信息
2.0.44 2026年5月11日

2.2.12

2.2.11

通过添加缺失 POD_NAMESPACE 的环境变量，并将 RBAC 权限从集群范围转换为命名空间范围，修复了在自定义命名空间中进行部署时的领导者选举问题。

已将运算符更新为 v2.2.12:
  • 修复了在显式禁用“ k8sensor ”时， k8sensor 状态异常的问题。
已将运算符更新为 v2.2.11:
  • 多个 Go 库以及与 Kubernetes 相关的依赖项已更新。
  • 已在代理 Pod 中添加了该 NODE_NAME 环境变量。
  • 通过使用命名空间范围的缓存，优化了控制器内存占用。
 变更日志
2.0.43 2026年4月14日 2.2.10

多个 Go 库以及与 Kubernetes 相关的依赖项已更新。

Go 已更新至 v1.26.2。

Helm 已更新至 v4.1.4。

gRPC 已更新至 v1.80.0 ，以解决 CVE-2026-33186 的问题。

已为 K3setcd 指标添加了文档。

已将 k8sensor 的安全上下文恢复为之前的设置。

 变更日志
2.0.42 2026年4月10日 2.2.9

整理并优化了 RBAC 配置。

允许 k8sensor 读取 discovery.k8s.io 资源。

为新代理安装添加了 INSTANA_PERSIST_HOST_UNIQUE_ID 环境变量。

多个 Go 库及其依赖项已更新，包括 Go 1.26.1。

 变更日志
2.0.41 2026年2月26日 2.2.8

更新了多个 Go 库及其依赖项。

将 Go 更新为 v1.26.0。

重构了管道。

使用了最新的 <codeph>ubi9</codeph> 镜像。

 变更日志
2.0.40 2026年2月20日 2.2.7

k8sensork8s_sensor.featureFlags.crdMonitoring 的CRD监控功能标志已被弃用。 系统忽略此标志的值。

控制器-管理器容忍支持现已通过标志 controllerManager.pod.tolerations 添加。

 变更日志
2.0.39 2026年1月27日 2.2.7

更新了多个 Go 库及其依赖项。

将 Helm 库更新至 v4。

已弃用的CRD监控及所有 Kubernetes 功能标志。

修复文档中的代理配置示例。

 变更日志
2.0.38 2026年1月12日 2.2.5

更新了多个 Go 库及其依赖项。

修复因缺少 OpenShift ETCD 资源导致的 k8sensor 容器故障。

通过该k8s_sensor.featureFlags.crdMonitoring. Expose liveness probes 标志添加了k8sensor CRD 监控功能。

通过标志 agent.pod.livenessProbe 暴露在代理和 agentRemote 控制台上的活动探针。

 变更日志
2.0.37 2025年12月9日 2.2.4 扩展样本配置。 多个 Go 库及其依赖项已更新，包括： Go1.25.5 修复 ETCD 客户端证书。 变更日志
2.0.36 2025年11月10日 2.2.3 k8sensor 的可配置轮询速率。 多个 Go 库及其依赖项已更新。 强化所有者引用处理。 变更日志
2.0.35 2025年10月30日

2.2.2

2.2.1

 修复对 k8s_sensor.deployment.enabled 设置的错误处理。 实施安全的 TLS 和令牌认证。 新增对ETCD和 RestClient 配置的支持。 变更日志
2.0.34 2025年10月16日 2.2.0

Helm、 Go、 v1.25.3 及其他 Go 依赖项的更新。

移除了代理容器 /var/lib 中的挂载点。

 变更日志
2.0.33 2025年10月7日

2.1.36

2.1.35

已实现用于敏感信息的隐秘存储机制。

依赖项更新已应用。

 变更日志
2.0.32 2025年9月2日 2.1.34 Go 1.25.0 更新及多个依赖项更新。 变更日志

如需查看历史版本说明，请参阅 Agent Helm 图表。

Agent Operator

在线编辑

代理操作员更新与 Instana 后端及代理更新分开发布。

表 5. 特工操作员释放
发行版本 发布日期 功能和修订 更多信息
2.2.12 2026年5月7日

修复了在显式禁用时 k8sensor 的状态异常。

已将 e2e 的部署就绪状态在测试中设为“稳定”。

 变更日志
2.2.11 2026年5月5日

多个 Go 库以及与 Kubernetes 相关的依赖项已更新。

已在代理 pod 中添加了 NODE_NAME 环境变量。

通过命名空间范围的缓存优化了控制器内存消耗。

 变更日志
2.2.10 2026年4月14日

多个 Go 库以及与 Kubernetes 相关的依赖项已更新。

Go 已更新至 v1.26.2。

Helm 已更新至 v4.1.4。

gRPC 已更新至 v1.80.0 ，以解决 CVE-2026-33186 的问题。

已为 K3setcd 指标添加了文档。

已将 k8sensor 的安全上下文恢复为之前的设置。

 变更日志
2.2.9 2026年3月19日

多个 Go 库以及与 Kubernetes 相关的依赖项已更新。

Go 已更新至 v1.26.1。

控制器运行时已更新至 v0.23.3。

Helm 已更新至 v4.1.3。

移除了不再需要的基于角色的访问控制（RBAC）权限。

通过为新部署添加环境变量 INSTANA_PERSIST_HOST_UNIQUE_ID 并挂载 /var/lib/instana 卷，实现了代理 ID 在 Pod 重启时的持久化。 在升级过程中，操作员保留现有的代理ID。

新增了对资源 discovery.k8s.io 读取的支持。

 变更日志
2.2.8 2026年3月3日

多个 Go 库及其依赖项已更新。

Go 已更新至 v1.26.0。

Helm 已更新至 v4.1.1。

Kubernetes 软件包已更新至 v0.35.1。

重构并优化了管道。

使用最新 ubi9 图像。

已添加代理部署与调度文档。

 变更日志
2.2.7 2026年1月26日

多个 Go 库及依赖项已更新。

Helm 库更新至 v4。

CRD监控及所有 Kubernetes 功能标志已弃用。

 变更日志
2.2.6 2026年1月12日

多个 Go 库及依赖项已更新。

通过标志将ACRD监控功能扩展至 k8sensork8s_sensor.featureFlags.crdMonitoring。

通过标志暴露在代理和 agentRemote 控制台上的活动探针 agent.pod.livenessProbe

 变更日志
2.2.5 2026年1月5日

多个 Go 库及依赖项已更新。

修复了因缺少 k8sensorOpenShiftETCD 资源导致的pod故障。

向 ` k8sensor ` 添加了 ` ClusterRole ` 权限，以允许 CRD 监控。

 变更日志
2.2.4 2025年12月9日

多个 Go 库及依赖项已更新。

更新了扩展配置中的缺失值。

修复了ETCD客户端证书问题。

更改了ETCD指标端口。

CI注册表变更。

 变更日志
2.2.3 2025年11月6日

多个 Go 库及其依赖项已更新。

CR的强化所有者引用处理。

将远程 DNSPolicy 代理调整为 DNSClusterFirstWithHostNet。

修复了启用多个 useSecretMounts=true 后端时的处理逻辑。

支持 k8sensor 配置投票频率。

 变更日志
2.2.2 2025年10月27日

多个 Go 库及其依赖项已更新。

添加 instanaagent 和 instanaagents 作为代理CR的简短名称。

修复了 k8sensor 部署中 value enabled 的使用方式。

 变更日志
2.2.1 2025年10月21日 已为k8sensor 控制平面指标实施了安全的 TLS 和基于令牌的身份验证。 变更日志
2.2.0 2025年10月16日

多个 Go 库及依赖项已更新。

从代理容器中移除了 /var/lib 挂载点。

 变更日志
2.1.41 2026年3月27日

Go 已更新至 v1.26.1。

多个 Go 库及其依赖项已更新。

gRPC 已更新至 v1.79.3 ，以解决 CVE-2026-33186 的问题。

管道修复与改进。

 变更日志
2.1.40 2026年3月6日

Go 已更新至 v1.26.0。

多个 Go 库及其依赖项已更新。

管道修复与改进。

 变更日志
2.1.39 2026年1月30日 管道修复与改进。 变更日志

有关存档的发布说明，请参阅 “代理操作员 ”。

代理杂项

在线编辑

查看不属于特定功能类别的 Instana 代理功能的更新、增强和变更。

2026年5月20日

在线编辑

修复了容器化静态代理的容器环境变量处理问题

此版本修复了容器化静态代理中对 INSTANA_AGENT_PROXY_PORT 环境变量的错误处理。

2026年5月13日

在线编辑

优化动态代理 Maven 配置

Maven 存储库配置的动态代理设置已得到简化。 该 shared 仓库现已成为默认仓库。 配置存储库 features 现在是可选的。

2026年4月29日

在线编辑

改进 DEB 和 RPM 包的安装程序日志记录

DEB 和 RPM 包现在会在安装过程中尝试用环境变量值替换代理配置文件中的占位符时记录日志。

2026年4月22日

在线编辑

容器化代理的容器环境变量

容器化代理现在支持额外的环境变量，用于在 文件中 /opt/instana/agent/etc/instana/com.instana.agent.main.config.Agent.cfg 配置设置。

下表列出了所有 com.instana.agent.main.config.Agent.cfg 可通过容器环境变量配置的设置：

表 6. 用于 Agent.cfg 设置的容器环境变量
Agent.cfg 设置 容器环境变量
backchannel.enabled INSTANA_AGENT_BACKCHANNEL_ENABLED
http.listen INSTANA_AGENT_HTTP_LISTEN
http.threads INSTANA_AGENT_HTTP_THREADS
mode INSTANA_AGENT_MODE
mode.web-override.allowed INSTANA_AGENT_MODE_WEB_OVERRIDE_ALLOWED
scheduler.threads INSTANA_AGENT_SCHEDULER_THREADS
source.download.enabled INSTANA_AGENT_SOURCE_DOWNLOAD_ENABLED
uniqueAgentId INSTANA_AGENT_UNIQUE_AGENT_ID
use-cloud-provider-id INSTANA_AGENT_USE_CLOUD_PROVIDER_ID
注意： INSTANA_AGENT_HTTP_LISTEN 和 INSTANA_AGENT_MODE 环境变量在之前的版本中已存在。 此更新在保持向后兼容性的同时，增加了对剩余配置设置的支持。

如需了解更多信息，请参阅 “容器化代理的环境变量” 和“代理配置文件设置”。