第 4 章 快速启动

流程

1. 从 OperatorHub 安装 Red Hat OpenShift Logging Operator、Loki Operator 和 Cluster Observability Operator (COO)。

2. 在 openshift-logging 命名空间中创建 LokiStack 自定义资源(CR)：

   apiVersion: loki.grafana.com/v1
   kind: LokiStack
   metadata:
     name: logging-loki
     namespace: openshift-logging
   spec:
     managementState: Managed
     size: 1x.extra-small
     storage:
       schemas:
       - effectiveDate: '2024-10-01'
         version: v13
       secret:
         name: logging-loki-s3
         type: s3
     storageClassName: gp3-csi
     tenants:
       mode: openshift-logging

   Copy to Clipboard Toggle word wrap
   注意

   确保事先创建 logging-loki-s3 secret。此 secret 的内容因使用的对象存储而异。如需更多信息，请参阅 Secret 和 TLS 配置。

3. 为收集器创建服务帐户：

   $ oc create sa collector -n openshift-logging

   Copy to Clipboard Toggle word wrap

4. 允许收集器的服务帐户将数据写入 LokiStack CR：

   $ oc adm policy add-cluster-role-to-user logging-collector-logs-writer -z collector -n openshift-logging

   Copy to Clipboard Toggle word wrap
   注意

   ClusterRole 资源是在 Cluster Logging Operator 安装过程中自动创建的，不需要手动创建。

5. 要收集日志，请运行以下命令使用收集器的服务帐户：

   $ oc adm policy add-cluster-role-to-user collect-application-logs -z collector -n openshift-logging

   Copy to Clipboard Toggle word wrap

   $ oc adm policy add-cluster-role-to-user collect-audit-logs -z collector -n openshift-logging

   Copy to Clipboard Toggle word wrap

   $ oc adm policy add-cluster-role-to-user collect-infrastructure-logs -z collector -n openshift-logging

   Copy to Clipboard Toggle word wrap
   注意

   示例将收集器绑定到所有三个角色（应用程序、基础架构和审计），但默认情况下，仅收集应用和基础架构日志。要收集审计日志，请更新 ClusterLogForwarder 配置使其包含它们。根据您的环境所需的特定日志类型，分配角色。

6. 创建一个 UIPlugin CR，以启用 Observe 选项卡中的 Log 部分：

   apiVersion: observability.openshift.io/v1alpha1
   kind: UIPlugin
   metadata:
     name: logging
   spec:
     type: Logging
     logging:
       lokiStack:
         name: logging-loki

   Copy to Clipboard Toggle word wrap

7. 创建一个 ClusterLogForwarder CR 来配置日志转发：

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   metadata:
     name: collector
     namespace: openshift-logging
   spec:
     serviceAccount:
       name: collector
     outputs:
     - name: default-lokistack
       type: lokiStack
       lokiStack:
         authentication:
           token:
             from: serviceAccount
         target:
           name: logging-loki
           namespace: openshift-logging
       tls:
         ca:
           key: service-ca.crt
           configMapName: openshift-service-ca.crt
     pipelines:
     - name: default-logstore
       inputRefs:
       - application
       - infrastructure
       outputRefs:
       - default-lokistack

   Copy to Clipboard Toggle word wrap
   注意

   dataModel 字段是可选的，默认保留未设置(dataModel: "")。这允许 Cluster Logging Operator (CLO) 自动选择数据模型。目前，当字段未设置时，CLO 会默认使用 ViaQ 模型，但这将在以后的版本中有所变化。指定 dataModel: ViaQ 可确保在默认设置有变化时配置仍然可以保持兼容。