Introduction to the Kubernetes integration

New Relic's Kubernetes integration gives you full visibility into the health and performance of your Kubernetes environment, no matter whether you run Kubernetes on-premise 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.

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-premise, cloud, and hybrid deployments.

It all starts with 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.

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.

If you need additional control, 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 Infrastructure already reports for containerized processes running on instrumented hosts.

Get started: Install the Kubernetes integration

Before installing the Kubernetes integration, check the compatibility and requirements.

There are several ways of installing and enabling the Kubernetes integration:

After installing, you can do additional configuration, including:

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 New Relic Logs 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.

For more help

Recommendations for learning more: