﻿---
title: Kubernetes state_persistentvolumeclaim metricset
description: The state_persistentvolumeclaim metricset for kubernetes service related metrics from kube-state-metrics. For a description of each field in the metricset,...
url: https://www.elastic.co/elastic/docs-builder/docs/2967/reference/beats/metricbeat/metricbeat-metricset-kubernetes-state_persistentvolumeclaim
products:
  - Beats
  - Metricbeat
applies_to:
  - Elastic Cloud Serverless: Generally available
  - Elastic Stack: Generally available
---

# Kubernetes state_persistentvolumeclaim metricset
The `state_persistentvolumeclaim` metricset for kubernetes service related metrics from `kube-state-metrics`.

## Fields

For a description of each field in the metricset, see the [exported fields](https://www.elastic.co/elastic/docs-builder/docs/2967/reference/beats/metricbeat/exported-fields-kubernetes) section.
Here is an example document generated by this metricset:
```json
{
    "@timestamp": "2019-03-01T08:05:34.853Z",
    "event": {
        "dataset": "kubernetes.persistentvolumeclaim",
        "duration": 115000,
        "module": "kubernetes"
    },
    "kubernetes": {
        "namespace": "default",
        "persistentvolumeclaim": {
            "access_mode": "ReadWriteOnce",
            "created": "2025-04-08T12:36:47.000Z",
            "name": "mnt-basic-sts-0",
            "phase": "Bound",
            "request_storage": {
                "bytes": 1048576
            },
            "storage_class": "standard",
            "volume_name": "pvc-bdf9afc1-c19e-44db-b169-fdcb423338d2"
        }
    },
    "metricset": {
        "name": "state_persistentvolumeclaim",
        "period": 10000
    },
    "service": {
        "address": "127.0.0.1:55555",
        "type": "kubernetes"
    }
}
```