Це багатосторінковий друкований вигляд цього розділу. Натисність щоб друкувати.

Повернутися до звичайного перегляду сторінки.

Зовнішні API

1 - Kubernetes Custom Metrics (v1beta2)

Пакунок v1beta2 - це версія v1beta2 API custom_metrics.

Типи ресурсів

MetricListOptions

MetricListOptions використовується для вибору метрик за їх селекторами міток

ПолеОпис
apiVersion
string		custom.metrics.k8s.io/v1beta2
kind
string		MetricListOptions
labelSelector
string

Селектор для обмеження списку обʼєктів, що повертаються, за їхніми мітками. Стандартно — всі обʼєкти.

metricLabelSelector
string

Селектор для обмеження списку метрик, що повертаються, за їхніми мітками

MetricValue

Зʼявляється в:

MetricValue — це значення метрики для певного обʼєкта.

ПолеОпис
apiVersion
string		custom.metrics.k8s.io/v1beta2
kind
string		MetricValue
describedObject [Обовʼязково]
core/v1.ObjectReference

посилання на описуваний обʼєкт

metric [Обовʼязково]
MetricIdentifier		Опис відсутній.
timestamp [Обовʼязково]
meta/v1.Time

вказує час, коли були створені метрики

windowSeconds [Обовʼязково]
int64

вказує на вікно ([Timestamp-Window, Timestamp]), з якого були розраховані ці метрики, при поверненні показника метрики, розраховані з кумулятивних метрик (або нуль для нерозрахованих миттєвих метрик).

value [Обовʼязково]
k8s.io/apimachinery/pkg/api/resource.Quantity

значення метрики для цього обʼєкта

MetricValueList

MetricValueList — це список значень для даної метрики для певного набору обʼєктів

ПолеОпис
apiVersion
string		custom.metrics.k8s.io/v1beta2
kind
string		MetricValueList
metadata [Обовʼязково]
meta/v1.ListMeta		Опис відсутній.
items [Обовʼязково]
[]MetricValue

значення метрики для описаних обʼєктів

MetricIdentifier

Зʼявляється в:

MetricIdentifier ідентифікує метрику за назвою та, за потреби, селектором.

ПолеОпис
name [Обовʼязково]
string

name - це назва даної метрики

selector
meta/v1.LabelSelector

selector представляє селектор міток, який можна використати для вибору цієї метрики, і зазвичай буде просто селектором, переданим у запиті для отримання цієї метрики. Якщо залишити порожнім, для збору метрик буде використано лише назву метрики.

2 - Kubernetes External Metrics (v1beta1)

Пакет v1beta1 є версією v1beta1 зовнішнього API метрик.

Типи ресурсів

ExternalMetricValue

Зʼявляється в:

ExternalMetricValue — це значення метрики для зовнішньої метрики. Окрема метрика ідентифікується за назвою метрики та набором рядкових міток. Для однієї метрики може бути кілька значень з різними наборами міток.

ПолеОпис
apiVersion
string		external.metrics.k8s.io/v1beta1
kind
string		ExternalMetricValue
metricName [Обовʼязково]
string

назва метрики

metricLabels [Обовʼязково]
map[string]string

набір міток, які ідентифікують один часовий ряд для метрики

timestamp [Обовʼязково]
meta/v1.Time

вказує час, коли були створені метрики

window [Обовʼязково]
int64

вказує на вікно ([Timestamp-Window, Timestamp]), з якого були розраховані ці метрики, при поверненні показника метрики, розраховані з кумулятивних метрик (або нуль для нерозрахованих миттєвих метрик).

value [Обовʼязково]
k8s.io/apimachinery/pkg/api/resource.Quantity

значення метрики

ExternalMetricValueList

ExternalMetricValueList — це список значень для даної метрики для певного набору міток

ПолеОпис
apiVersion
string		external.metrics.k8s.io/v1beta1
kind
string		ExternalMetricValueList
metadata [Обовʼязково]
meta/v1.ListMeta		Опис відсутній.
items [Обовʼязково]
[]ExternalMetricValue

значення метрики для відповідного набору міток

3 - Kubernetes Metrics (v1beta1)

Пакет v1beta1 є версією v1beta1 API метрик.

Типи ресурсів

NodeMetrics

Зʼявляється в:

NodeMetrics встановлює метрики використання ресурсів вузла.

ПолеОпис
apiVersion
string		metrics.k8s.io/v1beta1
kind
string		NodeMetrics
metadata
meta/v1.ObjectMeta

Стандартні метадані обʼєкта. Більше інформації: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

Звіряйтесь з документацією Kubernetes API для полів metadata.
timestamp [Обовʼязково]
meta/v1.Time

Наступні поля визначають інтервал часу, з якого метрики були зібрані, з інтервалу [Timestamp-Window, Timestamp].

window [Обовʼязково]
meta/v1.Duration		Опис відсутній.
usage [Обовʼязково]
core/v1.ResourceList

Використання памʼяті — це робочий набір памʼяті.

NodeMetricsList

NodeMetricsList — це список NodeMetrics.

ПолеОпис
apiVersion
string		metrics.k8s.io/v1beta1
kind
string		NodeMetricsList
metadata [Обовʼязково]
meta/v1.ListMeta

Стандартні метадані списку. Більше інформації: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

items [Обовʼязково]
[]NodeMetrics

Список метрик вузла.

PodMetrics

Зʼявляється в:

PodMetrics встановлює метрики використання ресурсів Pod.

ПолеОпис
apiVersion
string		metrics.k8s.io/v1beta1
kind
string		PodMetrics
metadata
meta/v1.ObjectMeta

Стандартні метадані обʼєкта. Більше інформації: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

Звіряйтесь з документацією Kubernetes API для полів metadata.
timestamp [Обовʼязково]
meta/v1.Time

Наступні поля визначають інтервал часу, з якого метрики були зібрані, з інтервалу [Timestamp-Window, Timestamp].

window [Обовʼязково]
meta/v1.Duration		Опис відсутній.
containers [Обовʼязково]
[]ContainerMetrics

Метрики для всіх контейнерів збираються в одному часовому інтервалі.

PodMetricsList

PodMetricsList — це список PodMetrics.

ПолеОпис
apiVersion
string		metrics.k8s.io/v1beta1
kind
string		PodMetricsList
metadata [Обовʼязково]
meta/v1.ListMeta

Стандартні метадані списку. Більше інформації: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

items [Обовʼязково]
[]PodMetrics

Список метрик поду.

ContainerMetrics

Зʼявляється в:

ContainerMetrics встановлює метрики використання ресурсів контейнера.

ПолеОпис
name [Обовʼязково]
string

Назва контейнера відповідає тій, що з pod.spec.containers.

usage [Обовʼязково]
core/v1.ResourceList

Використання памʼяті — це робочий набір памʼяті.