Introduction to the Kubernetes integration

New Relic Infrastructure offers an integration that gives increased visibility into the performance of your Kubernetes environment. For more information about monitoring Kubernetes, visit the New Relic website.


New Relic's Kubernetes integration instruments the container orchestration layer by reporting metrics from Kubernetes objects. The integration gives you insight into your Kubernetes nodes, namespaces, deployments, replica sets, pods, and containers. More functionality is planned for future releases.

Features include:

  • View your data in pre-built dashboards for immediate insight into your Kubernetes environment.
  • Create your own custom queries and charts in Insights from automatically reported data.
  • Create alert conditions on Kubernetes data.
  • Explore entities using the Cluster Explorer.

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

Compatibility and requirements

The New Relic Kubernetes integration requires:

Kubernetes integration requirements Comments
New Relic Infrastructure

Infrastructure Pro or Pro trial subscription.

Linux distribution

Must be compatible with New Relic Infrastructure.

Kubernetes cluster

Currently tested with versions 1.6 to 1.13.

Kubernetes cluster GKE

Currently tested with versions 1.9 and 1.11.

Kubernetes cluster EKS

Currently tested with version 1.11.

Kubernetes cluster AKS

Currently tested with version 1.11.

Kubernetes cluster OpenShift

Currently tested with versions 3.7 and 3.9.

Kubernetes cluster Tektonic

Currently tested with version 1.9.


Requires kube-state-metrics versions 1.1.0 to 1.7.2 running on the cluster.

Newer kube-state-metrics versions may not run on older Kubernetes versions. To check compatibility, see our kube-state-metrics GitHub.

Default Kubernetes alert policy

When deploying the New Relic Kubernetes integration for the first time in an account, a default set of alert conditions is deployed to the account. The alert policy is configured without a notification channel to avoid unwanted notification.

The alert conditions' thresholds can be customized to your environment and the alert policy updated to send notifications. For more information, see the Infrastructure alerts documentation.

For more help

Other Kubernetes integration resources:

  • For discussions about the Kubernetes integration, visit New Relic's Explorers Hub.
  • For integration version changes, see the release notes.