Событие

apiVersion: events.k8s.io/v1

import "k8s.io/api/events/v1"

Событие

Событие — это отчёт о событии где-то в кластере. Обычно оно обозначает некоторое изменение состояния в системе. События имеют ограниченное время хранения, а триггеры и сообщения могут изменяться со временем. Потребители событий не должны полагаться на время события с данным значением Reason, отражающим согласованный базовый триггер, или на постоянное существование событий с этим значением Reason. События должны рассматриваться как информационные данные, с наилучшими усилиями, дополнительные данные.

• apiVersion: events.k8s.io/v1

• kind: Событие

• metadata (ObjectMeta)

  Стандартные метаданные объекта. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• eventTime (MicroTime), обязательно

  eventTime — это время, когда данное событие было впервые отмечено. Оно является обязательным.

  MicroTime — это версия Time с точностью до микросекунд.

• action (строка)

  action — это действие, которое было выполнено/не выполнено относительно объекта. Оно предназначено для машинного чтения. Это поле не может быть пустым для новых событий и может содержать не более 128 символов.

• deprecatedCount (int32)

  deprecatedCount — устаревшее поле, обеспечивающее обратную совместимость с типом события core.v1.

• deprecatedFirstTimestamp (Time)

  deprecatedFirstTimestamp — устаревшее поле, обеспечивающее обратную совместимость с типом события core.v1.

  Time — это обёртка вокруг time.Time, которая поддерживает корректное кодирование в YAML и JSON. Обёртки предоставляются для многих фабричных методов, которые предлагает пакет time.

• deprecatedLastTimestamp (Time)

  deprecatedLastTimestamp — устаревшее поле, обеспечивающее обратную совместимость с типом события core.v1.

  Time — это обёртка вокруг time.Time, которая поддерживает корректное кодирование в YAML и JSON. Обёртки предоставляются для многих фабричных методов, которые предлагает пакет time.

• deprecatedSource (EventSource)

  deprecatedSource — устаревшее поле, обеспечивающее обратную совместимость с типом события core.v1.

  EventSource содержит информацию для события.

  • deprecatedSource.component (строка)

    Компонент, из которого генерируется событие.

  • deprecatedSource.host (строка)

    Имя узла, на котором генерируется событие.

• note (строка)

  note — удобочитаемое описание состояния данной операции. Максимальная длина заметки — 1 КБ, но библиотеки должны быть готовы обрабатывать значения до 64 КБ.

• reason (строка)

  reason — причина, по которой было выполнено действие. Оно удобочитаемо. Это поле не может быть пустым для новых событий и может содержать не более 128 символов.

• regarding (ObjectReference)

  regarding содержит объект, о котором это событие. В большинстве случаев это объект, о котором реализует контроллер отчётности, например, ReplicaSetController реализует ReplicaSets, и это событие генерируется, потому что оно реагирует на некоторые изменения в объекте ReplicaSet.

• related (ObjectReference)

  related — необязательный вторичный объект для более сложных действий. Например, когда объект regarding запускает создание или удаление связанного объекта.

• reportingController (строка)

  reportingController — имя контроллера, который выпустил данное событие, например, kubernetes.io/kubelet. Это поле не может быть пустым для новых событий.

• reportingInstance (строка)

  reportingInstance — идентификатор экземпляра контроллера, например, kubelet-xyzf. Это поле не может быть пустым для новых событий и может содержать не более 128 символов.

• series (EventSeries)

  series — данные о серии событий, которую представляет это событие, или null, если это событие-синглтон.

  EventSeries содержат информацию о серии событий, т.е. о том, что происходило/происходит непрерывно в течение некоторого времени. Как часто обновлять EventSeries, зависит от докладчиков событий. Встроенный в "k8s.io/client-go/tools/events/event_broadcaster.go" докладчик событий показывает, как эта структура обновляется при каждом сердцебиении, и может помочь в реализации пользовательских докладчиков.

  • series.count (int32), обязательно

    count — количество событий в этой серии до времени последнего импульса.

  • series.lastObservedTime (MicroTime), обязательно

    lastObservedTime — время, когда последнее событие из серии было видно до последнего импульса.

    MicroTime — это версия Time с точностью до микросекунд.

• type (строка)

  type — тип данного события (Normal, Warning), в будущем могут быть добавлены новые типы. Оно предназначено для машинного чтения. Это поле не может быть пустым для новых событий.

Список событий

EventList — это список объектов Event.

• apiVersion: events.k8s.io/v1

• kind: Список событий

• metadata (ListMeta)

  Стандартные метаданные списка. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• items ([]Событие), обязательно

  items — список объектов схемы.