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 our website.

Understand your Kubernetes nodes and pods, and how the relate to each other. > Kubernetes: The cluster explorer gives you a powerful and innovative solution to the challenges associated with running Kubernetes at a large scale.


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.

New Relic Infrastructure - Kubernetes dashboard > Third-party services > Kubernetes dashboard

Features include:

  • View your data in pre-built dashboards for immediate insight into your Kubernetes environment.
  • Create your own custom queries and charts in the Chart builder 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.10 to 1.15.

Kubernetes cluster GKE

Currently tested with versions 1.10 and 1.15.

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, 3.9, 4.2 and 4.3.


Requires kube-state-metrics versions 1.1.0 to 1.9.5 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

Recommendations for learning more: