第 16 章 InsightsOperator [operator.openshift.io/v1]
- 描述
- InsightsOperator 包含有关 Insights Operator 的集群范围信息。兼容性级别 1:在主发行版本中至少提供 12 个月或 3 个次版本(以更长的时间为准)。
- 类型
-
object
- 必填
-
spec
-
16.1. 规格
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| 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 | |
|
| spec 是 Insights 所需的行为的规格。 |
|
| Status 是 Insights 操作器最近观察到的状态。 |
16.1.1. .spec
- 描述
- spec 是 Insights 所需的行为的规格。
- 类型
-
object
属性 | 类型 | 描述 |
---|---|---|
|
| Loglevel 是整个组件的意图型日志记录。它无法提供精细的控制,但管理操作员必须针对其操作对象解释的粗粒度日志记录选择是一个简单的方法。有效值为:"Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
| managementState 指明 Operator 是否应该管理组件 |
| `` | observedConfig 包含一个从集群状态观察到的稀疏配置。它存在于 spec 中,因为它是 Operator 的级别输入 |
|
| operatorLogLevel 是 Operator 本身的意图日志。它无法提供精细的控制,但管理操作员必须自行解释的粗粒度日志记录选择是一个简单的方法。有效值为:"Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
| `` | unsupportedConfigOverrides 包含稀疏配置,它将覆盖任何之前设置的选项。它只需要是覆盖字段才能按照以下顺序进行覆盖:1.硬编码默认值 2. observedConfig 3. unsupportedConfigOverrides |
16.1.2. .status
- 描述
- Status 是 Insights 操作器最近观察到的状态。
- 类型
-
object
属性 | 类型 | 描述 |
---|---|---|
|
| conditions 是条件及其状态列表 |
|
| OperatorCondition 只是标准条件字段。 |
|
| gatherStatus 提供有关最后一次 Insights 数据收集的基本信息。如果省略时,这意味着还没有进行数据收集。 |
|
| 生成用于确定项目是否需要协调或更改是否需要反应。 |
|
| GenerationStatus 追踪给定资源的生成,以便可以对强制更新的决策进行。 |
|
| insightsReport 提供常规 Insights 分析结果。如果省略时,这意味着还没有进行数据收集。 |
|
| observedGeneration 是您处理的最后生成更改 |
|
| readyReplicas 表示有多少副本就绪并处于所需的状态 |
|
| 版本是此可用性适用的级别 |
16.1.3. .status.conditions
- 描述
- conditions 是条件及其状态列表
- 类型
-
array
16.1.4. .status.conditions[]
- 描述
- OperatorCondition 只是标准条件字段。
- 类型
-
object
属性 | 类型 | 描述 |
---|---|---|
|
| |
|
| |
|
| |
|
| |
|
|
16.1.5. .status.gatherStatus
- 描述
- gatherStatus 提供有关最后一次 Insights 数据收集的基本信息。如果省略时,这意味着还没有进行数据收集。
- 类型
-
object
属性 | 类型 | 描述 |
---|---|---|
|
| gatherers 是最后一次收集的活跃收集者(及其状态)的列表。 |
|
| gathererStatus 代表有关特定数据收集器的信息。 |
|
| lastGatherDuration 是最后一次收集事件期间处理所有收集者的总时间。 |
|
| lastGatherTime 是 Insights 数据收集完成后最后一次的时间。空值表示还没有收集任何数据。 |
16.1.6. .status.gatherStatus.gatherers
- 描述
- gatherers 是最后一次收集的活跃收集者(及其状态)的列表。
- 类型
-
数组
16.1.7. .status.gatherStatus.gatherers[]
- 描述
- gathererStatus 代表有关特定数据收集器的信息。
- 类型
-
object
- 必填
-
conditions
-
lastGatherDuration
-
名称
-
属性 | 类型 | 描述 |
---|---|---|
|
| 条件详细介绍了每个收集器的状态。 |
|
|
条件包含此 API 资源当前状态的一个方面的详情。--- 这个结构旨在直接用作字段路径 .status.conditions 中的数组。例如,输入 FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition |
|
| lastGatherDuration 代表收集时间。 |
|
| name 是 gatherer 的名称。 |
16.1.8. .status.gatherStatus.gatherers[].conditions
- 描述
- 条件详细介绍了每个收集器的状态。
- 类型
-
数组
16.1.9. .status.gatherStatus.gatherers[].conditions[]
- 描述
-
条件包含此 API 资源当前状态的一个方面的详情。--- 这个结构旨在直接用作字段路径 .status.conditions 中的数组。例如,输入 FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition
json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions"
// other fields } - 类型
-
object
- 必填
-
lastTransitionTime
-
message
-
reason
-
status
-
type
-
属性 | 类型 | 描述 |
---|---|---|
|
| lastTransitionTime 是条件从一个状态转换到另一个状态最后一次的时间。这应该是底层条件变化的时间。如果为未知,则使用 API 字段更改的时间是可以接受的。 |
|
| Message 是人类可读的消息,指示有关转换的详细信息。这可能是一个空字符串。 |
|
| observedGeneration 代表 .metadata.generation,这是条件设置所基于的条件。例如,如果 .metadata.generation 目前为 12,但 .status.conditions[x].observedGeneration 是 9,则代表条件与实例的当前状态已不匹配。 |
|
| reason 包含程序标识符,指示条件最后一次转换的原因。特定条件类型的制作者可能会定义预期的值和此字段的含义,以及这些值是否被视为有保证的 API。该值应该是 CamelCase 字符串。此字段可能不是空的。 |
|
| 条件的状态,True, False, Unknown 之一。 |
|
| CamelCase 或 foo.example.com/CamelCase 中的条件类型。-- Many .condition.type 值在资源间是一致的,但因为任意条件可能很有用(请参阅 .node.status.conditions),deconflict 的能力非常重要。它匹配的正则表达式是 (dns1123SubdomainFmt/)? (qualifiedNameFmt) |
16.1.10. .status.generations
- 描述
- 生成用于确定项目是否需要协调或更改是否需要反应。
- 类型
-
array
16.1.11. .status.generations[]
- 描述
- GenerationStatus 追踪给定资源的生成,以便可以对强制更新的决策进行。
- 类型
-
object
属性 | 类型 | 描述 |
---|---|---|
|
| 组是您要跟踪的内容组 |
|
| hash 是为没有生成的情况下为资源设置的可选字段,它们是敏感内容,如 secret 和 configmaps |
|
| lastGeneration 是涉及的工作负载控制器的最后生成 |
|
| name 是您要跟踪的内容的名称 |
|
| 命名空间(namespace)是您要跟踪的事情 |
|
| 资源是您要跟踪的资源类型 |
16.1.12. .status.insightsReport
- 描述
- insightsReport 提供常规 Insights 分析结果。如果省略时,这意味着还没有进行数据收集。
- 类型
-
object
属性 | 类型 | 描述 |
---|---|---|
|
| downloadedAt 是下载最后一次 Insights 报告的时间。一个空值表示,还没有下载 Insights 报告,它通常会出现在断开连接的集群中(当禁用 Insights 数据收集时)。 |
|
| 健康检查提供有关集群中活跃 Insights 健康检查的基本信息。 |
|
| Healthcheck 代表 Insights 健康检查属性。 |
16.1.13. .status.insightsReport.healthChecks
- 描述
- 健康检查提供有关集群中活跃 Insights 健康检查的基本信息。
- 类型
-
数组
16.1.14. .status.insightsReport.healthChecks[]
- 描述
- Healthcheck 代表 Insights 健康检查属性。
- 类型
-
object
- 必填
-
advisorURI
-
description
-
state
-
totalRisk
-
属性 | 类型 | 描述 |
---|---|---|
|
| 公告URI 提供到 Insights Advisor 的 URL 链接。 |
|
| 描述提供了 healtcheck 的基本描述。 |
|
| State 决定健康检查的当前状态是什么。健康检查默认为启用,可以被 Insights 公告用户界面中的用户禁用。 |
|
| 健康检查的 TotalRisk。检测到的问题所带来的总风险的指标;影响和可能性组合。值可以从 1 到 4、数值越高,问题越大越重要。 |