安装日志记录

流程

1. 为 Loki Operator 创建一个 Namespace 对象：

   Namespace 对象示例

   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-operators-redhat 

   1

   
     labels:
       openshift.io/cluster-monitoring: "true" 

   2

   Copy to Clipboard Toggle word wrap

   1

   您必须将 openshift-operators-redhat 指定为命名空间。要为 Operator 启用监控，请将 Cluster Monitoring Operator 配置为从 openshift-operators-redhat 命名空间中提取指标，而不是从 openshift-operators 命名空间中提取指标。openshift-operators 命名空间可能会包含社区 operator，这些 operator 不被信任，并可能会发布与 OpenShift Container Platform 指标相同的名称，从而导致冲突。

   2

   指定所示的标签的字符串值，以确保集群监控提取 openshift-operators-redhat 命名空间。

2. 运行以下命令来应用 Namespace 对象：

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

3. 创建 OperatorGroup 对象。

   OperatorGroup 对象示例

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: loki-operator
     namespace: openshift-operators-redhat 

   1

   
   spec:
     upgradeStrategy: Default

   Copy to Clipboard Toggle word wrap

   1

   您必须将 openshift-operators-redhat 指定为命名空间。

4. 运行以下命令来应用 OperatorGroup 对象：

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

5. 为 Loki Operator 创建一个 Subscription 对象：

   Subscription 对象示例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: loki-operator
     namespace: openshift-operators-redhat 

   1

   
   spec:
     channel: stable-6.<y> 

   2

   
     installPlanApproval: Automatic 

   3

   
     name: loki-operator
     source: redhat-operators 

   4

   
     sourceNamespace: openshift-marketplace

   Copy to Clipboard Toggle word wrap

   1

   您必须将 openshift-operators-redhat 指定为命名空间。

   2

   指定 stable-6.<y > 作为频道。

   3

   如果订阅中的批准策略被设置为 Automatic，则更新过程会在所选频道中提供新的 Operator 版本时立即启动。如果批准策略设为 Manual，则必须手动批准待处理的更新。

   4

   指定 redhat-operators 作为值。如果 OpenShift Container Platform 集群安装在受限网络中（也称为断开连接的集群），请指定配置 Operator Lifecycle Manager (OLM)时创建的 CatalogSource 对象的名称。

6. 运行以下命令来应用 Subscription 对象：

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

7. 创建用于部署 LokiStack 的命名空间 对象：

   namespace 对象示例

   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-logging 

   1

   
     labels:
       openshift.io/cluster-monitoring: "true" 

   2

   Copy to Clipboard Toggle word wrap

   1

   openshift-logging 命名空间适用于所有日志记录工作负载。

   2

   指定标签的字符串值，以确保集群监控提取 openshift-logging 命名空间。

8. 运行以下命令来应用 namespace 对象：

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

9. 使用凭据创建 secret 以访问对象存储。例如，创建一个 secret 以访问 Amazon Web Services (AWS) s3。

   Secret 对象示例

   apiVersion: v1
   kind: Secret
   metadata:
     name: logging-loki-s3 

   1

   
     namespace: openshift-logging
   stringData: 

   2

   
     access_key_id: <access_key_id>
     access_key_secret: <access_secret>
     bucketnames: s3-bucket-name
     endpoint: https://s3.eu-central-1.amazonaws.com
     region: eu-central-1

   Copy to Clipboard Toggle word wrap

   1

   使用名称 logging-loki-s3 与 LokiStack 中使用的名称匹配。

   2

   有关 secret 的内容，请参阅 Loki 对象存储部分。

   重要

   如果没有在 s3 存储桶或 LokiStack 自定义资源 (CR) 中定义保留周期，则不会修剪日志，它们会永久保留在 s3 存储桶中，这可能会填满 s3 存储。

10. 运行以下命令来应用 Secret 对象：

    $ oc apply -f <filename>.yaml

    Copy to Clipboard Toggle word wrap

11. 创建 LokiStack CR：

    LokiStack CR 示例

    apiVersion: loki.grafana.com/v1
    kind: LokiStack
    metadata:
      name: logging-loki 

    1

    
      namespace: openshift-logging 

    2

    
    spec:
      size: 1x.small 

    3

    
      storage:
        schemas:
        - version: v13
          effectiveDate: "<yyyy>-<mm>-<dd>" 

    4

    
        secret:
          name: logging-loki-s3 

    5

    
          type: s3 

    6

    
      storageClassName: <storage_class_name> 

    7

    
      tenants:
        mode: openshift-logging 

    8

    Copy to Clipboard Toggle word wrap

    1

    使用名称 logging-loki。

    2

    您必须将 openshift-logging 指定为命名空间。

    3

    指定部署大小。Loki 生产实例支持的大小选项为 1x.extra-small、1x.small 或 1x.medium。另外，从 logging 6.1 开始支持 1x.pico。

    4

    对于新安装，这个日期应设置为 "yesterday"，因为这是 schema 生效的日期。

    5

    指定日志存储 secret 的名称。

    6

    指定对应的存储类型。

    7

    为临时存储指定存储类的名称。为获得最佳性能，请指定分配块存储的存储类。您可以使用 oc get storageclasses 命令列出集群的可用存储类。

    8

    openshift-logging 模式是默认租期模式，其中为日志类型创建一个租户，如 audit、infrastructure 和 application。这为单个用户和用户组启用对不同的日志流的访问控制。

12. 运行以下命令来应用 LokiStack CR 对象：

    $ oc apply -f <filename>.yaml

    Copy to Clipboard Toggle word wrap

流程

1. 创建一个 OperatorGroup 对象：

   OperatorGroup 对象示例

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: cluster-logging
     namespace: openshift-logging 

   1

   
   spec:
     upgradeStrategy: Default

   Copy to Clipboard Toggle word wrap

   1

   您必须将 openshift-logging 指定为命名空间。

2. 运行以下命令来应用 OperatorGroup 对象：

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

3. 为 Red Hat OpenShift Logging Operator 创建 Subscription 对象：

   Subscription 对象示例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: cluster-logging
     namespace: openshift-logging 

   1

   
   spec:
     channel: stable-6.<y> 

   2

   
     installPlanApproval: Automatic 

   3

   
     name: cluster-logging
     source: redhat-operators 

   4

   
     sourceNamespace: openshift-marketplace

   Copy to Clipboard Toggle word wrap

   1

   您必须将 openshift-logging 指定为命名空间。

   2

   指定 stable-6.<y > 作为频道。

   3

   如果订阅中的批准策略被设置为 Automatic，则更新过程会在所选频道中提供新的 Operator 版本时立即启动。如果批准策略设为 Manual，则必须手动批准待处理的更新。

   4

   指定 redhat-operators 作为值。如果 OpenShift Container Platform 集群安装在受限网络中（也称为断开连接的集群），请指定配置 Operator Lifecycle Manager (OLM)时创建的 CatalogSource 对象的名称。

4. 运行以下命令来应用 Subscription 对象：

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

5. 创建日志收集器要使用的服务帐户：

   $ oc create sa logging-collector -n openshift-logging

   Copy to Clipboard Toggle word wrap

6. 为收集器的服务帐户分配所需的权限，以便能够收集和转发日志。在本例中，收集器提供从基础架构和应用程序日志收集日志的权限。

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

   Copy to Clipboard Toggle word wrap

7. 创建 ClusterLogForwarder CR：

   ClusterLogForwarder CR 示例

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   metadata:
     name: instance
     namespace: openshift-logging 

   1

   
   spec:
     serviceAccount:
       name: logging-collector 

   2

   
     outputs:
     - name: lokistack-out
       type: lokiStack 

   3

   
       lokiStack:
         target: 

   4

   
           name: logging-loki
           namespace: openshift-logging
         authentication:
           token:
             from: serviceAccount
       tls:
         ca:
           key: service-ca.crt
           configMapName: openshift-service-ca.crt
     pipelines:
     - name: infra-app-logs
       inputRefs: 

   5

   
       - application
       - infrastructure
       outputRefs:
       - lokistack-out

   Copy to Clipboard Toggle word wrap

   1

   您必须指定 openshift-logging 命名空间。

   2

   指定之前创建的服务帐户的名称。

   3

   选择 lokiStack 输出类型，将日志发送到 LokiStack 实例。

   4

   将 ClusterLogForwarder 指向之前创建的 LokiStack 实例。

   5

   选择您要发送到 LokiStack 实例的日志输出类型。

8. 运行以下命令来应用 ClusterLogForwarder CR 对象：

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

验证

1. 运行以下命令来验证安装。

   $ oc get pods -n openshift-logging

   Copy to Clipboard Toggle word wrap

   输出示例

   $ oc get pods -n openshift-logging
   NAME                                               READY   STATUS    RESTARTS   AGE
   cluster-logging-operator-fb7f7cf69-8jsbq           1/1     Running   0          98m
   instance-222js                                     2/2     Running   0          18m
   instance-g9ddv                                     2/2     Running   0          18m
   instance-hfqq8                                     2/2     Running   0          18m
   instance-sphwg                                     2/2     Running   0          18m
   instance-vv7zn                                     2/2     Running   0          18m
   instance-wk5zz                                     2/2     Running   0          18m
   logging-loki-compactor-0                           1/1     Running   0          42m
   logging-loki-distributor-7d7688bcb9-dvcj8          1/1     Running   0          42m
   logging-loki-gateway-5f6c75f879-bl7k9              2/2     Running   0          42m
   logging-loki-gateway-5f6c75f879-xhq98              2/2     Running   0          42m
   logging-loki-index-gateway-0                       1/1     Running   0          42m
   logging-loki-ingester-0                            1/1     Running   0          42m
   logging-loki-querier-6b7b56bccc-2v9q4              1/1     Running   0          42m
   logging-loki-query-frontend-84fb57c578-gq2f7       1/1     Running   0          42m

   Copy to Clipboard Toggle word wrap

流程

1. 在 OpenShift Container Platform Web 控制台 Administrator 视角中，进入 Operators → OperatorHub。

2. 在 Filter by keyword 字段中输入 Loki Operator。点可用 Operator 列表中的 Loki Operator，然后点 Install。

   重要

   红帽不支持社区版本的 Loki Operator。

3. 选择 stable-x.y 作为 更新频道。

   Loki Operator 必须部署到全局 Operator 组命名空间 openshift-operators-redhat，因此已选择了 Installation mode 和 Installed Namespace。如果此命名空间尚不存在，则会为您创建它。

4. 选择 Enable Operator recommended cluster monitoring on this namespace。

   这个选项在 Namespace 对象中设置 openshift.io/cluster-monitoring: "true" 标签。您必须设置这个选项，以确保集群监控提取 openshift-operators-redhat 命名空间。

5. 对于 Update approval，请选择 Automatic，然后点 Install。

   如果订阅中的批准策略被设置为 Automatic，则更新过程会在所选频道中提供新的 Operator 版本时立即启动。如果批准策略设为 Manual，则必须手动批准待处理的更新。

   注意

   Operator 可能会在安装完成前显示 Failed 状态。如果 Operator 安装完成并显示 InstallSucceeded 信息，请刷新页面。

6. 安装 Operator 时，创建部署日志存储的命名空间。

   1. 单击屏幕右上角的 +，以访问 Import YAML 页面。

   2. 为 openshift-logging 命名空间添加 YAML 定义：

      namespace 对象示例

      apiVersion: v1
      kind: Namespace
      metadata:
        name: openshift-logging 

      1

      
        labels:
          openshift.io/cluster-monitoring: "true" 

      2

      Copy to Clipboard Toggle word wrap

      1

      openshift-logging 命名空间适用于所有日志记录工作负载。

      2

      指定标签的字符串值，以确保集群监控提取 openshift-logging 命名空间。

   3. 点 Create。

7. 使用凭据创建 secret 以访问对象存储。

   1. 单击屏幕右上角的 +，以访问 Import YAML 页面。

   2. 为 secret 添加 YAML 定义。例如，创建一个 secret 以访问 Amazon Web Services (AWS) s3:

      Secret 对象示例

      apiVersion: v1
      kind: Secret
      metadata:
        name: logging-loki-s3 

      1

      
        namespace: openshift-logging 

      2

      
      stringData: 

      3

      
        access_key_id: <access_key_id>
        access_key_secret: <access_key>
        bucketnames: s3-bucket-name
        endpoint: https://s3.eu-central-1.amazonaws.com
        region: eu-central-1

      Copy to Clipboard Toggle word wrap

      1

      记录下用于 secret logging-loki-s3 的名称，以便稍后在创建 LokiStack 资源时使用它。

      2

      将命名空间设置为 openshift-logging，这将是用于部署 LokiStack 的命名空间。

      3

      有关 secret 的内容，请参阅 Loki 对象存储部分。

      重要

      如果没有在 s3 存储桶或 LokiStack 自定义资源 (CR) 中定义保留周期，则不会修剪日志，它们会永久保留在 s3 存储桶中，这可能会填满 s3 存储。

   3. 点 Create。
8. 进入 Installed Operators 页面。在 Provided APIs 下选择 Loki Operator，找到 LokiStack 资源，再点 Create Instance。

9. 选择 YAML 视图，然后使用以下模板来创建 LokiStack CR：

   LokiStack CR 示例

   apiVersion: loki.grafana.com/v1
   kind: LokiStack
   metadata:
     name: logging-loki 

   1

   
     namespace: openshift-logging 

   2

   
   spec:
     size: 1x.small 

   3

   
     storage:
       schemas:
       - version: v13
         effectiveDate: "<yyyy>-<mm>-<dd>"
       secret:
         name: logging-loki-s3 

   4

   
         type: s3 

   5

   
     storageClassName: <storage_class_name> 

   6

   
     tenants:
       mode: openshift-logging 

   7

   Copy to Clipboard Toggle word wrap

   1

   使用名称 logging-loki。

   2

   您必须将 openshift-logging 指定为命名空间。

   3

   指定部署大小。Loki 生产实例支持的大小选项为 1x.extra-small、1x.small 或 1x.medium。另外，从 logging 6.1 开始支持 1x.pico。

   4

   指定日志存储 secret 的名称。

   5

   指定对应的存储类型。

   6

   为临时存储指定存储类的名称。为获得最佳性能，请指定分配块存储的存储类。您可以使用 oc get storageclasses 命令列出集群的可用存储类。

   7

   openshift-logging 模式是默认租期模式，其中为日志类型创建一个租户，如 audit、infrastructure 和 application。这为单个用户和用户组启用对不同的日志流的访问控制。

10. 点 Create。

验证

1. 在 LokiStack 选项卡中，您会看到 LokiStack 实例。
2. 在 Status 列中，验证您看到消息 Condition: Ready 带有绿色勾号。

流程

1. 在 OpenShift Container Platform Web 控制台 Administrator 视角中，进入 Operators → OperatorHub。
2. 在 Filter by keyword 字段中输入 Red Hat OpenShift Logging Operator。在可用的 Operator 列表中点 Red Hat OpenShift Logging Operator，然后点 Install。

3. 选择 stable-x.y 作为 更新频道。Version 字段中已选中最新版本。

   Red Hat OpenShift Logging Operator 必须部署到日志记录命名空间 openshift-logging 中，因此已选择了 Installation mode 和 Installed Namespace。如果此命名空间尚不存在，则会为您创建它。

4. 选择 Enable Operator recommended cluster monitoring on this namespace。

   这个选项在 Namespace 对象中设置 openshift.io/cluster-monitoring: "true" 标签。您必须选择这个选项，以确保集群监控提取 openshift-logging 命名空间。

5. 对于 Update approval，请选择 Automatic，然后点 Install。

   如果订阅中的批准策略被设置为 Automatic，则更新过程会在所选频道中提供新的 Operator 版本时立即启动。如果批准策略设为 Manual，则必须手动批准待处理的更新。

   注意

   Operator 可能会在安装完成前显示 Failed 状态。如果 Operator 安装完成并显示 InstallSucceeded 信息，请刷新页面。

6. 安装 Operator 时，创建日志收集器用于收集日志的服务帐户。

   1. 单击屏幕右上角的 +，以访问 Import YAML 页面。

   2. 输入服务帐户的 YAML 定义。

      ServiceAccount 对象示例

      apiVersion: v1
      kind: ServiceAccount
      metadata:
        name: logging-collector 

      1

      
        namespace: openshift-logging 

      2

      Copy to Clipboard Toggle word wrap

      1

      请注意，在创建 ClusterLogForwarder 资源时，用于服务帐户 logging-collector 的名称，以便稍后使用它。

      2

      将命名空间设置为 openshift-logging，因为这是用于部署 ClusterLogForwarder 资源的命名空间。

   3. 点 Create 按钮。

7. 创建 ClusterRoleBinding 对象，为日志收集器授予访问您要收集的日志并写入日志存储（如基础架构和应用程序日志）所需的权限。

   1. 单击屏幕右上角的 +，以访问 Import YAML 页面。

   2. 输入 ClusterRoleBinding 资源的 YAML 定义。

      ClusterRoleBinding 资源示例

      apiVersion: rbac.authorization.k8s.io/v1
      kind: ClusterRoleBinding
      metadata:
        name: logging-collector:write-logs
      roleRef:
        apiGroup: rbac.authorization.k8s.io
        kind: ClusterRole
        name: logging-collector-logs-writer 

      1

      
      subjects:
      - kind: ServiceAccount
        name: logging-collector
        namespace: openshift-logging
      ---
      apiVersion: rbac.authorization.k8s.io/v1
      kind: ClusterRoleBinding
      metadata:
        name: logging-collector:collect-application
      roleRef:
        apiGroup: rbac.authorization.k8s.io
        kind: ClusterRole
        name: collect-application-logs 

      2

      
      subjects:
      - kind: ServiceAccount
        name: logging-collector
        namespace: openshift-logging
      ---
      apiVersion: rbac.authorization.k8s.io/v1
      kind: ClusterRoleBinding
      metadata:
        name: logging-collector:collect-infrastructure
      roleRef:
        apiGroup: rbac.authorization.k8s.io
        kind: ClusterRole
        name: collect-infrastructure-logs 

      3

      
      subjects:
      - kind: ServiceAccount
        name: logging-collector
        namespace: openshift-logging

      Copy to Clipboard Toggle word wrap

      1

      允许日志收集器将日志写入 LokiStack 的集群角色。

      2

      允许日志收集器从应用程序收集日志的集群角色。

      3

      允许日志收集器从基础架构收集日志的集群角色。

   3. 点 Create 按钮。
8. 进入 Operators → Installed Operators 页面。选择 operator 并点 All instances 选项卡。
9. 为服务帐户授予所需的权限后，进入 Installed Operators 页面。在 Provided APIs 下选择 Red Hat OpenShift Logging Operator，找到 ClusterLogForwarder 资源，再点 Create Instance。

10. 选择 YAML 视图，然后使用以下模板创建一个 ClusterLogForwarder CR：

    ClusterLogForwarder CR 示例

    apiVersion: observability.openshift.io/v1
    kind: ClusterLogForwarder
    metadata:
      name: instance
      namespace: openshift-logging 

    1

    
    spec:
      serviceAccount:
        name: logging-collector 

    2

    
      outputs:
      - name: lokistack-out
        type: lokiStack 

    3

    
        lokiStack:
          target: 

    4

    
            name: logging-loki
            namespace: openshift-logging
          authentication:
            token:
              from: serviceAccount
        tls:
          ca:
            key: service-ca.crt
            configMapName: openshift-service-ca.crt
      pipelines:
      - name: infra-app-logs
        inputRefs: 

    5

    
        - application
        - infrastructure
        outputRefs:
        - lokistack-out

    Copy to Clipboard Toggle word wrap

    1

    您必须将 openshift-logging 指定为命名空间。

    2

    指定之前创建的服务帐户的名称。

    3

    选择 lokiStack 输出类型，将日志发送到 LokiStack 实例。

    4

    将 ClusterLogForwarder 指向之前创建的 LokiStack 实例。

    5

    选择您要发送到 LokiStack 实例的日志输出类型。

11. 点 Create。

验证

1. 在 ClusterLogForwarder 选项卡中，验证您是否看到 ClusterLogForwarder 实例。

2. 在 Status 列中，验证您看到了信息：

   • condition: observability.openshift.io/Authorized
   • observability.openshift.io/Valid, Ready