第 7 章 Event [events.k8s.io/v1]
- 描述
- 事件是集群中某个事件的报告。它通常表示系统中的一些状态更改。事件具有有限的保留时间和触发器,消息可能会随时间而演变。事件消费者不应依赖于给定 Reason 反映一致的底层触发器的事件的时间,或者持续存在该 Reason 的事件。事件应被视为说明性、best-effort 和 supplemental 数据。
- 类型
-
object
- 必填
-
eventTime
-
7.1. 规格
属性 | 类型 | 描述 |
---|---|---|
|
| action 是针对对象执行的操作/失败。它是机器可读。对于新事件,此字段不能为空,并且最多有 128 个字符。 |
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| deprecatedCount 是已弃用的字段,以确保与 core.v1 事件类型向后兼容。 |
| deprecatedFirstTimestamp 是已弃用的字段,以确保向后兼容 core.v1 事件类型。 | |
| deprecatedLastTimestamp 是已弃用的字段,以确保向后兼容 core.v1 事件类型。 | |
| deprecatedSource 是已弃用的字段,以确保与 core.v1 事件类型向后兼容。 | |
| eventTime 是第一次观察此事件的时间。它是必需的。 | |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 标准对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| 注意是此操作状态的人类可读描述。备注的最大长度为 1kB,但应准备库来处理最多 64kB 的值。 |
|
| 原因就是采取该操作的原因。它是人类可读的。对于新事件,此字段不能为空,并且最多有 128 个字符。 |
| 关于包含此事件所针对的对象。在大多数情况下,它是一个对象报告控制器实现,如 ReplicaSetController 实现 ReplicaSet,这个事件会被发出,因为它对 ReplicaSet 对象中的一些更改做出反应。 | |
| related 是用于更复杂的操作的可选二级对象。例如,当与对象相关的对象触发创建和删除相关对象时。 | |
|
|
reportingController 是发出此事件的控制器的名称,如 |
|
|
reportingInstance 是控制器实例的 ID,如 |
|
| EventSeries 包含有关一系列事件的信息,即在一段时间内持续发生/发生。将 EventSeries 更新到事件报告者的频率。"k8s.io/client-go/tools/events/event_broadcaster.go" 中的默认事件报告程序演示了如何在心跳中更新这个结构,并可以指导自定义的报告程序实现。 |
|
| Type 是此事件的类型(Normal, Warning),以后可能会添加新类型。它是机器可读。对于新事件,此字段不能为空。 |
7.1.1. .series
- 描述
- EventSeries 包含有关一系列事件的信息,即在一段时间内持续发生/发生。将 EventSeries 更新到事件报告者的频率。"k8s.io/client-go/tools/events/event_broadcaster.go" 中的默认事件报告程序演示了如何在心跳中更新这个结构,并可以指导自定义的报告程序实现。
- 类型
-
object
- 必填
-
数量
-
lastObservedTime
-
属性 | 类型 | 描述 |
---|---|---|
|
| count 是此系列中最多心跳时间的发生次数。 |
| lastObservedTime 是在最后一个 heartbeat 之前看到来自系列的最后一个事件时的时间。 |