Installing the Instana agent on Kubernetes
Install the Instana agent on Kubernetes in an online or offline (air-gapped) environment. See the following sections to learn about the steps involved in the agent installation and configuration on Kubernetes:
Prerequisites
Before you install the Instana agent on Kubernetes, make sure to meet the conditions that are explained in Checking the prerequisites.
Installing the agent
-
In an offline (air-gapped) environment, you must install the agent with the Kubernetes package manager Helm. To continue, see Installing the agent in an air-gapped environment. You can also install the agent in an air-gapped environment by using an operator. For more information, see Installing an agent using an operator in an air-gapped environment.
-
In an online environment, to use all available configuration options, you can install the agent by using the following methods:
-
Static YAML file (not suggested)
For more information about installation, see Installing the agent.
What to do next
-
Check whether the agent works as described in Checking the status of the agent. If the agent is not started, start the agent as described in Starting the agent.
When you install the agent, it is configured to start automatically at system boot. To turn off this behavior, set the environment variable
INSTANA_AGENT_AUTOSTART=false
when you install the agent. -
After you install the agent, configure Instana agent sensors to monitor specific technologies. For the list of supported sensors, see Agent sensors.
Most Instana agent sensors are automatically installed, and some sensors are also automatically configured after the agent is installed. But for the other sensors, you need to configure them first to make them operational.
-
If you have problems when you install the agent, see Potential problems during installation.
-
You can do installation-related activities on the agent such as to customize the agent configuration or update the agent. For more information, see Administering the agent on Kubernetes.
-
You can uninstall the agent if it's not needed. For more information, see Uninstalling the agent on Kubernetes.
-
You can upgrade the Instana agent when new versions are released. For more information, see Updating the agent.