Release notes for Instana agent bootstrap

The agent bootstrap provides a set of static libraries that are provided as part of the agent assembly. These libraries are static and cannot get updated. The agent assembly is also static. As part of the Debian or RPM package, a JVM is also added.

Note: The agent bootstrap does not update itself regardless of the deployment method. To update the agent bootstrap, you must reinstall the agent.

Agent assembly 27 August 2025

Included in all agents that are released after 27 August 2025.

  • Memory Calculator is updated to 1.2.14 with GO 1.23.12.
  • Agent-Bootstrap is updated to 1.2.45:
    • Repackaged dependencies:
    • 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 (fixed version identifier from -instana to .instana)
    • Updated dependency:
    • commons-collections4/4.5.0

Agent assembly 22 August 2025

Included in all agents that are released after 22 August 2025.

  • Agent-Bootstrap is updated to 1.2.44:
    • netty is updated to 4.1.124.Final.

Agent assembly 20 August 2025

Included in all agents that are released after 20 August 2025.

  • Agent-Bootstrap is updated to 1.2.42 (internal only, not released):
    • Uses updated commons-lang3 version 3.18.0.
  • Agent-Bootstrap is updated to 1.2.43:
    • Uses repackaged commons-lang3 version 3.18.0-instana-1.
  • pax-url-wrap is repackaged with commons-lang3 3.18.0.
    • Version string is updated to 2.6.17.instana-1.

Agent assembly 13 August 2025

Included in all agents that are released after 13 August 2025.

  • Agent-Bootstrap is updated to 1.2.41:
    • Mitigates CVE-2025-4949 by updating jgit to 5.13.4.202507202350-r.
    • agent-gitops is updated to 1.1.10.
  • The startup order of org.apache.felix.fileinstall is changed to start after org.apache.karaf.features.core:
    • This change avoids a boot-time race condition where FileInstall might truncate and temporarily empty a configuration file during rewriting, leading the Karaf features service to read an empty or partial configuration file.
    • By ensuring org.apache.karaf.features.core starts first, the features service reads its configuration before FileInstall has a chance to rewrites it, eliminating the race condition and preventing startup failures.

Agent assembly 28 July 2025

Included in all agents that are released after 28 July 2025.

  • The Hotspot and J9 variants of the agent are updated to 11.0.28.

Agent assembly 2 July 2025

Included in all agents that are released after 2 July 2025.

  • The Windows service startup type is set to Manual, when auto-start is disabled by using the installation argument INSTANA_SERVICE_MODE=manual.

Agent assembly 26 June 2025

Included in all agents that are released after 26 June 2025.

  • pax-logging-* is downgraded to version 1.11.15 due to issues with the interactive shell in version 1.12.12.
  • Scripts are updated to extend support for Java 17 and Java 21.
  • The following additional startup options are added:
    • --add-opens=jdk.internal.jvmstat/sun.jvmstat.monitor=ALL-UNNAMED
    • --add-opens=jdk.internal.jvmstat/sun.jvmstat.perfdata.monitor=ALL-UNNAMED
    • --add-opens=jdk.internal.jvmstat/sun.jvmstat.perfdata.monitor.protocol.local=ALL-UNNAMED
    • --add-opens=jdk.internal.jvmstat/sun.jvmstat.perfdata.monitor.v2_0=ALL-UNNAMED
    • --add-exports=java.base/sun.net.www.protocol.file=ALL-UNNAMED
    • --add-exports=java.base/sun.net.www.content.text=ALL-UNNAMED
    • --add-exports=java.rmi/sun.rmi.registry=ALL-UNNAMED
    • --add-exports=java.security.sasl/com.sun.security.sasl=ALL-UNNAMED
    • --add-exports=java.naming/com.sun.jndi.ldap=ALL-UNNAMED
  • RPM packages now remove the file /etc/init.d/instana-agent on SUSE Linux if systemd is present during install and upgrade.

Agent assembly 25 June 2025

Included in all agents that are released after 25 June 2025.

  • AIX RPM packages are now available.

Agent assembly 18 June 2025

Included in all agents that are released after 18 June 2025.

  • pax-url-aether is updated to 2.6.17.
  • Memory Calculator is updated to 1.2.13 with GO 1.23.10.

Agent assembly 23 May 2025

Included in all agents that are released after 23 May 2025.

  • J9 variant of the agent is updated to 11.0.27.
  • Agent-Bootstrap is updated to 1.2.40.
  • Handling for ENABLE_AGENT_MONITOR environment variable is extended to include a liveness probe of the agent (default=false). The liveness probe checks internally if the agent bundles are in running state. If the bundles are not running after 360 seconds, the probe initiates a restart.
  • Longer timeouts are added to the org.ops4j.pax.url.mvn.cfg file:
    • org.ops4j.pax.url.mvn.socket.readTimeout=60000
    • org.ops4j.pax.url.mvn.socket.connectionTimeout=60000

Agent assembly 7 May 2025

Included in all agents that are released after 7 May 2025.

  • Logging pattern is updated to include method name if available.
  • Memory Calculator is updated to 1.2.12 with GO 1.23.9.
  • --add-opens=java.base/sun.nio.fs=ALL-UNNAMED is added to startup options.

Agent assembly 30 April 2025

Included in all agents that are released after 30 April 2025.

  • Sigar is updated to 1.6.5.132-6-INSTANA-13 to mitigate a Divide By Zero exception on Windows due to Hyperthreading flag.

Agent assembly 24 April 2025

Included in all agents that are released after 24 April 2025.

  • Hotspot variant of the agent is updated to 11.0.27.

Agent assembly 19 March 2025

Included in all agents that are released after 19 March 2025.

  • pax-url-aether is updated to 2.6.16.
  • pax-logging-* is updated to 1.12.12.

Agent assembly 3 March 2025

Included in all agents that are released after 3 March 2025.

  • --add-opens java.management/sun.management=ALL-UNNAMED is added to startup options.
  • Memory detection is skipped on systems that do not have a /proc directory.
  • Agent-Bootstrap is updated to 1.2.39.
  • Handling is added for ENABLE_AGENT_MONITOR environment variable that checks if the agent is stuck (default=false).

Agent assembly 19 February 2025

Included in all agents that are released after 19 February 2025.

  • J9 variant of the agent is updated to 11.0.26.

Agent assembly 13 February 2025

Included in all agents that are released after 13 February 2025.

  • Agent-Bootstrap skips version 1.2.37 and is directly updated to 1.2.38.
  • commons-codec is updated to 1.18.0.
  • commons-collections4 is updated to 2.18.0.
  • commons-csv is updated to 1.13.0.
  • commons-lang3 is updated to 3.17.0.
  • jackson is updated to 2.18.2.
  • jackson-datatype-jdk8 is added in version 2.18.2.
  • snakeyaml is updated to 2.3.
  • Netty is updated to 4.1.118.Final.

Agent assembly 27 November 2024

Included in all agents that are released after 27 November 2024.

  • Agent-Bootstrap is updated to 1.2.36.
  • netty-resolver-dns is rolled back to 4.1.107.Final to avoid the issues with comments after a nameserver entry in /etc/resolv.conf.conf with 4.1.115.Final.

Agent assembly 20 November 2024

Included in all agents that are released after 20 November 2024.

  • Agent-Bootstrap is updated to 1.2.35.
  • Netty is updated to 4.1.115.Final.

Agent assembly 21 May 2024

Included in all agents that are released after 21 May 2024.

  • Updated Bouncycastle from 1.77 to 1.78.1

Agent assembly 04 April 2024

Included in all agents that are released after 04 April 2024.

  • Updated Agent-Bootstrap to 1.2.34
  • Rollback netty-resolver-dns to 4.1.107.Final due to problems on z/OS with 4.1.108.Final

Agent assembly 02 April 2024

Included in all agents that are released after 02 April 2024.

  • Updated Agent-Bootstrap to 1.2.33
  • Netty is updated to 4.1.108.Final.

Agent assembly 25 March 2024

Included in all agents that are released after 25 March 2024.

  • Updated Agent-Bootstrap to 1.2.32
  • Updated Jgit to 5.13.3.202401111512-r to mitigate CVE-2023-4759