Docs » Integrations Guide » Monitor Kubernetes » Kubernetes Quick Installation

Kubernetes Quick Installation 🔗

These instructions are to install the SignalFx Smart Agent on your Kubernetes cluster using helm. The Agent is pre-configured to auto-discover SignalFx-supported integrations which it monitors.

For instructions on installing Smart Agent for Kubernetes without using helm, see the Advanced Installation.

Smart Agent Quick Install for Kubernetes using Helm 🔗

Prerequisites are that you have installed and configured helm, and that tiller is running in your cluster.

If you need information on using helm, see https://helm.sh/docs/using_helm/. For a list of helm chart configuration options see the values.yaml file.

Step 1. The SignalFx helm chart can be installed in your helm chart with this command:

$ helm repo add signalfx https://dl.signalfx.com/helm-repo

Step 2. To ensure the latest state of the repository, run:

$ helm repo update

Step 3. Install the agent using the chart name signalfx/signalfx-agent. See below.

By default, the Smart Agent will send data to the us0 realm. If you are not in this realm, you will need to explicitly set the signalFxRealm option in the agent configuration. To determine if you are in a different realm, check your profile page in the SignalFx web application.

See the values.yaml file for more information on how to configure releases.

There are two required config options to run this chart: signalFxAccessToken and clusterName (if not overridding the agent config template and providing your own cluster name).

It is also recommended that you explicitly specify agentVersion when deploying a release so that the agent will not be unintentionally updated based on updates of the helm chart from the repo.

For example, a basic command line install setting these values would be:

$ helm install --set signalFxAccessToken=<YOUR_ACCESS_TOKEN> --set clusterName=<YOUR_CLUSTER_NAME> --set agentVersion=<VERSION_NUMBER> --set signalFxRealm=<YOUR_SIGNALFX_REALM> signalfx/signalfx-agent

If you want to provide your own agent configuration, you can do so with the agentConfig value. You can customize the provided config template using values.

If you are using OpenShift set kubernetesDistro to openshift to get OpenShift-specific functionality:

$ helm install --set signalFxAccessToken=<YOUR_ACCESS_TOKEN> --set clusterName=<YOUR_CLUSTER_NAME> --set agentVersion=<VERSION_NUMBER> --set signalFxRealm=<YOUR_SIGNALFX_REALM> signalfx/signalfx-agent --set kubernetesDistro=openshift

Your installation is complete.