Release notes for Instana agent Helm chart

Instana agent Helm chart updates are released separately from the Instana SaaS, self-hosted, and agent updates. For more information about the agent Helm chart, see the Instana agent Helm chart source repository.

2.0.26

Instana agent Helm chart 2.0.26 is released on 8 July 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Operator version 2.1.28. This release adds an option to define Kubernetes environment variables in the agent.pod.env property of the agent custom resource. This notation replaces the previous string map notation in agent.env, but both notations are functional. This feature enables the mapping of Kubernetes secrets or other properties to environment variables that are exposed to the agent pod, and can be used by sensors.

2.0.25

Instana agent Helm chart 2.0.25 is released on 26 June 2025.

Features and Fixes

The following features and fixes are added in this release:

  • This release adds a script to convert existing configmaps of Helm chart version 1 deployments into custom-values.yaml for Helm chart version 2 deployments.
  • Operator version 2.1.27. Go is updated to version 1.24.4.

2.0.24

Instana agent Helm chart 2.0.24 is released on 12 June 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Custom resource settings to allow custom sizing for large clusters is added to the operator deployment.

2.0.23

Instana agent Helm chart 2.0.23 is released on 11 June 2025.

Features and Fixes

The following features and fixes are added in this release:

  • The rendering logic for node selectors in the agent custom resource is now fixed.

2.0.22

Instana agent Helm chart 2.0.22 is released on 3 June 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Operator version 2.1.26. The operator permissions are adjusted to control the PodDisruptionBudgets of Kubernetes sensor deployments.

2.0.21

Instana agent Helm chart 2.0.21 is released on 27 May 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Removed duplicate label app.kubernetes.io/name: instana-agent-operator on the instana-agent-controller-manager deployment.
  • Operator version 2.1.25. Prerequisites are added to allow selective monitoring on the namespace level in the operator.

2.0.20

Instana agent Helm chart 2.0.20 is released on 12 May 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Operator version 2.1.24. Dependency updates are applied.

2.0.19

Instana agent Helm chart 2.0.19 is released on 29 April 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Operator version 2.1.23. Previously, if you removed any additional backend other than the last one in the list of backends in the agent custom resource, the k8sensor deployment configuration was desynchronized. This issue is now fixed.

2.0.18

Instana agent Helm chart 2.0.18 is released on 22 April 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Operator version 2.1.22. Previously, pods were restarted and re-created because of the differences in environment variable ordering during the reconcile process. This issue is now fixed.

2.0.17

Instana agent Helm chart 2.0.17 is released on 10 April 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Previously, after you updated the Helm chart to version 2.0.13, any Helm installation that did not explicitly set the agent.proxyPort setting rendered a null value in the agent CR. This issue is now fixed by adding a null check before rendering the value.

2.0.16

Instana agent Helm chart 2.0.16 is released on 31 March 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Operator version 2.1.21. nodes/proxy is added to ClusterRoles to fetch kubelet information.
  • Outdated tech-preview files are removed.

2.0.15

Instana agent Helm chart 2.0.15 is released on 10 March 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Previously, after you updated the Helm chart to version 2.0.14, any subsequent Helm upgrades to apply changes to the agent configuration YAML file or other Helm settings failed. This issue occurred because the immutable fields were changed during the upgrade and the Kubernetes API rejected those changes. This issue is now fixed.

2.0.14

Instana agent Helm chart 2.0.14 is released on 4 March 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Operator version 2.1.20. The operator can now handle missing credentials for HTTP proxy settings in the k8sensor.
  • The Helm chart now supports overwriting the operator image by using controllerManager.image.name, controllerManager.image.tag and controllerManager.image.digest. This feature is required to deploy the agent in air-gapped environments that mirror the images to internal registries.
  • You can now deploy the Helm chart to a different namespace than "instana-agent" by specifying the namespace during the installation.

2.0.13

Instana agent Helm chart 2.0.13 is released on 25 February 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Previously, when you defined a custom HTTP proxy port as a Helm flag, the Instana agent custom resource failed the validation and therefore the agent failed to install. This is because the custom resource definition (CRD) that validated the custom resource required the ports to be string type, while the ports were considered as integer in the custom resource. This issue is fixed, and the agent custom resource now correctly handles integer port values as strings.

2.0.12

Instana agent Helm chart 2.0.12 is released on 18 February 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Operator version 2.1.19. The Helm chart now deploys the operator on Kubernetes by using a single replica to reduce resource consumption.

2.0.11

Instana agent Helm chart 2.0.11 is released on 13 February 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Update operator to v2.1.18.

    • The logic to specify when to render configuration-opentelemetry.yaml and enable opentelemetry opt-out is modified.
    • The default k8sensor poll rate is increased to 10 seconds.

2.0.10

Instana agent Helm chart 2.0.10 is released on 6 February 2025.

Features and Fixes

The following features and fixes are added in this release:

  • Operator version 2.1.16.

    • ClusterRole/ClusterRoleBinding is added to instana-agent service account to enable Prometheus sensor in Kubernetes.

  • Operator version 2.1.15.

    • The deployment controller-manager and RBAC manager-role and manager-rolebinding are changed to instana-agent-controller-manager, instana-agent-clusterrole and instana-agent-clusterrolebinding.

2.0.9

Instana agent Helm chart 2.0.9 is released on 15 Januar 2025.

Features and Fixes

The following features and fixes are added in this release:

  • The rendering of the agent zones are fixed.

2.0.8

Instana agent Helm chart 2.0.8 is released on 14 January 2025.

Features and Fixes

The following features and fixes are added in this release:

  • The option to define custom volumes and volumeMounts for the agent pod is added.

2.0.7

Instana agent Helm chart 2.0.7 is released on 14 January 2025.

Features and Fixes

The following features and fixes are added in this release:

  • The handling of OpenTelemetry settings when spec.opentelemetry.grpc.enabled or spec.opentelemetry.http.enabled are set to false is fixed.
  • The operator is updated to version 2.1.13.

2.0.6

Instana agent Helm chart 2.0.6 is released on 13 January 2025.

Features and Fixes

The following features and fixes are added in this release:

  • The flags for the agent repository mirror configuration are renamed.

2.0.5

Instana agent Helm chart 2.0.5 is released on 8 January 2025.

Features and Fixes

The following features and fixes are added in this release:

  • New flags are added for the agent repository mirror configuration.

2.0.4

Instana agent Helm chart 2.0.4 is released on 20 November 2024.

Features and Fixes

The following features and fixes are added in this release:

  • Operator version 2.1.10. Roles for node metrics and stats for Kubernetes sensor are added.

2.0.3

Instana agent Helm chart 2.0.3 is released on 18 November 2024.

Features and Fixes

The following features and fixes are added in this release:

  • The Kubernetes sensor deployment rendering issue is now fixed.

2.0.2

Instana agent Helm chart 2.0.2 is released on 14 November 2024.

Features and Fixes

The following features and fixes are added in this release:

  • Hardening for endpointPort and configuration parsing is implemented.

2.0.1

Instana agent Helm chart 2.0.1 is released on 13 November 2024.

Features and Fixes

The following features and fixes are added in this release:

  • The rendering of spec.agent.env, spec.configuration_yaml, and spec.agent.image.pullSecrets is fixed.

2.0.0

Instana agent Helm chart 2.0.0 is released on 12 November 2024.

Features and Fixes

The following features and fixes are added in this release:

  • The helm chart now deploys the instana-agent operator instead of managing agent artifacts directly.
  • BREAKING CHANGE: Because of the limitations with Helm in managing Custom Resource Definition (CRD) updates, you must apply the CRDs from the Helm chart CRDs folder manually during this upgrade.

1.2.74

Instana agent Helm chart 1.2.74 is released on 25 October 2024.

Features and Fixes

The following features and fixes are added in this release:

  • OTLP is now enabled by default.

1.2.73

Instana agent Helm chart 1.2.73 is released on 1 July 2024.

Features and Fixes

The following features and fixes are added in this release:

  • The label for io.instana/zone to reflect the real agent mode is fixed.
  • The charts flag is changed from ENABLE_AGENT_SOCKET to serviceMesh.enabled.
  • The DirectoryOrCreate is added to DaemonSet definitions to make sure that required directories exist.

1.2.72

Instana agent Helm chart 1.2.72 is released on 15 April 2024.

Features and Fixes

The following features and fixes are added in this release:

  • A new field, minReadySeconds, is added to agent DaemonSet YAML.

1.2.71

Instana agent Helm chart 1.2.71 is released on 11 March 2024.

Features and Fixes

The following features and fixes are added in this release:

  • The usage of digest for pulling images is fixed.

1.2.70

Instana agent Helm chart 1.2.70 is released on 5 March 2024.

Features and Fixes

The following features and fixes are added in this release:

  • The configuration of minReadySeconds is now allowed for the agent DaemonSet and deployment.

1.2.69

Instana agent Helm chart 1.2.69 is released on 22 February 2024.

Features and Fixes

The following features and fixes are added in this release:

  • You can now set annotations for the serviceAccount.

1.2.68

Instana agent Helm chart 1.2.68 is released on 20 February 2024.

Features and Fixes

The following features and fixes are added in this release:

  • The leader-elector configuration is added back for proper deprecation.

1.2.67

Instana agent Helm chart 1.2.67 is released on 22 January 2024.

Features and Fixes

The following features and fixes are added in this release:

  • A variable name in the Kubernetes deployment is fixed.

1.2.66

Instana agent Helm chart 1.2.66 is released on 30 November 2023.

Features and Fixes

The following features and fixes are added in this release:

  • The the default memory requests is aligned to 768Mi for the agent container.

1.2.65

Instana agent Helm chart 1.2.65 is released on 13 October 2023.

Features and Fixes

The following features and fixes are added in this release:

  • This update ensures the Instana deployment of Kubernetes sensor has the appropriate Security Context Constraints (SCC).

1.2.64

Instana agent Helm chart 1.2.64 is released on 13 October 2023.

Features and Fixes

The following features and fixes are added in this release:

  • The agent does not require specific RBAC entries when disabling the Kubernetes sensor.
  • The settings override for k8s-sensor affinity is added.
  • Optional pod disruption budget for k8s-sensor is added.

1.2.63

Instana agent Helm chart 1.2.63 is released on 20 September 2023.

Features and Fixes

The following features and fixes are added in this release:

  • RBAC that is required to grant access to metrics end-points is added.

1.2.62

Instana agent Helm chart 1.2.62 is released on 29 August 2023.

Features and Fixes

The following features and fixes are added in this release:

  • The k8s-sensor resources are included in the default static YAML definitions.

1.2.61

Instana agent Helm chart 1.2.61 is released on 19 July 2023.

Features and Fixes

The following features and fixes are added in this release:

  • The timeout and initialDelay for the agent container is increased.
  • OTLP ports are added to headless service.

1.2.60

Instana agent Helm chart 1.2.60 is released on 14 June 2023.

Features and Fixes

The following features and fixes are added in this release:

  • The k8s_sensor is enabled by default.