• Log inStart now

Kubernetes integration: install and configure

The easiest way to install the Kubernetes integration is to use our guided install to generate a manifest. It bundles not just the integration DaemonSets, but also other New Relic Kubernetes configurations, like Kubernetes events, Prometheus OpenMetrics, and New Relic log monitoring.

As a Kubernetes user, you might consider Auto-telemetry with Pixie for deeper insights into your Kubernetes clusters and workloads. No language agents required.

Ready to get started? If you don't already have one, sign up for a New Relic account. It's free, forever!

Use guided install

We encourage you to use our guided install for servers, VMs, and unprivileged environments. The guided install can provide you either a Helm command with the required values filled, or a plain manifest if you don't want to use Helm. It also features great customizability and full control over which features and dependencies are enabled. If you are installing our integration on a managed cloud, please take a look at these preliminary notes before proceeding.

Before you start the installer, make sure you have a New Relic account. It's free and no credit card is required.

If your New Relic account is in the EU region, choose the EU install option.

Get an account

Alternatively, you can also check our manual instructions for deploying our integration using Helm.

Important

Make sure you are using kubernetes version 1.16 to 1.24 as kubernetes 1.25 is not currently supported.

Install for managed services and platforms

Before starting our guided install, check out these notes for your managed services or platforms:

While you wait for your data to come in...

Did this doc help you install?

Upgrading our Kubernetes integration

Our Kubernetes integration is under active development and we regularly release updates which include bug fixes, new features, and support for newer Kubernetes versions and cloud providers. We strongly recommend all our customers to regularly update the Kubernetes integration to get the best experience.

Upgrading using the guided install and Helm

In order to update an installation that was deployed using Helm command provided by the guided install, just go through the process and run the Helm command again. This will pull the new version of the chart and its dependencies and upgrade it to the latest version.

Upgrading using the guided install and plain manifests

Tip

We encourage you to deploy our integration using Helm, as it provides a cleaner upgrade path compared to using manifests directly.

If custom manifests have been used instead of Helm, you will need to first remove the old installation using kubectl delete -f previous-manifest-file.yml, and then proceed through the guided installer again. This will generate an updated set of manifests that can be deployed using kubectl apply -f manifest-file.yml.

We do not recommend applying a new version of the manifest file without removing the previous one first, since it might leave some leftover components in your cluster.

If you need an advanced way to create your manifest, template it using helm

Uninstall Kubernetes integration

To uninstall the Kubernetes integration using Helm, run the following command. Note that newrelic-bundle is the default release name specified by the guided installer.

bash
$
helm uninstall newrelic-bundle -n newrelic

Monitor services running on Kubernetes

After having installed our Kubernetes integration, you can start instrumenting the services than run in your cluster. To learn more about how to do this, please check our Monitor services running on Kubernetes page.

Use your Kubernetes data

Learn more about how to:

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.