红帽全球峰会第 1 章 升级到 Logging 6.0
日志记录 v6.0 是之前版本的一个显著升级，实现了集群日志记录的几个长目标：
- 引入不同的 operator 来管理日志记录组件（如收集器、存储、视觉化）。
- 根据 Elastic 产品（如 Elasticsearch、Kibana）删除对受管日志存储和视觉化的支持。
- 弃用 Fluentd 日志收集器实现。
-
删除对
ClusterLogging.logging.openshift.io和ClusterLogForwarder.logging.openshift.io资源的支持。
cluster-logging-operator 不提供自动升级过程。
根据日志集合、转发和存储的各种配置，cluster-logging-operator 不会提供自动升级。本文档可帮助管理员将现有 ClusterLogging.logging.openshift.io 和 ClusterLogForwarder.logging.openshift.io 规格转换为新的 API。包括针对常见用例迁移的 ClusterLogForwarder.observability.openshift.io 资源示例。
1.1. 使用 oc explain 命令
oc explain 命令是 OpenShift CLI oc 中的基本工具，它提供了自定义资源(CR)中字段的详细描述。此命令对于在 OpenShift 集群中配置或故障排除资源的管理员和开发人员而言是不可能的。
1.1.1. 资源描述
oc explain 提供了对与特定对象关联的所有字段的深入说明。这包括标准资源，如 pod 和服务，以及更复杂的实体，如有状态集和 Operator 定义的自定义资源。
要查看 ClusterLogForwarder 自定义资源的 outputs 字段的文档，您可以使用：
oc explain clusterlogforwarders.observability.openshift.io.spec.outputs
$ oc explain clusterlogforwarders.observability.openshift.io.spec.outputs
在 clusterlogforwarder 的位置，可以使用简短形式 obsclf。
这将显示有关这些字段的详细信息，包括类型、默认值和任何关联的子字段。
1.1.2. 层次结构
命令以分级格式显示资源字段的结构，从而阐明不同配置选项之间的关系。
例如，以下是如何更深入地进行 storage 配置用于 LokiStack 自定义资源：
oc explain lokistacks.loki.grafana.com oc explain lokistacks.loki.grafana.com.spec oc explain lokistacks.loki.grafana.com.spec.storage oc explain lokistacks.loki.grafana.com.spec.storage.schemas
$ oc explain lokistacks.loki.grafana.com
$ oc explain lokistacks.loki.grafana.com.spec
$ oc explain lokistacks.loki.grafana.com.spec.storage
$ oc explain lokistacks.loki.grafana.com.spec.storage.schemas每个命令都显示了资源规格的深层次，使结构非常明确。
1.1.3. 类型信息
oc explain 也指示每个字段的类型（如字符串、整数或布尔值），允许您验证资源定义是否使用正确的数据类型。
例如：
oc explain lokistacks.loki.grafana.com.spec.size
$ oc explain lokistacks.loki.grafana.com.spec.size
这将显示 size 应使用整数值来定义。
1.1.4. 默认值
如果适用，命令会显示字段的默认值，以便在显式指定时了解哪些值将使用什么值。
再次使用 lokistacks.loki.grafana.com 作为示例：
oc explain lokistacks.spec.template.distributor.replicas
$ oc explain lokistacks.spec.template.distributor.replicas输出示例
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}