Documentation forSolarWinds Observability

Add a Kubernetes cluster

To monitor your Kubernetes cluster and associated services with SolarWinds Observability, integrate SolarWinds Observability with your Kubernetes account.

  1. Ensure your Kubernetes environment is set up and supported by SolarWinds Observability. See Getting started with Kubernetes and system requirements for details.
  2. In SolarWinds Observability, click Add Data in the upper-right corner.
  3. In the Add Data dialog, click Kubernetes.

  4. In the Add Kubernetes dialog, enter a cluster name. Check Use a custom Cluster ID and enter the name in the field provided, or skip this step to create it automatically.

    If you currently use AWS or Azure APIs for monitoring, use your Cluster ID provided by AWS or Azure to prevent cluster duplication in SolarWinds Observability. See View cluster status and details to find the Cluster ID for AWS. See Cluster URL and ID to find the Cluster ID for Azure.

  5. Enter the Prometheus URL in the provided field. The Prometheus URL defines how Kubernetes will access a running Prometheus server. See Prometheus configuration for Kubernetes.

    If you want to install Prometheus on your Kubernetes cluster, see Prometheus Operator.

  6. Enter the Kubernetes namespace in the provided field. The Kubernetes namespace is where the swi-k8s-opentelemetry-collector agent will be deployed. See SWI k8s OpenTelemetry collector for more information.

  7. Create or select an API ingestion token to use when sending your collected Kubernetes cluster data by doing either of the following:

    • Select Generate New Token and enter an Ingestion Token Name, then click Next.
    • Select Use Existing Token and select an ingestion token from the list, then click Next.
  8. Run the provided command to create a secret within the kubectl command line tool. See Managing Secrets using kubectl.
  9. Create a file named manifest.yaml to save the provided configuration content.
  10. Run the provided command to deploy the newly created manifest file to your environment. Click Next.
  11. Wait for the Kubernetes cluster and metrics to generate, or click Skip Verification. You can now view your Kubernetes clusters in the Entity Explorer.
  12. When you complete the configuration, SolarWinds Observability displays data collected for the Host entity. See Entity Explorer for details.

See SolarWinds Observability introduction for an overview of Host entities and how they work in SolarWinds Observability.