Install the Kubernetes integration

New Relic's Kubernetes integration gives you full observability into the health and performance of your infrastructure. With this agent you can collect telemetry data from your cluster using several New Relic integrations such as the Kubernetes events integration, the Prometheus agent, the nri-kubernetes, and the New Relic Logs Kubernetes plugin.

Screenshot showing the Overview dashboard

Go to one.newrelic.com > All capabilities > Kubernetes. Select your cluster and click Overview Dashboard in the left navigation pane. See Explore your Kubernetes cluster for more info.

Important

If you're going to install the New Relic Kubernetes integration on Windows or EKS Fargate, see the Install Kubernetes on Windows and Install Kubernetes on AWS EKS Fargate documents.

Follow these steps to install the New Relic Kubernetes integration.

Before you begin

  • You need a New Relic . You can set up a free account, no credit card required.

  • Be sure you're using a supported Kubernetes version and distribution, check out the compatibility and requirements page. You'll also find specific requirements for Helm and Manifest.

Specific requirements

Depending on where you store your clusters, there are different integration specifications:

Choose your instrumentation method

Install

Depending on your instrumentation method, your installation instructions will change. Select an option to fill in the information.

Find and use data

Once you've finished all the steps, you can test the connection to make sure everything is working properly and view your data.

Testing Kubernetes installation

Tip

Not seeing data? If you completed the steps and are still not seeing data, check out this troubleshooting page.

After the installation, you should see the following in the UI:

  • newrelic-nrk8s-ksm pod.
  • newrelic-nrk8s-kubelet pod for each node in your cluster.
  • newrelic-nrk8s-control-plane pod for each master node in your cluster, if any.
  • newrelic-kube-state-metrics pod, if you included KSM with our installation.
  • newrelic-nri-kube-events pod, if you enabled Kubernetes events reporting.
  • prometheus-agent pod, if you enabled the Prometheus agent integration.
  • newrelic-newrelic-logging pod for each node in your cluster, if you enabled the logging integration.

After deploying this integration, you can add:

  • A default set of recommended alerts conditions and dashboards that you can add to your account. These conditions are grouped into these policies:

    • Kubernetes: To add the default set of recommended alert conditions and a dashboard.
    • Google Kubernetes Engine: To add the default set of recommended Google Kubernetes engine alert conditions and a dashboard.

    Once added, you can customize the alert conditions to meet your needs. See Recommended alert policies for more information about managing them.

  • Pre-built dasboards. Follow these steps to add pre-defined dashboards:

    1. Go to one.newrelic.com > Integrations & Agents.

    2. Select Dashboards to access the pre-built resources.

    3. Search Kubernetes and select the dashboard you want to add.

      Add Kubernetes dashboards
    4. Click Edit if you want to change the account in the popup window that opens.

    5. Click Setup Kubernetes or Skip this step if you already setup this integration.

    6. Click View dashboard, and see your Kubernetes data in New Relic.

    For more on creating dasboards, see our Create custom data visualizations with dashboards doc.