For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/ddsql_reference/data_directory/k8s/k8s.statefulsets.dataset.md. A documentation index is available at /llms.txt.

Kubernetes StatefulSets

The Kubernetes StatefulSets table provides information about Kubernetes StatefulSets monitored by Datadog across your clusters. Each row represents a Kubernetes StatefulSet and includes metadata about annotations, labels, replica counts (desired, ready, current, updated), pod management policy (OrderedReady, Parallel), update strategy (RollingUpdate, OnDelete), partition for partitioned rolling updates, governing headless service, status conditions, container and init container specs, selectors, resource requirements, and lifecycle timestamps. This table enables you to monitor StatefulSet health and rollout status, track replica availability, compare desired vs actual to detect issues, analyze update strategies and pod management policies, and correlate StatefulSets with pod and container performance. You can filter and view resources by kube_stateful_set tag in Datadog.

k8s.statefulsets

Fields

TitleIDTypeData TypeDescription
Key_keycorestringThe unique identifier for the stateful set.
AnnotationsannotationscorehstoreKey-value pairs containing annotations attached to the StatefulSet, stored as hstore.
Cluster Namecluster_namecorestringThe name of the Kubernetes cluster where the StatefulSet is running.
Creation Timestampcreation_timestampcoretimestampThe timestamp when the StatefulSet was created.
Deletion Timestampdeletion_timestampcoretimestampThe timestamp when the StatefulSet deletion was requested.
LabelslabelscorehstoreKey-value pairs containing labels attached to the StatefulSet, stored as hstore.
StatefulSet NamenamecorestringThe name of the StatefulSet.
NamespacenamespacecorestringThe Kubernetes namespace where the StatefulSet is running.
Spec Containersspec_containerscorejsonThe container specifications for pods managed by this StatefulSet, stored as JSON.
Spec Init Containersspec_init_containerscorejsonThe init container specifications for pods managed by this StatefulSet, stored as JSON.
Spec Partitionspec_partitioncoreint64The partition value used for partitioned rolling updates of the StatefulSet.
Spec Pod Management Policyspec_pod_management_policycorestringThe policy that controls how pods are created during initial scale up, replacement, and scaling down (e.g., OrderedReady, Parallel).
Spec Replicasspec_replicascoreint64The desired number of replicas for the StatefulSet.
Spec Resource Requirementsspec_resource_requirementscorejsonThe resource requests and limits for containers in the StatefulSet, stored as JSON.
Spec Selectorspec_selectorcorejsonThe label selectors used to match pods managed by this StatefulSet, stored as JSON.
Spec Service Namespec_service_namecorestringThe name of the governing headless service that manages this StatefulSet.
Spec Update Strategyspec_update_strategycorestringThe strategy used to update pods (e.g., RollingUpdate, OnDelete).
Status Conditionsstatus_conditionscorejsonThe conditions of the StatefulSet status, stored as JSON.
Status Current Replicasstatus_current_replicascoreint64The number of replicas created by the StatefulSet controller from the current revision.
Status Ready Replicasstatus_ready_replicascoreint64The number of ready replicas in the StatefulSet.
Status Replicasstatus_replicascoreint64The total number of replicas currently observed for the StatefulSet.
Status Updated Replicasstatus_updated_replicascoreint64The number of replicas updated to the latest revision of the StatefulSet.
Resource TagstagscorehstoreThis field contains tags represented as key-value pairs, used to categorize and provide metadata about the StatefulSet.
UIDuidcorestringThe unique identifier of the StatefulSet.