IBM Support

How to configure Instana Kubernetes Agent Environment Variables when deployed via Helm chart version 1.x

How To


Summary

How to configure Instana Agent Environment Variables in a Kubernetes or OpenShift environment when deployed via Helm chart version 1.x.
NOTE: This will not work when the agent is deployed via Helm chart version 2.x

Steps

1. You will be able to see a list of the available environment variables for a host agent here
www.ibm.com/docs/en/instana-observability/current?topic=references-environment-variables

2. Access the Kubernetes cluster and make a backup of the current DaemonSet

Example:

kubectl get ds instana-agent -n instana-agent -o yaml > instana-agent_ds_backup.txt

3. Update the DaemonSet with the correct environment variable

Example:

kubectl edit ds instana-agent -n instana-agent

4. Here is an example configuration where the host agent version is pinned to a specific version using the environment variable name: INSTANA_AGENT_UPDATES_VERSION:

image-20240421125116-1

5. Ensure the variable being added is correctly indented and save the file.

NOTE: The instana agent does not have to be restarted for the environment variable configuration to take effect

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSE1JP5","label":"IBM Instana Observability"},"ARM Category":[{"code":"a8m3p000000UoUGAA0","label":"Agent"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Product Synonym

Instana; Observability

Document Information

Modified date:
10 February 2025

UID

ibm17148931