Introduction to the Kubernetes integration

New Relic's Kubernetes integration gives you full observability into the health and performance of your environment, no matter whether you run Kubernetes on-premises or in the cloud. With our cluster explorer, you can cut through layers of complexity to see how your cluster is performing, from the heights of the control plane down to applications running on a single pod.

New Relic One - Kubernetes Cluster Explorer > Kubernetes cluster explorer: The cluster explorer is our powerful, fully visual answer to the challenges associated with running Kubernetes at a large scale.

You can see the power of the Kubernetes integration in the cluster explorer, where the full picture of a cluster is made available on a single screen: nodes and pods are visualized according to their health and performance, with pending and alerting nodes in the innermost circles. Predefined alert conditions help you troubleshoot issues right from the start. Clicking each node reveals its status and how each app is performing.

Get started: Install the Kubernetes integration

We have an automated installer to help you with many types of installations: servers, virtual machines, and unprivileged environments. It can also help you with installations in managed services or platforms, but you'll need to review a few preliminary notes before getting started.

Here's what the automated installer does:

  1. Asks for the cluster name and namespace of the integration.
  2. Asks for additional setup options, such as Kube state metrics.
  3. Asks for the installation method: manifest file or Helm.
  4. Generates either the manifest or Helm chart.

If your New Relic account is in the EU region, access the automated installer from

Why it matters

Governing the complexity of Kubernetes can be challenging; there's so much going on at any given moment, with containers being created and deleted in a matter of minutes, applications crashing, and resources being consumed unexpectedly. Our integration helps you navigate Kubernetes abstractions across on-premises, cloud, and hybrid deployments.

In New Relic, you can build your own charts and query all your Kubernetes data, which our integration collects by instrumenting the container orchestration layer. This gives you additional insight into nodes, namespaces, deployments, replica sets, pods, and containers.

New Relic One - Kubernetes dashboard > Dashboards: Using the chart builder you can turn any query on Kubernetes data to clear visuals.

With the Kubernetes integration you can also:

These features are in addition to the data New Relic already reports for containerized processes running on instrumented hosts.

The Kubernetes events integration, which is installed separately, watches for events happening in your Kubernetes clusters and sends those events to New Relic. Events data is then visualized in the cluster explorer. To set it up, check the Kubernetes events box in step 3 of our install wizard, or follow the instructions.

New Relic One - Kubernetes Events > Kubernetes cluster explorer > Events: Browse and filter all your Kubernetes events, and dig into application logs and infrastructure data.

Bring your cluster logs to New Relic

Our Kubernetes plugin for log monitoring can collect all your cluster's logs and send them to our platform, so that you can set up new alerts and charts. To set it up, check the Log data box in step 3 of our install wizard, or follow the instructions.

Check the source code

This integration is open source software. That means you can browse its source code and send improvements, or you can create your own fork and build it. For more information, see the README.

For more help

If you need more help, check out these support and learning resources: