• /
  • Log in
  • Free account

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

one.newrelic.com > 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.

You'll be able to configure Kubernetes to suit your environnment after you create a New Relic account (it's free, forever!) and install our Kubernetes integration.

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.

Our automated installer will generate either a helm command or a set of plain manifests for you to install. Our automated installer:

  1. Allows users to select the cluster name and namespace for the installation.
  2. Allows users to selectively enable or disable bundling of Kube-state-metrics, a dependency of the Kubernetes integration.
  3. Allows users to seamlessly install our other products related to Kubernetes such as:
  • Kubernetes events monitoring
  • In-cluster prometheus services monitoring
  • Service instrumentation without code changes using Pixie
  1. Automatically fills the required properties with the license keys the integration needs to work.
Read the install docs
Start the installer


If your New Relic account is in the EU region, access the automated installer from one.eu.newrelic.com.

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

one.newrelic.com > Dashboards: Using the query 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

one.newrelic.com > 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. For detailed information, see our log forwarding documentation for Kubernetes.

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.

Create issueEdit page
Copyright © 2022 New Relic Inc.