第 7 章 Event [events.k8s.io/v1]


描述
事件是集群中某个事件的报告。它通常表示系统中的一些状态更改。事件具有有限的保留时间和触发器,消息可能会随时间而演变。事件消费者不应依赖于给定 Reason 反映一致的底层触发器的事件的时间,或者持续存在该 Reason 的事件。事件应被视为说明性、best-effort 和 supplemental 数据。
类型
object
必填
  • eventTime

7.1. 规格

属性类型描述

action

字符串

action 是针对对象执行的操作/失败。它是机器可读。对于新事件,此字段不能为空,并且最多有 128 个字符。

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

deprecatedCount

整数

deprecatedCount 是已弃用的字段,以确保与 core.v1 事件类型向后兼容。

deprecatedFirstTimestamp

时间

deprecatedFirstTimestamp 是已弃用的字段,以确保向后兼容 core.v1 事件类型。

deprecatedLastTimestamp

时间

deprecatedLastTimestamp 是已弃用的字段,以确保向后兼容 core.v1 事件类型。

deprecatedSource

EventSource

deprecatedSource 是已弃用的字段,以确保与 core.v1 事件类型向后兼容。

eventTime

MicroTime

eventTime 是第一次观察此事件的时间。它是必需的。

kind

字符串

kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

标准对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

备注

字符串

注意是此操作状态的人类可读描述。备注的最大长度为 1kB,但应准备库来处理最多 64kB 的值。

reason

字符串

原因就是采取该操作的原因。它是人类可读的。对于新事件,此字段不能为空,并且最多有 128 个字符。

regarding

ObjectReference

关于包含此事件所针对的对象。在大多数情况下,它是一个对象报告控制器实现,如 ReplicaSetController 实现 ReplicaSet,这个事件会被发出,因为它对 ReplicaSet 对象中的一些更改做出反应。

相关

ObjectReference

related 是用于更复杂的操作的可选二级对象。例如,当与对象相关的对象触发创建和删除相关对象时。

reportingController

字符串

reportingController 是发出此事件的控制器的名称,如 kubernetes.io/kubelet。对于新事件,此字段不能为空。

reportingInstance

字符串

reportingInstance 是控制器实例的 ID,如 kubelet-xyzf。对于新事件,此字段不能为空,并且最多有 128 个字符。

系列

对象

EventSeries 包含有关一系列事件的信息,即在一段时间内持续发生/发生。将 EventSeries 更新到事件报告者的频率。"k8s.io/client-go/tools/events/event_broadcaster.go" 中的默认事件报告程序演示了如何在心跳中更新这个结构,并可以指导自定义的报告程序实现。

type

字符串

Type 是此事件的类型(Normal, Warning),以后可能会添加新类型。它是机器可读。对于新事件,此字段不能为空。

7.1.1. .series

描述
EventSeries 包含有关一系列事件的信息,即在一段时间内持续发生/发生。将 EventSeries 更新到事件报告者的频率。"k8s.io/client-go/tools/events/event_broadcaster.go" 中的默认事件报告程序演示了如何在心跳中更新这个结构,并可以指导自定义的报告程序实现。
类型
object
必填
  • 数量
  • lastObservedTime
属性类型描述

数量

整数

count 是此系列中最多心跳时间的发生次数。

lastObservedTime

MicroTime

lastObservedTime 是在最后一个 heartbeat 之前看到来自系列的最后一个事件时的时间。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.