PodMetrics [metrics.k8s.io/v1beta1]
Esc
Start typing to search...
On this page

PodMetrics [metrics.k8s.io/v1beta1]

Description

PodMetrics sets resource usage metrics of a pod.

Type
`object`
Required
  • timestamp
  • window
  • containers

Specification

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
containersarrayMetrics for all containers are collected within the same time window.
containers[]objectContainerMetrics sets resource usage metrics of a container.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadataObjectMetaStandard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
timestampTimeThe following fields define time interval from which metrics were collected from the interval [Timestamp-Window, Timestamp].
windowDuration

.containers

Description

Metrics for all containers are collected within the same time window.

Type
`array`

.containers[]

Description

ContainerMetrics sets resource usage metrics of a container.

Type
`object`
Required
  • name
  • usage
PropertyTypeDescription
namestringContainer name corresponding to the one from pod.spec.containers.
usageobject (Quantity)The memory usage is the memory working set.

API endpoints

The following API endpoints are available:

  • /apis/metrics.k8s.io/v1beta1/pods
    • GET: list objects of kind PodMetrics
  • /apis/metrics.k8s.io/v1beta1/namespaces/{namespace}/pods
    • GET: list objects of kind PodMetrics
  • /apis/metrics.k8s.io/v1beta1/namespaces/{namespace}/pods/{name}
    • GET: read the specified PodMetrics

/apis/metrics.k8s.io/v1beta1/pods

HTTP method
`GET`
Description
list objects of kind PodMetrics

HTTP responses

HTTP codeReponse body
200 - OKPodMetricsList schema

/apis/metrics.k8s.io/v1beta1/namespaces/{namespace}/pods

HTTP method
`GET`
Description
list objects of kind PodMetrics

HTTP responses

HTTP codeReponse body
200 - OKPodMetricsList schema

/apis/metrics.k8s.io/v1beta1/namespaces/{namespace}/pods/{name}

Global path parameters

ParameterTypeDescription
namestringname of the PodMetrics
HTTP method
`GET`
Description
read the specified PodMetrics

HTTP responses

HTTP codeReponse body
200 - OKPodMetrics schema