4.2. Logging 6.0
ClusterLogForwarder
自定义资源(CR)是日志收集和转发的核心配置点。
4.2.1. 输入和输出 复制链接链接已复制到粘贴板!
输入指定要转发的日志源。日志记录提供以下内置输入类型,它们从集群的不同部分选择日志:
-
application
-
receiver
-
infrastructure
-
audit
您还可以根据命名空间或 pod 标签定义自定义输入,以微调日志选择。
输出定义发送日志的目的地。每个输出类型都有自己的一组配置选项,允许您自定义行为和身份验证设置。
4.2.2. 接收器输入类型 复制链接链接已复制到粘贴板!
接收器输入类型可让日志记录系统接受来自外部源的日志。它支持两种接收日志的格式:http
和 syslog
。
ReceiverSpec
字段定义接收器输入的配置。
4.2.3. 管道和过滤器 复制链接链接已复制到粘贴板!
Pipelines 决定从输入到输出的日志流。管道由一个或多个输入 refs、输出 refs 和可选过滤器 refs 组成。您可以使用过滤器来转换或丢弃管道中的日志消息。过滤器顺序很重要,随着顺序应用,较早的过滤器可能会阻止日志消息到达后续阶段。
4.2.4. Operator 行为 复制链接链接已复制到粘贴板!
Cluster Logging Operator 根据 managementState
字段管理收集器的部署和配置:
-
当设置为
Managed
(默认)时,Operator 会主动管理日志记录资源以匹配 spec 中定义的配置。 -
当设置为
Unmanaged
时,Operator 不执行任何操作,供您手动管理日志记录组件。
4.2.5. 验证 复制链接链接已复制到粘贴板!
日志记录包括广泛的验证规则和默认值,以确保平稳配置体验。ClusterLogForwarder
资源对必填字段、字段之间的依赖关系和输入值格式强制验证检查。为某些字段提供默认值,从而减少了常见场景中明确配置的需求。
4.2.6. 快速入门 复制链接链接已复制到粘贴板!
先决条件
-
您可以使用
cluster-admin
权限访问 Red Hat OpenShift Service on AWS 经典架构集群。 -
已安装 OpenShift CLI(
oc
)。 - 您可以访问受支持的对象存储。例如,AWS S3, Google Cloud Storage, Azure, Swift, Minio, 或 OpenShift Data Foundation。
流程
-
从 OperatorHub 安装
Red Hat OpenShift Logging Operator
、Loki Operator
和Cluster Observability Operator (COO)
。 创建 secret 以访问现有的对象存储桶:
AWS 的命令示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在
openshift-logging
命名空间中创建LokiStack
自定义资源(CR):Copy to Clipboard Copied! Toggle word wrap Toggle overflow 为收集器创建服务帐户:
oc create sa collector -n openshift-logging
$ oc create sa collector -n openshift-logging
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 将
ClusterRole
绑定到服务帐户:oc adm policy add-cluster-role-to-user logging-collector-logs-writer -z collector -n openshift-logging
$ oc adm policy add-cluster-role-to-user logging-collector-logs-writer -z collector -n openshift-logging
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 创建一个
UIPlugin
以启用 Observe 选项卡中的 Log 部分:Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在 collector 服务帐户中添加额外的角色:
oc adm policy add-cluster-role-to-user collect-application-logs -z collector -n openshift-logging
$ oc adm policy add-cluster-role-to-user collect-application-logs -z collector -n openshift-logging
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc adm policy add-cluster-role-to-user collect-audit-logs -z collector -n openshift-logging
$ oc adm policy add-cluster-role-to-user collect-audit-logs -z collector -n openshift-logging
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc adm policy add-cluster-role-to-user collect-infrastructure-logs -z collector -n openshift-logging
$ oc adm policy add-cluster-role-to-user collect-infrastructure-logs -z collector -n openshift-logging
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 创建一个
ClusterLogForwarder
CR 来配置日志转发:Copy to Clipboard Copied! Toggle word wrap Toggle overflow
验证
- 验证日志是否在 Red Hat OpenShift Service on AWS 经典架构 web 控制台的 Observe 选项卡的 Log 部分可见。