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.
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.
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.
(Optional) Recommended alert policies and dashboards
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:
Go to one.newrelic.com > Integrations & Agents.
Select Dashboards to access the pre-built resources.
Search Kubernetes and select the dashboard you want to add.
Click Edit if you want to change the account in the popup window that opens.
Click Setup Kubernetes or Skip this step if you already setup this integration.
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.
Choose your next step
Configure control plane monitoring
Learn how to monitor and collect metrics from your cluster's control plane components.
Explore your Kubernetes cluster
Learn how to interpret the data displayed in the different Kubernetes curated UIs, viewing the status of your cluster, identifying entities, accessing the cluster dashboard, and searching for Kubernetes events, and more
Find and use your Kubernetes data
See how to use queries, charts, dashboards, alerts, and more.
Kubernetes plugin for log forwarding
Learn how to collect, process, explore, query, and alert on your log data. Our Kubernetes plugin simplifies sending logs from your cluster to New Relic logs.