流程

1. 安装红帽构建的 OpenTelemetry Operator：

   1. 进入 Operators → OperatorHub，搜索 红帽构建的 OpenTelemetry Operator。

   2. 选择 Red Hat build of OpenTelemetry Operator，provided by Red Hat → Install → Install → View Operator.

      重要

      这会使用默认预设置来安装 Operator：

      • Update channel → stable
      • Installation mode → All namespaces on the cluster
      • Installed Namespace → openshift-operators
      • Update approval → Automatic
   3. 在安装的 Operator 页面的 Details 选项卡中，在 ClusterServiceVersion details 下验证安装 Status 是否为 Succeeded。
2. 通过转至 Home → Projects → Create Project，为您在下一步中创建的 OpenTelemetry Collector 实例创建一个项目。

3. 创建 OpenTelemetry Collector 实例。

   1. 进入 Operators → Installed Operators。
   2. 选择 OpenTelemetry Collector → Create OpenTelemetry Collector → YAML view。

   3. 在 YAML 视图中，使用 OTLP、Jaeger、Zipkin receivers 和 debug exporter 自定义 OpenTelemetryCollector 自定义资源(CR)。

      apiVersion: opentelemetry.io/v1alpha1
      kind: OpenTelemetryCollector
      metadata:
        name: otel
        namespace: <project_of_opentelemetry_collector_instance>
      spec:
        mode: deployment
        config: |
          receivers:
            otlp:
              protocols:
                grpc:
                http:
            jaeger:
              protocols:
                grpc:
                thrift_binary:
                thrift_compact:
                thrift_http:
            zipkin:
          processors:
            batch:
            memory_limiter:
              check_interval: 1s
              limit_percentage: 50
              spike_limit_percentage: 30
          exporters:
            debug:
          service:
            pipelines:
              traces:
                receivers: [otlp,jaeger,zipkin]
                processors: [memory_limiter,batch]
                exporters: [debug]

   4. 选择 Create。

验证

1. 使用 Project: 下拉列表选择 OpenTelemetry Collector 实例的项目。
2. 进入 Operators → Installed Operators，以验证 OpenTelemetry Collector 实例的 Status 是否为 Condition: Ready。
3. 进入 Workloads → Pods，以验证 OpenTelemetry Collector 实例的所有组件 pod 都在运行。

流程

1. 安装红帽构建的 OpenTelemetry Operator：

   1. 运行以下命令，为红帽构建的 OpenTelemetry Operator 创建项目：

      $ oc apply -f - << EOF
      apiVersion: project.openshift.io/v1
      kind: Project
      metadata:
        labels:
          kubernetes.io/metadata.name: openshift-opentelemetry-operator
          openshift.io/cluster-monitoring: "true"
        name: openshift-opentelemetry-operator
      EOF

   2. 运行以下命令来创建 Operator 组：

      $ oc apply -f - << EOF
      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: openshift-opentelemetry-operator
        namespace: openshift-opentelemetry-operator
      spec:
        upgradeStrategy: Default
      EOF

   3. 运行以下命令来创建订阅：

      $ oc apply -f - << EOF
      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: opentelemetry-product
        namespace: openshift-opentelemetry-operator
      spec:
        channel: stable
        installPlanApproval: Automatic
        name: opentelemetry-product
        source: redhat-operators
        sourceNamespace: openshift-marketplace
      EOF

   4. 运行以下命令检查 Operator 状态：

      $ oc get csv -n openshift-opentelemetry-operator

2. 为您要在后续步骤中创建的 OpenTelemetry Collector 实例创建一个您选择的项目：

   • 要创建没有元数据的项目，请运行以下命令：

     $ oc new-project <project_of_opentelemetry_collector_instance>

   • 要使用元数据创建项目，请运行以下命令：

     $ oc apply -f - << EOF
     apiVersion: project.openshift.io/v1
     kind: Project
     metadata:
       name: <project_of_opentelemetry_collector_instance>
     EOF

3. 在为您创建的项目中创建一个 OpenTelemetry Collector 实例。

   注意

   您可以在同一集群中的独立项目中创建多个 OpenTelemetry Collector 实例。

   1. 使用 OTLP、Jaeger 和 Zipkin receivers 和 debug exporter 自定义 OpenTelemetry Collector 自定义资源 (CR)：

      apiVersion: opentelemetry.io/v1alpha1
      kind: OpenTelemetryCollector
      metadata:
        name: otel
        namespace: <project_of_opentelemetry_collector_instance>
      spec:
        mode: deployment
        config: |
          receivers:
            otlp:
              protocols:
                grpc:
                http:
            jaeger:
              protocols:
                grpc:
                thrift_binary:
                thrift_compact:
                thrift_http:
            zipkin:
          processors:
            batch:
            memory_limiter:
              check_interval: 1s
              limit_percentage: 50
              spike_limit_percentage: 30
          exporters:
            debug:
          service:
            pipelines:
              traces:
                receivers: [otlp,jaeger,zipkin]
                processors: [memory_limiter,batch]
                exporters: [debug]

   2. 运行以下命令来应用自定义 CR：

      $ oc apply -f - << EOF
      <OpenTelemetryCollector_custom_resource>
      EOF

验证

1. 运行以下命令，验证 OpenTelemetry Collector pod 的 status.phase 是否为 Running，条件为 type: Ready ：

   $ oc get pod -l app.kubernetes.io/managed-by=opentelemetry-operator,app.kubernetes.io/instance=<namespace>.<instance_name> -o yaml

2. 运行以下命令来获取 OpenTelemetry Collector 服务：

   $ oc get service -l app.kubernetes.io/managed-by=opentelemetry-operator,app.kubernetes.io/instance=<namespace>.<instance_name>

流程

1. 为 OpenTelemetry Collector 实例创建项目。

   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: observability

2. 创建一个服务帐户。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: otel-collector-sidecar
     namespace: observability

3. 为 k8sattributes 和 resourcedetection 处理器的服务帐户授予权限。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: otel-collector
   rules:
   - apiGroups: ["", "config.openshift.io"]
     resources: ["pods", "namespaces", "infrastructures", "infrastructures/status"]
     verbs: ["get", "watch", "list"]
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: otel-collector
   subjects:
   - kind: ServiceAccount
     name: otel-collector-sidecar
     namespace: observability
   roleRef:
     kind: ClusterRole
     name: otel-collector
     apiGroup: rbac.authorization.k8s.io

4. 将 OpenTelemetry Collector 部署为 sidecar。

   apiVersion: opentelemetry.io/v1alpha1
   kind: OpenTelemetryCollector
   metadata:
     name: otel
     namespace: observability
   spec:
     serviceAccount: otel-collector-sidecar
     mode: sidecar
     config: |
       serviceAccount: otel-collector-sidecar
       receivers:
         otlp:
           protocols:
             grpc:
             http:
       processors:
         batch:
         memory_limiter:
           check_interval: 1s
           limit_percentage: 50
           spike_limit_percentage: 30
         resourcedetection:
           detectors: [openshift]
           timeout: 2s
       exporters:
         otlp:
           endpoint: "tempo-<example>-gateway:8090" 1
           tls:
             insecure: true
       service:
         pipelines:
           traces:
             receivers: [jaeger]
             processors: [memory_limiter, resourcedetection, batch]
             exporters: [otlp]

   1

   这指向使用 Tempo Operator 部署的 <example> TempoStack 实例的网关。

5. 使用 otel-collector-sidecar 服务帐户创建部署。
6. 在您的 Deployment 对象中添加 sidecar.opentelemetry.io/inject: "true" 注解。这将注入所有需要的环境变量，将工作负载中的数据发送到 OpenTelemetry Collector 实例。

流程

1. 为 OpenTelemetry Collector 实例创建项目。

   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: observability

2. 创建一个服务帐户。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: otel-collector-deployment
     namespace: observability

3. 为 k8sattributes 和 resourcedetection 处理器的服务帐户授予权限。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: otel-collector
   rules:
   - apiGroups: ["", "config.openshift.io"]
     resources: ["pods", "namespaces", "infrastructures", "infrastructures/status"]
     verbs: ["get", "watch", "list"]
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: otel-collector
   subjects:
   - kind: ServiceAccount
     name: otel-collector-deployment
     namespace: observability
   roleRef:
     kind: ClusterRole
     name: otel-collector
     apiGroup: rbac.authorization.k8s.io

4. 使用 OpenTelemetryCollector 自定义资源部署 OpenTelemetry Collector 实例。

   apiVersion: opentelemetry.io/v1alpha1
   kind: OpenTelemetryCollector
   metadata:
     name: otel
     namespace: observability
   spec:
     mode: deployment
     serviceAccount: otel-collector-deployment
     config: |
       receivers:
         jaeger:
           protocols:
             grpc:
             thrift_binary:
             thrift_compact:
             thrift_http:
         opencensus:
         otlp:
           protocols:
             grpc:
             http:
         zipkin:
       processors:
         batch:
         k8sattributes:
         memory_limiter:
           check_interval: 1s
           limit_percentage: 50
           spike_limit_percentage: 30
         resourcedetection:
           detectors: [openshift]
       exporters:
         otlp:
           endpoint: "tempo-<example>-distributor:4317" 1
           tls:
             insecure: true
       service:
         pipelines:
           traces:
             receivers: [jaeger, opencensus, otlp, zipkin]
             processors: [memory_limiter, k8sattributes, resourcedetection, batch]
             exporters: [otlp]

   1

   这指向使用 Tempo Operator 部署的 <example> TempoStack 实例的网关。

5. 使用您的检测应用程序设置容器中的环境变量。

   Name	描述	默认值
   OTEL_SERVICE_NAME	设置 service.name 资源属性的值。	""
   OTEL_EXPORTER_OTLP_ENDPOINT	带有可选指定端口号的任何信号类型的基本端点 URL。	https://localhost:4317
   OTEL_EXPORTER_OTLP_CERTIFICATE	gRPC 客户端的 TLS 凭证的证书文件的路径。	https://localhost:4317
   OTEL_TRACES_SAMPLER	用于 trace 的 sampler。	parentbased_always_on
   OTEL_EXPORTER_OTLP_PROTOCOL	OTLP 导出器的传输协议。	grpc
   OTEL_EXPORTER_OTLP_TIMEOUT	OTLP 导出器等待每个批处理导出的最大时间间隔。	10s
   OTEL_EXPORTER_OTLP_INSECURE	为 gRPC 请求禁用客户端传输安全性。HTTPS 模式会覆盖它。	False

流程

1. 在 OpenTelemetryCollector 自定义资源(CR) 中设置相关的日志级别：

     config: |
       service:
         telemetry:
           logs:
             level: debug 1

   1

   收集器的日志级别。支持的值包括 info、warn、error 或 debug。默认为 info。

2. 使用 oc logs 命令或 Web 控制台来检索日志。

流程

1. 通过在 OpenTelemetryCollector 自定义资源中添加以下行来启用 telemetry 服务：

     config: |
       service:
         telemetry:
           metrics:
             address: ":8888" 1

   1

   公开内部收集器指标的地址。默认值为 :8888。

1. 运行以下命令来检索指标，该命令使用端口转发 Collector pod：

   $ oc port-forward <collector_pod>

2. 访问位于 http://localhost:8888/metrics 的指标端点。

流程

1. 配置 OpenTelemetryCollector 自定义资源，如下所示：

     config: |
       exporters:
         debug:
           verbosity: detailed
       service:
         pipelines:
           traces:
             exporters: [debug]
           metrics:
             exporters: [debug]
           logs:
             exporters: [debug]

2. 使用 oc logs 命令或 Web 控制台将日志导出到标准输出。

流程

1. 将 OpenTelemetry Collector 配置为 sidecar。

   apiVersion: opentelemetry.io/v1alpha1
   kind: OpenTelemetryCollector
   metadata:
     name: otel
     namespace: <otel-collector-namespace>
   spec:
     mode: sidecar
     config: |
       receivers:
         jaeger:
           protocols:
             grpc:
             thrift_binary:
             thrift_compact:
             thrift_http:
       processors:
         batch:
         memory_limiter:
           check_interval: 1s
           limit_percentage: 50
           spike_limit_percentage: 30
         resourcedetection:
           detectors: [openshift]
           timeout: 2s
       exporters:
         otlp:
           endpoint: "tempo-<example>-gateway:8090" 1
           tls:
             insecure: true
       service:
         pipelines:
           traces:
             receivers: [jaeger]
             processors: [memory_limiter, resourcedetection, batch]
             exporters: [otlp]

   1

   此端点指向使用 Tempo Operator 部署的 <example> TempoStack 实例的网关。

2. 创建用于运行应用程序的服务帐户。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: otel-collector-sidecar

3. 为某些处理器所需的权限创建集群角色。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: otel-collector-sidecar
   rules:
     1
   - apiGroups: ["config.openshift.io"]
     resources: ["infrastructures", "infrastructures/status"]
     verbs: ["get", "watch", "list"]

   1

   resourcedetectionprocessor 需要基础架构和基础架构/状态的权限。

4. 创建 ClusterRoleBinding 来为服务帐户设置权限。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: otel-collector-sidecar
   subjects:
   - kind: ServiceAccount
     name: otel-collector-deployment
     namespace: otel-collector-example
   roleRef:
     kind: ClusterRole
     name: otel-collector
     apiGroup: rbac.authorization.k8s.io

5. 将 OpenTelemetry Collector 部署为 sidecar。
6. 通过从 Deployment 对象中删除 "sidecar.jaegertracing.io/inject": "true" 注解，从应用程序中删除注入的 Jaeger Agent。
7. 通过将 sidecar.opentelemetry.io/inject: "true" 注解添加到 Deployment 对象的 .spec.template.metadata.annotations 字段来启用 OpenTelemetry sidecar 自动注入。
8. 使用为应用程序部署创建的服务帐户，以允许处理器获取正确的信息并将其添加到您的追踪中。

流程

1. 配置 OpenTelemetry Collector 部署。

2. 创建部署 OpenTelemetry Collector 的项目。

   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: observability

3. 创建用于运行 OpenTelemetry Collector 实例的服务帐户。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: otel-collector-deployment
     namespace: observability

4. 创建集群角色，以设置处理器所需的权限。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: otel-collector
   rules:
     1
     2
   - apiGroups: ["", "config.openshift.io"]
     resources: ["pods", "namespaces", "infrastructures", "infrastructures/status"]
     verbs: ["get", "watch", "list"]

   1

   k8sattributesprocessor 需要 pods 和 namespaces 资源的权限。

   2

   resourcedetectionprocessor 需要 infrastructures 和 infrastructures/status 的权限。

5. 创建 ClusterRoleBinding 来为服务帐户设置权限。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: otel-collector
   subjects:
   - kind: ServiceAccount
     name: otel-collector-deployment
     namespace: observability
   roleRef:
     kind: ClusterRole
     name: otel-collector
     apiGroup: rbac.authorization.k8s.io

6. 创建 OpenTelemetry Collector 实例。

   注意

   此收集器会将 trace 导出至 TempoStack 实例。您必须使用 Red Hat Tempo Operator 创建 TempoStack 实例，并放在正确的端点中。

   apiVersion: opentelemetry.io/v1alpha1
   kind: OpenTelemetryCollector
   metadata:
     name: otel
     namespace: observability
   spec:
     mode: deployment
     serviceAccount: otel-collector-deployment
     config: |
       receivers:
         jaeger:
           protocols:
             grpc:
             thrift_binary:
             thrift_compact:
             thrift_http:
       processors:
         batch:
         k8sattributes:
         memory_limiter:
           check_interval: 1s
           limit_percentage: 50
           spike_limit_percentage: 30
         resourcedetection:
           detectors: [openshift]
       exporters:
         otlp:
           endpoint: "tempo-example-gateway:8090"
           tls:
             insecure: true
       service:
         pipelines:
           traces:
             receivers: [jaeger]
             processors: [memory_limiter, k8sattributes, resourcedetection, batch]
             exporters: [otlp]

7. 将追踪端点指向 OpenTelemetry Operator。

8. 如果您要将 trace 直接从应用程序导出到 Jaeger，请将 API 端点从 Jaeger 端点改为 OpenTelemetry Collector 端点。

   使用带有 Golang 的 jaegerexporter 导出 trace 的示例

   exp, err := jaeger.New(jaeger.WithCollectorEndpoint(jaeger.WithEndpoint(url))) 1

   1

   URL 指向 OpenTelemetry Collector API 端点。

流程

1. 进入 Operators → Installed Operators → Red Hat build of OpenTelemetry Operator → OpenTelemetryInstrumentation 或 OpenTelemetryCollector。
2. 要删除相关实例，请选择 → Delete …​ → Delete。
3. 可选：删除红帽构建的 OpenTelemetry Operator。

流程

1. 运行以下命令，获取 OpenTelemetry Collector 实例的名称：

   $ oc get deployments -n <project_of_opentelemetry_instance>

2. 运行以下命令来删除 OpenTelemetry Collector 实例：

   $ oc delete opentelemetrycollectors <opentelemetry_instance_name> -n <project_of_opentelemetry_instance>

3. 可选：删除红帽构建的 OpenTelemetry Operator。