---
title: Find and use your Kubernetes data
source: https://docs.newrelic.com/docs/kubernetes-pixie/kubernetes-integration/understand-use-data/find-use-your-kubernetes-data
---

You can build your own [charts](https://docs.newrelic.com/docs/query-your-data/explore-query-data/use-charts/use-your-charts/) and [query](https://docs.newrelic.com/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data/) all your [Kubernetes integration](https://docs.newrelic.com/docs/integrations/kubernetes-integration/get-started/introduction-kubernetes-integration) data using the query builder and the NerdGraph API. Our integration collects Kubernetes data by instrumenting the container orchestration layer.

![New Relic - Kubernetes dashboard](https://docs.newrelic.com/images/kubernetes_screenshot-full_dashboard.webp "New Relic - Kubernetes dashboard")

Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Dashboards**. Using the [query builder](https://docs.newrelic.com/docs/chart-builder/use-chart-builder/get-started/introduction-chart-builder) you can query your Kubernetes data and create clear visualizations.

> #### 💡 TIP
>
> If you prefer a visual experience of your Kubernetes data, see our [Kubernetes cluster explorer](https://docs.newrelic.com/docs/integrations/kubernetes-integration/understand-use-data/kubernetes-cluster-explorer).

## Query Kubernetes data [#view-data]

The simplest way to [query your Kubernetes data](https://docs.newrelic.com/docs/using-new-relic/data/understand-data/query-new-relic-data) is using the [query builder](https://docs.newrelic.com/docs/query-your-data/explore-query-data/query-builder/use-advanced-nrql-mode-specify-data), which accepts [NRQL queries](https://docs.newrelic.com/docs/query-data/nrql-new-relic-query-language/getting-started/introduction-nrql). Alternatively, you can use the [NerdGraph API](https://docs.newrelic.com/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) to retrieve Kubernetes data.

### Events and attributes [#event-types]

Kubernetes data is attached to these [events](https://docs.newrelic.com/docs/using-new-relic/data/understand-data/new-relic-data-types#event-data). Here's a list of specific events for Kubernetes (learn more about this data in [our data dictionary](/attribute-dictionary/?dataSource=Kubernetes)).

| Event name                   | Type of Kubernetes data        | Available since |
| ---------------------------- | ------------------------------ | --------------- |
| `K8sNodeSample`              | Node data                      | v1.0.0          |
| `K8sNamespaceSample`         | Namespace data                 | v1.0.0          |
| `K8sDeploymentSample`        | Deployment data                | v1.0.0          |
| `K8sReplicasetSample`        | ReplicaSet data                | v1.0.0          |
| `K8sDaemonsetSample`         | DaemonSet data                 | v1.13.0         |
| `K8sStatefulsetSample`       | StatefulSet data               | v1.13.0         |
| `K8sPodSample`               | Pod data                       | v1.0.0          |
| `K8sClusterSample`           | Cluster data                   | v1.0.0          |
| `K8sContainerSample`         | Container data                 | v1.0.0          |
| `K8sVolumeSample`            | Volume data                    | v1.0.0          |
| `K8sApiServerSample`         | API server data                | v1.11.0         |
| `K8sControllerManagerSample` | Controller manager data        | v1.11.0         |
| `K8sSchedulerSample`         | Scheduler data                 | v1.11.0         |
| `K8sEtcdSample`              | etcd data                      | v1.11.0         |
| `K8sEndpointSample`          | Endpoint data                  | v1.13.0         |
| `K8sServiceSample`           | Service data                   | v1.13.0         |
| `K8sHpaSample`               | Horizontal Pod Autoscaler data | v2.3.0          |
| `K8sCronjobSample`           | CronJob data                   | v3.10.0         |
| `K8sJobSample`               | Job data                       | v3.10.0         |

> #### ⚠️ IMPORTANT
>
> `InternalK8sCompositeSample` is an event that New Relic generates and it's quite critical for [Kubernetes cluster explorer](https://docs.newrelic.com/docs/kubernetes-pixie/kubernetes-integration/understand-use-data/kubernetes-cluster-explorer/#cluster-explorer-use). Without this event, you won't see your Kubernetes data in the UI. See [Data ingest: Billing and rules](https://docs.newrelic.com/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing/) for more information.

### Kubernetes metadata in APM-monitored applications [#apm-custom-attributes]

[Connecting your applications to Kubernetes](https://docs.newrelic.com/docs/kubernetes-pixie/kubernetes-integration/advanced-configuration/link-apm-applications-kubernetes/) adds these attributes to your application data, as well as to distributed tracing metadata:

-   `nodeName`
-   `containerName`
-   `podName`
-   `clusterName`
-   `deploymentName`
-   `namespaceName`

## Choose your next step [#next-step]

[View your Kubernetes events](https://docs.newrelic.com/docs/kubernetes-pixie/kubernetes-integration/understand-use-data/kubernetes-events-integration/)

[Check our Kubernetes recommended alert policies](https://docs.newrelic.com/docs/kubernetes-pixie/kubernetes-integration/installation/recommended-alert-policies)