• Log inStart now

On August 31, 2024, we're EOLing developer.newrelic.com. All relevant content has been migrated to docs.newrelic.com.

Instrument your cluster

15 min


This procedure is part of a lab that teaches you how to monitor your Kubernetes cluster with Pixie.

Each procedure in the lab builds upon the last, so make sure you've completed the last procedure, Explore your cluster, before starting this one.

As the developer of TinyHat.me, you need to have visibility into your cluster. You need to know how healthy your application is. You need to know when things go wrong. But you've put it off for so long because instrumenting Kubernetes is hard and time-consuming. This is one of the things that makes Pixie so valuable.

Pixie is a CNCF open source Kubernetes monitoring solution that provides:

  • Automatic and instant baseline observability of your cluster
  • Actionable, code-level insights of your applications

With Pixie's auto-telemetry, you'll instrument your cluster in minutes to get dynamic data such as protocol traces, resource metrics, and app metrics from your cluster—all without an agent!


If you haven't signed into New Relic, do that now so you're ready to install Pixie into your cluster.

Step 1 of 10

Open New Relic. On the right side of the upper navigation bar, click Add more data:

Arrow pointing to the add more data button

Step 2 of 10

Click Guided install:

Arrow pointing to the guided install button

This walks you through the installation process.

Step 3 of 10

Click Kubernetes to let New Relic guide you through instrumenting your Kubernetes cluster:

Arrow pointing to the Kubernetes button

Step 4 of 10

Click Begin installation:

Arrow pointing to the begin installation button

Step 5 of 10

Select your account, name your cluster "tiny-hat", and click Continue:

Box highlighting the account and cluster name fields

This specifies that TinyHat.me, and all its services, should live in a New Relic cluster called "tiny-hat" in the account you selected.

Step 6 of 10

Leave the default choices on the next screen. These provide a range of observability features for your cluster, including our infrastructure agent which gives you a high level overview of the health of your cluster. Notably, the default options include "Instant service-level insights, full-body requests, and application profiles through Pixie" which you focus on in this lab.

Click Continue:

Box highlighting Pixie instrumentation

In the next screen, you see a command for installing our Kubernetes integration into your cluster.

Step 7 of 10

Click Copy command:

Arrow pointing to the copy command button

Now you're ready to install Pixie into your cluster.

Step 8 of 10

Switch back to your terminal and paste the Helm command.

Step 9 of 10

While you're installing Pixie, switch back to New Relic and click Continue to progress your guided installation to the final step. Here, you see a message that says "Listening for data":

New Relic page showing listening for data

In a few minutes, Helm will have fully installed the necessary charts. You should see a message with the name, deployed date, namespace, and more:

NAME: newrelic-bundle
LAST DEPLOYED: Thu Sep 23 13:50:24 2021
NAMESPACE: newrelic
STATUS: deployed

Soon after that, the New Relic page updates to tell you that we're receiving data from your cluster:

New Relic page showing a successful install

Step 10 of 10

Click Kubernetes cluster explorer to see your nodes, pods, deployments and a host of other data about your cluster, all in one view:

New Relic cluster explorer


You may see an error message, "We're receiving incomplete data for this cluster." Please wait a few more minutes and refresh the page to see your cluster.

In minutes, you were able to instrument your entire cluster without having to install language-specific agents or specify detailed cluster information!

On top of all the data you see in the cluster explorer, click a pod or a node to dig deeper and see the granular data that the infrastructure agent was able to access near-instantly:

Pod data collected by Pixie


This procedure is part of a lab that teaches you how to monitor your Kubernetes cluster with Pixie. Now that you've instrumented your cluster, use Pixie to debug your application.

Copyright © 2024 New Relic Inc.

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