---
title: Kubernetes summary page
source: https://docs.newrelic.com/docs/apm/apm-ui-pages/monitoring/kubernetes-summary-page
---

The Kubernetes APM **summary** page provides general information about the selected application, including the age of the current deployment, the number of pods available, CPU and memory usage, pod logs, and metric comparison.

![This is an image of the Kubernetes APM page](https://docs.newrelic.com/images/apm_screenshot-crop_k8-apm-ui.webp "Kubernetes page")

Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > APM & Services > (selected app) > Kubernetes**

> #### 💡 TIP
>
> To get a high-level overview of all your applications and services, use our [entity explorer](https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/core-concepts/new-relic-explorer-view-performance-across-apps-services-hosts/).

## Monitor the deployment of your Kubernetes cluster [#monitor-kubernetes]

The Kubernetes page in APM offers the following information about your application:

**Deployment summary**

You can see your cluster name, deployment, and namespace that it's running in. If you click the deployment, you'll get details about it in a slide-out panel. In the slide-out panel, you can see a mini overview containing relevant information such as a count of logs and percentage of error logs in the specified time range.

![This is an image of the Kubernetes APM page](https://docs.newrelic.com/images/apm_screenshot-crop_k8-apm-mini-overview.webp "Kubernetes page - Mini overview")

In the **Instances** drop-down, you can select a single pod instance of your service.

![This is an image of the Kubernetes APM page](https://docs.newrelic.com/images/apm_screenshot-crop_k8-header.webp "Kubernetes page - Deployment summary")

If you have a multi-cluster app (an app that spans multiple clusters), the **Kubernetes** page shows you a summary of all the clusters. To isolate a specific cluster, select it from the **Cluster** drop-down list. To return to a view of all clusters, click **All clusters**.
![Show entity preview](https://docs.newrelic.com/images/apm_screenshot-crop_k9-multi-cluster.webp "Kubernetes page - Show entity preview")

**Current deployment**

You can check how many pods are available or desired, the pods that are missing, and the age of the kubernetes deployment, which is the date when the deployment was first created.

![This is an image of the Kubernetes APM page](https://docs.newrelic.com/images/apm_screenshot-crop_k8-current-deploy.webp "Kubernetes page - Current deployment")

**Performance summary for the deployment**

You can see the CPU and memory utilization, as well as the number of pod restarts.

![This is an image of the Kubernetes APM page](https://docs.newrelic.com/images/apm_screenshot-crop_k8-performance.webp "Kubernetes page - Performance summary")

**Pods and containers**

You can check pod and their related containers details. If you click the pod or container name, you'll get some details about it in a slide-out panel.

In addition, with the **Logs** button, you can see the logs in context to that pod.

![This is an image of the Kubernetes APM page](https://docs.newrelic.com/images/apm_screenshot-crop_k8-pod-containers.webp "Kubernetes page - Pods and Containers")

**Activity stream**

You can see the stream of Kubernetes events related to that deployment and its pods.

![This is an image of the Kubernetes APM page](https://docs.newrelic.com/images/apm_screenshot-crop_k8-activity-stream.webp "Kubernetes page - Activity stream")

**Metrics comparison**

These widgets let you compare a static list of metrics related to the pods-containers in the deployment, as well as other metrics such as CPU, network, storage.

![This is an image of the Kubernetes APM page](https://docs.newrelic.com/images/apm_screenshot-crop_k8-metric-comparasin.webp "Kubernetes page - Metrics Comparison")

The following metrics are available:

-   CPU usage (cores)
-   CPU throttling (%)
-   Memory usage (bytes)
-   Network received (KBps)
-   Network transmitted (KBps)
-   Network errors (per second)
-   Storage usage (bytes)
-   Storage utilization (%)
-   Container restart count
-   Service throughtput (requests per minute)
-   Service response time (ms)
-   Service error rate (%)

## Link your applications to Kubernetes [#link-app]

You can surface Kubernetes metadata and link it to your APM agents, whether you use our proprietary agents or OpenTelemetry. APM uses the Kubernetes metadata to display the specific Kubernetes deployment information related to that APM application.

### New Relic proprietary instrumentation [#nr-proprietary]

When you [install New Relic's Kubernetes integration](/install/kubernetes/), New Relic's metadata injection comes into play automatically via the `nri-metadata-injection` parameter. The `MutatingAdmissionWebhook`, set up by the Kubernetes instrumentation, takes care of tagging your pods with the necessary environment variables. From there, the data captured in these variables gets carried over to your APM metrics and entities, enriching them with valuable context.

For more information, see how to [link your applications to Kubernetes](https://docs.newrelic.com/docs/kubernetes-pixie/kubernetes-integration/advanced-configuration/link-your-applications-kubernetes/).

The following attributes are required in the APM service entity to display the Kubernetes summary page:

-   `k8s.clusterName`
-   `k8s.namespaceName`
-   `k8s.deploymentName`

### OpenTelemetry instrumentation [#otel-instrumentation]

The [OpenTelemetry Collector](https://docs.newrelic.com/docs/opentelemetry/get-started/collector-processing/opentelemetry-collector-processing-intro/) offers a Kubernetes attributes processor that enrich APM telemetry with Kubernetes metadata.

1.  You need to define an environment variable in your deployment manifest.

2.  Adjust the configuration of the Collector to retrieve the appropriate Kubernetes metadata using this APM environment variable.

As a result, all the APM metrics and entities will include Kubernetes metadata thanks to the `K8sattributes` processor. For more information, see how to [link your OpenTelemetry applications to Kubernetes](https://docs.newrelic.com/docs/kubernetes-pixie/kubernetes-integration/advanced-configuration/link-otel-applications-kubernetes/).

The following attributes are required in the APM service entity to display the Kubernetes summary page:

-   `k8s.cluster.name`
-   `k8s.deployment.name`
-   `k8s.namespace.name`

> #### ⚠️ IMPORTANT
>
> The Kubernetes summary page works with a mix of instrumentation providers (New Relic and OpenTelemetry). However, if Kubernetes is monitored by OpenTelemetry agents and APM is monitored by New Relic agents, install nri-metadata-injection to ensure it works properly by providing the necessary Kubernetes metadata to the APM metrics.
