4.2. 使用 OpenTelemetry 快速开始

流程

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 的内容因使用的对象存储而异。如需更多信息，请参阅"Secrets 和 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

   Copy to Clipboard Toggle word wrap
   注意

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

5. 允许收集器的服务帐户收集日志：

   $ oc project openshift-logging

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   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
     annotations:
       observability.openshift.io/tech-preview-otlp-output: "enabled" 

   1

   
   spec:
     serviceAccount:
       name: collector
     outputs:
     - name: loki-otlp
       type: lokiStack 

   2

   
       lokiStack:
         target:
           name: logging-loki
           namespace: openshift-logging
         dataModel: Otel 

   3

   
         authentication:
           token:
             from: serviceAccount
       tls:
         ca:
           key: service-ca.crt
           configMapName: openshift-service-ca.crt
     pipelines:
     - name: my-pipeline
       inputRefs:
       - application
       - infrastructure
       outputRefs:
       - loki-otlp

   Copy to Clipboard Toggle word wrap

   1

   使用注解启用 Otel 数据模型，它是一个技术预览功能。

   2

   将输出类型定义为 lokiStack。

   3

   指定 OpenTelemetry 数据模型。

   注意

   当 dataModel 为 Otel 时，您无法使用 lokiStack.labelKeys。要在 dataModel 为 Otel 时实现类似的功能，请参阅"为 OTLP 数据生成"配置 LokiStack。