Agent bundle releases

The Agent Bundle provides the base for other sensors to run.

Agent 1.2.5

Agent 1.2.5 released on 23 September 2024 with the tag 2024.09.23.1452.

This agent release updates the following bundles:

  • agent 1.1.734: Fix order of configuration services on agent startup for process and secret handling.

Fixes

This release fixes the following issues:

  • Previously, the agent marked a process as not running after an update of the agent feature. This was because the configuration service that is used to determine whether a process must be ignored is not ready at startup time. This is now fixed and the agent awaits the configuration service before deciding whether a process is ignored.

Agent 1.2.4

Agent 1.2.4 released on 18 September 2024 with the tag 2024.09.18.1243.

This agent release updates the following bundles:

  • agent 1.1.733: Fix for docker command.
  • agent JVM handling 1.0.0: Optimizes the check for sending the jvm_instrumentation_shared_absent monitoring issue.

Fixes

This release fixes the following issues:

  • Previously, the agent failed to run a docker exec command with a user switch. This was because the agent added the -u flag after containerId, which is invalid. This issue was noticed in the Agent 1.2.3 release. This issue is now fixed.
  • Previously, the agent created a jvm_instrumentation_shared_absent monitoring issue when a JVM was absent or when the connection to the JVM was already closed. This issue is now fixed and the agent creates the jvm_instrumentation_shared_absent monitoring issue when the JVM is still active.

Agent 1.2.3

Agent 1.2.3 released on 16 September 2024 with the tag 2024.09.16.1150.

This agent release adds the following bundles:

  • agent JVM handling 1.0.0: This bundle contains the logic to collect and handle JVM attachments.
  • agent JVM handling API 1.0.0: This bundle contains callback listeners for the agent when a JVM connection is established or removed.

This agent release updates the following bundles:

  • agent 1.1.732: Ignores restart requests on the first minute. Removed the JVM handling from the main bundle.
  • agent runtime API 1.0.2: Added the OperatingSystemProbe to check for the OS on which the agent runs.
  • agent runtime 1.0.2: Added the implementation of the OperatingSystemProbe.
  • agent internal API 1.0.10: Added interfaces to the APIs that are used by the JVM handling but are provided by the agent core bundle.
  • agent util 1.0.3: Added InstanaStringUtils that offers methods to search within a string.

Fixes

This release fixes the following issues:

  • Previously, the agent became unresponsive if multiple restart requests were raised at the same time. This issue is now fixed and the agent ignores incoming restart requests in the first minute.
  • Previously, the agent did not check whether the instrumentation-shared files exist. If the files were absent, the java-tracer did not start and a NoSuchFileException was added to the logs. This issue is now fixed and the agent checks if the instrumentation-shared file is present. The agent also creates a monitoring issue with the name jvm_instrumentation_shared_absent if the instrumentation-shared is absent.
  • Previously, the agent generated multiple logs when an update occurred while the agent was forwarding logs to the backend. This issue is now fixed and logs are not created when the agent is updated.

Agent 1.2.2

Agent 1.2.2 released on 5 September 2024 with the tag 2024.09.05.1355.

This agent release updates the following bundles:

  • agent 1.1.731: The main agent bundle. Optimizes Inventory handling.
  • agent util 1.0.2: Added SafeWriter helper that catches write exceptions. Added <empty-secret-obfuscated-by-instana> when empty secrets are replaced.

Features

This agent release adds the following features:

  • The agent now collects the configurations that are shared with a sensor at startup time or as part of a configuration update. This data can be retrieved by clicking on the Collect Support Information button in the agent dashboard.
  • The agent now supports JDK-based attachments along with Byte Buddy-based attachments. You can specify to use JDK-based attachments by setting the environment variable INSTANA_JVM_BYTEBUDDY_ATTACHMENT_ENABLED as false.

Fixes

This release fixes the following issue:

  • Previously, the agent created a new string when comparing the inventory as part of the discovery check. This issue is now fixed and new strings are not created anymore.

Agent 1.2.1

Agent 1.2.1 released on 28 August 2024 with the tag 2024.08.28.1029.

This agent release adds the following bundles:

  • agent 1.1.730: The main agent bundle
  • agent config provider 1.0.0: Provides the main configuration of the agent that reflects in the com.instana.agent.main.config.Agent.cfg file
  • agent secret reader 1.0.0: Provides access to the vault configuration integration to other sensors. This bundle also implements the logic to expose a service through an existing interface, which is present in the sensor API

This agent release updates the following bundles:

  • agent internal API 1.0.9: Added the ConfigurationService service, which is exposed to other bundles of the agent
  • agent optional API 1.0.7: Updated methods to break the circular dependency
  • agent runtime API 1.0.1: Added the AgentPID and LinuxPaths services that hold the internal PID of the agent
  • agent runtime 1.0.1: Added the implemtation of the AgentPID and LinuxPaths services
  • agent util 1.0.1: Add OversizedByteArray helper for cases where the special reader is not available

Fixes

This release fixes the following issue:

  • Previously, the vault configuration integration failed to start and became unusable when the agent bundle was updated after the vault was started. This issue is now fixed, and the vault configuration integration works after an update.

Agent 1.2.0

Agent 1.2.0 released on 22 August 2024 with the tag 2024.08.22.1426.

Bundle split

This release splits the agent bundle into multiple bundles. The splitting of bundles reduces the duration of agent downtimes during an update and ensures that the components that are not updated are run without interruption. This agent release contains the following bundles:

  • agent 1.1.729: The main agent bundle
  • agent backend API 1.0.0: Services required for other agent bundles for backend connection
  • agent backend 1.0.0: The implementation of the backend connection
  • agent backend util 1.0.0: Utility bundle for backend-related components
  • agent internal API 1.0.8: Services required for other bundles that are provided by the agent bundle
  • agent Jaeger tracer 1.0.0: The Jaeger Tracer component
  • agent memory API 1.0.0: Services required for other bundles for memory access
  • agent memory 1.0.0: Implementation of the memory access
  • agent runtime API 1.0.0: Services required for other bundles of the agent that allow access to the runtime-related data
  • agent runtime 1.0.0: Implementation of the runtime-related data
  • agent self profiling 1.0.0: Self-profiling capability of the agent
  • agent socket server API 1.0.0: Services required for other bundles of the agent for the main agent socket server 42699. Mainly holds counter related information.
  • agent socket server 1.0.0: The implementation of the main agent socket server that runs on port 42699
  • agent task orchestrator API 1.0.0: Services required for other bundles for task orchestration
  • agent task orchestrator 1.0.0: The implementation for the task orchestration. Holds the Scheduler and Executor services.
  • agent util 1.0.0: Helper bundle with static helpers that are not part of any API
  • agent Zipkin tracer 1.0.0: The Zipkin Tracer component

Features

This agent release adds the following features:

  • Java Instrumentation now supports Java 23.
  • The agent now supports a special environment variable INSTANA_BIND_ALL_INTERFACES. If this environment variable is set to true, the agent binds to all interfaces and announces the interfaces when the agent monitors Java workloads. This feature is required when the container uses Macvlan.
  • The agent now tracks aborted requests on the 42699 endpoint for internal monitoring.

Fixes

This release fixes the following issues:

  • Previously, an internal service of the agent would be absent if a temporary directory on the host was corrupted. Now, the agent catches this exception and the internal service remains intact.
  • Previously, the agent would time out on the java -version check after 5 seconds. This timeout is now increased to 10 seconds.

Agent 1.1.728

Agent 1.1.728 released on 5 August 2024 with the tag 2024.08.05.1210.

Features

This agent release adds the following feature:

  • The agent now runs on AS400/IBM i OS.

Fixes

This release fixes the following issues:

  • Previously, the agent showed the agent-bundle version on the / path. This issue is now fixed, and the agent now displays the agent version.
  • Previously, the agent ignored connections from JVMs if they were marked as unstable. These markings did not timeout. The timeout for the markings is now fixed, and the potential unstable connections are retried again after 5 minutes of the timeout.

Agent 1.1.727

Agent 1.1.727 released on 17 July 2024 with the tag 2024.07.17.1321.

Features

This agent release adds the following feature:

  • An internal API is added to the host agent that enables the sensors to request for the process environment configuration that is already in discovery.

Fixes

This release fixes the following issue:

  • Previously, J9-based JVMs were excluded from the new attachment that was added with Agent 1.1.721 because these JVMs required the stat command, which was not available on AIX. This issue is now fixed and the JVMs are included in the new attachment because the stat command is replaced with the istat command.

Agent 1.1.726

Agent 1.1.726 released on 02 July 2024 with the tag 2024.07.02.0715.

Fixes

This release fixes the following issues:

  • Previously, the Host Agent added a dedicated Thread Pool for discovery requests. An edge case was identified when the Agent was receiving too many discovery requests on startup. In that case, the Host Agent might not handle any other Request and failed to respond to health checks. This overload might lead to restarts on Kubernetes. This issue is now fixed and the Host Agent is no longer restarted.
  • On Solaris, the Host Agent checks if the <java-home>/jvm/jre/lib/sparcv9/jspawnhelper is executable. Now, the Host Agent notifies the user with a Monitoring event.
  • Previously, the Host Agent showed the command that is used on the java -version process in an error case. As this command can display secrets, the used command is no longer shown.

Changes

Agent 1.1.725

Agent 1.1.725 released on 20 June 2024 with the tag 2024.06.20.1531.

Fixes

This release fixes the following issue:

  • Previously, the Host Agent verified incoming data on the connection and closed it if no traffic was observed within 600 seconds. An edge case was identified when the Agent loses connection to the Instana backend every 30 seconds. Closing the connection led to extra load within the JVM. This issue is now fixed and the Host Agent now checks the incoming data at 200, 400, and 600 seconds. If no data reaches the agent for 600 seconds, the connection is marked as unstable and closed.

Agent 1.1.724

Agent 1.1.724 released on 20 June 2024 with the tag 2024.06.20.1115.

Fixes

This release fixes the following issues:

  • Previously, the Host Agent ignored a process after reading the content in /proc/<pid>/<something> had a timeout. The default timeout was 5 seconds, which got triggered mistakenly in Host Agents running on overloaded hosts. In such cases, the Agent mistakenly ignored the process and did not retry it. This issue is now fixed, and the Host Agent handles potentially broken processes with a staged approach. The Host Agent now supports multiple stages for a process. Successful reading of process data resets the counter. The list of the ignored processes is reset every 10 minutes.
  • Previously, in some cases within the Host Agent, the flow expected a connection to be removed to run a full reattachment. This reattachment is only possible if the connection is removed and is not added back within a timeout of 20 seconds. This issue is now fixed, and the connection between the Host Agent and JVM is now removed, if the connection is marked as closed.
  • Previously, a regression with J9 based JVMs occured that required the stat command, which was not available on AIX. This issue is now fixed and now the JVMs that run on AIX are excluded from the new attachment that is added with Agent 1.1.721. The new attachment is enabled again when stat command is replaced with istat command.

Agent 1.1.723

Agent 1.1.723 released on 13 June 2024 with the tag 2024.06.13.0459.

Fixes

This release fixes the following issues:

  • An environment variable CONTAINERD_SUPPRESS_DEPRECATION_WARNINGS with the value true is added to the ctr exec operations. This environment variable is to exclude deprecation warnings that might interfere with parsers in the Agent.
  • The evaluation of a process and the PID that reaches the 42699 port of the Agent is delayed. Computation is completed when the field is requested in code. When you make computation optional, the Agent executes other important tasks.

Agent 1.1.722

Released on 27 May 2024.

Fixes

This release fixes the following issues:

  • Process with Arguments on Windows were ignored if they contained characters outside of the UTF-8 area.
  • The Javaagent Loader inside a JVM leaks on Exit Hooks for file references of the Agent when the attachment works, but the communication to the Agent failed afterward
  • When the agent attaches to a JVM, the Agent places files in <TMPDIR>/.instana with read and execute permissions and excludes the write permission for everyone.
  • The Agent now parses the output of docker info when Docker is available to save the location of the Docker Root Dir. This information is used to correctly identify Docker containerIds.

Agent 1.1.721

Released on 27 May 2024.

Fixes

This release fixes the following issues:

  • Better logging when java -version fails. The log now contains the command and the output that failed to be parsed.
  • JVM attachments now always use the attach-tools-<version>.jar, which is placed in <TMPDIR>/.instana to allow attachments against JREs and 32-bit JVMs on Windows.
  • The Agent monitors the Metaspace and issues a restart if the available space is under 10 MB for over 30 minutes. This restart reduces the risk of an OutOfMemoryError:Metaspace.

Agent 1.1.720

Released on 02 May 2024.

Fixes

This release fixes the following issue:

  • JVM monitoring: Ignore SAP NetWeaver classes to mitigate class loading issues.

Agent 1.1.719

Released on 02 May 2024.

Fixes

This release fixes the following issues:

  • JVM monitoring: Support for Virtual Threads.
  • Reduction in Memory by deduplicating Strings on internal tasks.
  • Vault is available to other Sensors by an internal Service.