diff --git a/src/content/docs/apm/apm-ui-pages/monitoring/kubernetes-summary-page.mdx b/src/content/docs/apm/apm-ui-pages/monitoring/kubernetes-summary-page.mdx index d96d6efaaf2..a55846c59c9 100644 --- a/src/content/docs/apm/apm-ui-pages/monitoring/kubernetes-summary-page.mdx +++ b/src/content/docs/apm/apm-ui-pages/monitoring/kubernetes-summary-page.mdx @@ -133,43 +133,39 @@ The Kubernetes page in APM offers the following information about your applicati ## Link your applications to Kubernetes [#link-app] -You can surface Kubernetes metadata and link it to your APM agents no matter if you use NR proprietary agents or OpenTelemetry. -APM uses the Kubernetes metadata to display the specific Kubernetes deployment information related to that APM application. +You can surface Kubernetes metadata and link it to your APM agents, whether you use NR's proprietary agents or OpenTelemetry. uses the Kubernetes metadata to display the specific Kubernetes deployment information related to that APM application. -### New Relic proprietary instrumentation +### New Relic proprietary instrumentation [#nr-proprietary] -When you install New Relic's Kubernetes integration, New Relic's metadata injection comes into play automatically via the nri-metadata-injection parameter. -It's the MutatingAdmissionWebhook, set up by the Kubernetes instrumentation, that takes on the job 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. +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](/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 +The following attributes are required in the APM service entity to display the Kubernetes summary page: -* k8s.clusterName -* k8s.namespaceName -* k8s.deploymentName +* `k8s.clusterName` +* `k8s.namespaceName` +* `k8s.deploymentName` -### OpenTelemetry instrumentation +### OpenTelemetry instrumentation [#otel-instrumentation] -The OpenTelemetry collector offers a Kubernetes attributes processor that enrich APM telemetry with Kubernetes metadata. +The [OpenTelemetry collector](/docs/opentelemetry/get-started/collector-processing/opentelemetry-collector-processing-intro/) offers a Kubernetes attributes processor that enrich APM telemetry with Kubernetes metadata. -* First, you need to define an environment variable in your deployment manifest -* Next, adjust the collector's configuration so it pulls in the pertinent Kubernetes metadata using that APM environment variable. +1. You need to define an environment variable in your deployment manifest. -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](/docs/kubernetes-pixie/kubernetes-integration/advanced-configuration/link-otel-applications-kubernetes/). +2. Adjust the configuration of the collector to retrieve the appropriate Kubernetes metadata using this APM environment variable. -The following attributes are required in the APM service entity to display the Kubernetes summary page +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](/docs/kubernetes-pixie/kubernetes-integration/advanced-configuration/link-otel-applications-kubernetes/). -* k8s.cluster.name -* k8s.deployment.name -* k8s.namespace.name +The following attributes are required in the APM service entity to display the Kubernetes summary page: - -The Kubernetes summary page won't function correctly if there's a mix of different instrumentation providers (newRelic and OpenTelemetry). -To have it work properly, both Kubernetes and APM need to be monitored either exclusively through New Relic's proprietary agents or entirely via OpenTelemetry. +* `k8s.cluster.name` +* `k8s.deployment.name` +* `k8s.namespace.name` + + +The Kubernetes summary page won't work properly if there is a mix of different instrumentation providers (newRelic and OpenTelemetry). For it to work properly, both Kubernetes and APM need to be monitored either exclusively through New Relic's proprietary agents or entirely through OpenTelemetry. As of now, we don't support hybrid scenarios.